Interesting Methods
This gem lets you add .im to any object in Ruby to see the interesting methods.
.im stands for 'Interesting Methods'.
Without this gem, to find out an object's methods, you might try this:
MyClass.methods
my_instance.methodsThe problem? Because each of these statements show you all of the object's methods, including the inherited methods, it can be hard to find what you're after.
To see only the interesting methods on an object, try one of these statements instead:
MyClass.methods - Object.methods
my_instance.methods - Object.methods
MyClass.singleton_methods(false)
my_instance.instance_methods(false)
MyModule.singleton_methods
MyModule.instance_methodsThe interesting_methods gem wraps the above techniques into a simple .im method that you can call on any object (class, instance, module) and display the methods you want:
MyClass.im # [:my_class_method_a, :my_class_method_b]
my_instance.im # [:my_instance_method_a, :my_instance_method_b]
MyModule.im # [:my_module_method_a, :my_module_method_b]
Installation
First install the gem:
gem install interesting_methodsThen create irb and pry rc files if they don't already exist:
touch ~/.irbrc
touch ~/.pryrcEdit each of those rc files and add the following code:
if Gem::Specification.find_all_by_name('interesting_methods').any?
require 'interesting_methods'
endYou're all set up now!
Usage
Load up either irb or pry from your command line.
Add .im to any object to see its interesting methods.
Examples
- http://smallcity.ca/2018/03/23/interesting-methods-gem (blog post with examples)
- http://smallcity.ca/2018/03/23/method-driven-development ('Method Driven Development' screencast using gem)
Caveat
This gem is not meant to be used in production as it monkey patches Ruby's core Object class.
Development
After checking out this repo, run bin/setup to install dependencies. Then, run rake test to run the tests.
You can run guard for a continuous test runner.
You can run bin/console for an interactive prompt that will allow you to experiment.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/seanlerner/interesting_methods.
License
The gem is available as open source under the terms of the MIT License.
Credit
Having interesting_methods available in your repl is something Ruby programmers have been doing for a while. I think I first came across it years ago in a stackoverflow post. Google interesting_methodsand you'll find blog posts and dotfiles with similar functionality already implemented. AFAIK this is the first time its been packaged up in a gem.
Sean Lerner
http://smallcity.ca