methodfinder 2.1.0 → 2.2.3
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/CHANGELOG.md +80 -0
- data/{LICENSE → LICENSE.txt} +0 -1
- data/README.md +219 -0
- data/lib/methodfinder/version.rb +5 -0
- data/lib/methodfinder.rb +160 -97
- metadata +99 -10
- data/README.rdoc +0 -135
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
2
|
+
SHA256:
|
|
3
|
+
metadata.gz: 9870bf45c6bbb10d2fe3c2d5ad509a3dace99d3b0bca753127bfa20a2185f2db
|
|
4
|
+
data.tar.gz: 424c6c14b3ec09c8b20370cb40ec2beb8e9ff9405008606d2a1ffdbc1a88c007
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 475f9808360c53bc6b71861fa4ddb5c405a72ec685bb5517a5ff59704f61e034c56b802c4cc2f14fea18e55bdf811b44e03ed551c257864929294a5f0f4f6066
|
|
7
|
+
data.tar.gz: 6835cb818777f35e343d10f14ba905eb57f797ce251ad5b0120f336a05f2d466dc1658e9dedc4f6378919024b39f29010aa772af5ee18e668e8c6bbc708a7e97
|
data/CHANGELOG.md
ADDED
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## [Unreleased](https://github.com/citizen428/methodfinder/tree/HEAD)
|
|
4
|
+
|
|
5
|
+
[Full Changelog](https://github.com/citizen428/methodfinder/compare/v2.2.1...HEAD)
|
|
6
|
+
|
|
7
|
+
**Implemented enhancements:**
|
|
8
|
+
|
|
9
|
+
- Cast the METHOD\_FINDER\_DEBUG environment variable to a boolean [\#17](https://github.com/citizen428/methodfinder/pull/17) ([chocolateboy](https://github.com/chocolateboy))
|
|
10
|
+
- Switch to Bundler gem structure [\#16](https://github.com/citizen428/methodfinder/pull/16) ([citizen428](https://github.com/citizen428))
|
|
11
|
+
|
|
12
|
+
## [v2.2.1](https://github.com/citizen428/methodfinder/tree/v2.2.1) (2018-05-02)
|
|
13
|
+
[Full Changelog](https://github.com/citizen428/methodfinder/compare/v2.2.0...v2.2.1)
|
|
14
|
+
|
|
15
|
+
## [v2.2.0](https://github.com/citizen428/methodfinder/tree/v2.2.0) (2018-05-02)
|
|
16
|
+
[Full Changelog](https://github.com/citizen428/methodfinder/compare/v2.1.0...v2.2.0)
|
|
17
|
+
|
|
18
|
+
**Implemented enhancements:**
|
|
19
|
+
|
|
20
|
+
- README.md tweaks [\#14](https://github.com/citizen428/methodfinder/pull/14) ([chocolateboy](https://github.com/chocolateboy))
|
|
21
|
+
|
|
22
|
+
**Fixed bugs:**
|
|
23
|
+
|
|
24
|
+
- It's not possible to pass a hash as the last argument [\#10](https://github.com/citizen428/methodfinder/issues/10)
|
|
25
|
+
- Fix failing Travis builds [\#15](https://github.com/citizen428/methodfinder/pull/15) ([chocolateboy](https://github.com/chocolateboy))
|
|
26
|
+
- Propagate keywords \(i.e. :debug\) from find\_method to find [\#11](https://github.com/citizen428/methodfinder/pull/11) ([chocolateboy](https://github.com/chocolateboy))
|
|
27
|
+
|
|
28
|
+
## [v2.1.0](https://github.com/citizen428/methodfinder/tree/v2.1.0) (2017-02-05)
|
|
29
|
+
[Full Changelog](https://github.com/citizen428/methodfinder/compare/v2.0.0...v2.1.0)
|
|
30
|
+
|
|
31
|
+
**Implemented enhancements:**
|
|
32
|
+
|
|
33
|
+
- Allow tested method names to be dumped to STDERR via an environment variable [\#9](https://github.com/citizen428/methodfinder/pull/9) ([chocolateboy](https://github.com/chocolateboy))
|
|
34
|
+
- Compatibility updates, fixes and workarounds [\#8](https://github.com/citizen428/methodfinder/pull/8) ([chocolateboy](https://github.com/chocolateboy))
|
|
35
|
+
|
|
36
|
+
## [v2.0.0](https://github.com/citizen428/methodfinder/tree/v2.0.0) (2013-10-30)
|
|
37
|
+
[Full Changelog](https://github.com/citizen428/methodfinder/compare/v1.2.5...v2.0.0)
|
|
38
|
+
|
|
39
|
+
## [v1.2.5](https://github.com/citizen428/methodfinder/tree/v1.2.5) (2011-12-18)
|
|
40
|
+
[Full Changelog](https://github.com/citizen428/methodfinder/compare/v1.2.4...v1.2.5)
|
|
41
|
+
|
|
42
|
+
## [v1.2.4](https://github.com/citizen428/methodfinder/tree/v1.2.4) (2011-10-26)
|
|
43
|
+
[Full Changelog](https://github.com/citizen428/methodfinder/compare/v1.2.2...v1.2.4)
|
|
44
|
+
|
|
45
|
+
**Implemented enhancements:**
|
|
46
|
+
|
|
47
|
+
- Make methodfinder play nice with Pry [\#7](https://github.com/citizen428/methodfinder/pull/7) ([skanev](https://github.com/skanev))
|
|
48
|
+
- Instance syntax and fix tests [\#6](https://github.com/citizen428/methodfinder/pull/6) ([BMorearty](https://github.com/BMorearty))
|
|
49
|
+
|
|
50
|
+
## [v1.2.2](https://github.com/citizen428/methodfinder/tree/v1.2.2) (2011-04-23)
|
|
51
|
+
[Full Changelog](https://github.com/citizen428/methodfinder/compare/v1.2.1...v1.2.2)
|
|
52
|
+
|
|
53
|
+
## [v1.2.1](https://github.com/citizen428/methodfinder/tree/v1.2.1) (2011-04-16)
|
|
54
|
+
[Full Changelog](https://github.com/citizen428/methodfinder/compare/v1.2.0...v1.2.1)
|
|
55
|
+
|
|
56
|
+
**Implemented enhancements:**
|
|
57
|
+
|
|
58
|
+
- Add a method ignore list [\#4](https://github.com/citizen428/methodfinder/pull/4) ([janlelis](https://github.com/janlelis))
|
|
59
|
+
|
|
60
|
+
## [v1.2.0](https://github.com/citizen428/methodfinder/tree/v1.2.0) (2011-04-08)
|
|
61
|
+
[Full Changelog](https://github.com/citizen428/methodfinder/compare/v1.1.1...v1.2.0)
|
|
62
|
+
|
|
63
|
+
## [v1.1.1](https://github.com/citizen428/methodfinder/tree/v1.1.1) (2011-04-05)
|
|
64
|
+
[Full Changelog](https://github.com/citizen428/methodfinder/compare/v1.1.0...v1.1.1)
|
|
65
|
+
|
|
66
|
+
**Implemented enhancements:**
|
|
67
|
+
|
|
68
|
+
- Alternative block interface [\#3](https://github.com/citizen428/methodfinder/issues/3)
|
|
69
|
+
|
|
70
|
+
## [v1.1.0](https://github.com/citizen428/methodfinder/tree/v1.1.0) (2011-03-31)
|
|
71
|
+
[Full Changelog](https://github.com/citizen428/methodfinder/compare/v1.0.1...v1.1.0)
|
|
72
|
+
|
|
73
|
+
**Closed issues:**
|
|
74
|
+
|
|
75
|
+
- Small typo in the readme [\#2](https://github.com/citizen428/methodfinder/issues/2)
|
|
76
|
+
|
|
77
|
+
## [v1.0.1](https://github.com/citizen428/methodfinder/tree/v1.0.1) (2011-03-11)
|
|
78
|
+
[Full Changelog](https://github.com/citizen428/methodfinder/compare/v1.0.0...v1.0.1)
|
|
79
|
+
|
|
80
|
+
## [v1.0.0](https://github.com/citizen428/methodfinder/tree/v1.0.0) (2011-02-10)
|
data/{LICENSE → LICENSE.txt}
RENAMED
data/README.md
ADDED
|
@@ -0,0 +1,219 @@
|
|
|
1
|
+
# MethodFinder
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
[](https://rubygems.org/gems/methodfinder)
|
|
5
|
+
|
|
6
|
+
<!-- toc -->
|
|
7
|
+
|
|
8
|
+
- [NAME](#name)
|
|
9
|
+
- [INSTALLATION](#installation)
|
|
10
|
+
- [SYNOPSIS](#synopsis)
|
|
11
|
+
- [DESCRIPTION](#description)
|
|
12
|
+
- [Warning](#warning)
|
|
13
|
+
- [API](#api)
|
|
14
|
+
- [MethodFinder.find](#methodfinderfind)
|
|
15
|
+
- [Object#find_method](#objectfind_method)
|
|
16
|
+
- [Ignorelists](#ignorelists)
|
|
17
|
+
- [MethodFinder.find_classes_and_modules](#methodfinderfind_classes_and_modules)
|
|
18
|
+
- [MethodFinder.find_in_class_or_module](#methodfinderfind_in_class_or_module)
|
|
19
|
+
- [TROUBLESHOOTING](#troubleshooting)
|
|
20
|
+
- [DEVELOPMENT](#development)
|
|
21
|
+
- [CONTRIBUTING](#contributing)
|
|
22
|
+
- [SEE ALSO](#see-also)
|
|
23
|
+
- [Gems](#gems)
|
|
24
|
+
- [Misc](#misc)
|
|
25
|
+
- [VERSION](#version)
|
|
26
|
+
- [AUTHOR](#author)
|
|
27
|
+
- [LICENSE](#license)
|
|
28
|
+
|
|
29
|
+
<!-- tocstop -->
|
|
30
|
+
|
|
31
|
+
## NAME
|
|
32
|
+
|
|
33
|
+
MethodFinder - a Smalltalk-like Method Finder for Ruby
|
|
34
|
+
|
|
35
|
+
## INSTALLATION
|
|
36
|
+
|
|
37
|
+
$ gem install methodfinder
|
|
38
|
+
|
|
39
|
+
## SYNOPSIS
|
|
40
|
+
|
|
41
|
+
```ruby
|
|
42
|
+
Welcome to IRB. # or Pry
|
|
43
|
+
|
|
44
|
+
>> 'Hello, world!'.find_method('HELLO, WORLD!')
|
|
45
|
+
#=> ["String#upcase", "String#upcase!"]
|
|
46
|
+
|
|
47
|
+
>> %w[a b c].find_method('c')
|
|
48
|
+
#=> ["Array#last", "Array#max", "Array#pop"]
|
|
49
|
+
|
|
50
|
+
>> %w[a b c].find_method { |it| it.unknown(2); it == %w[c] }
|
|
51
|
+
#=> ["Array#shift"]
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## DESCRIPTION
|
|
55
|
+
|
|
56
|
+
A Smalltalk-like Method Finder for Ruby for use in your `~/.irbrc` or
|
|
57
|
+
`~/.pryrc`.
|
|
58
|
+
|
|
59
|
+
This project was originally inspired by Smalltalk's Method
|
|
60
|
+
Finder, but additional features have been added over time.
|
|
61
|
+
|
|
62
|
+
### Warning
|
|
63
|
+
|
|
64
|
+
Common sense not included!
|
|
65
|
+
|
|
66
|
+
While this gem should generally be safe to use, it's still better to be safe
|
|
67
|
+
than sorry, so use this with caution and maybe not on production data.
|
|
68
|
+
|
|
69
|
+
This was initially written for the students of the core Ruby course on
|
|
70
|
+
[RubyLearning](http://web.archive.org/web/20151218180403/http://rubylearning.org/classes/),
|
|
71
|
+
so it's generally not tested in a Rails console, just plain IRB/Pry.
|
|
72
|
+
|
|
73
|
+
## API
|
|
74
|
+
|
|
75
|
+
### MethodFinder.find
|
|
76
|
+
|
|
77
|
+
Provided with a receiver, the desired result and possibly some arguments,
|
|
78
|
+
`MethodFinder.find` will list all methods that produce the given result when
|
|
79
|
+
called on the receiver with the provided arguments.
|
|
80
|
+
|
|
81
|
+
```ruby
|
|
82
|
+
MethodFinder.find(10, 1, 3)
|
|
83
|
+
#=> ["Fixnum#%", "Fixnum#<=>", "Fixnum#>>", "Fixnum#[]", "Integer#gcd", "Fixnum#modulo", "Numeric#remainder"]
|
|
84
|
+
MethodFinder.find("abc", "ABC")
|
|
85
|
+
#=> ["String#swapcase", "String#swapcase!", "String#upcase", "String#upcase!"]
|
|
86
|
+
MethodFinder.find(10, 100, 2)
|
|
87
|
+
#=> ["Fixnum#**"]
|
|
88
|
+
MethodFinder.find(['a', 'b', 'c'], ['A', 'B', 'C']) { |x| x.upcase }
|
|
89
|
+
#=> ["Array#collect", "Array#collect!", "Enumerable#collect_concat", "Enumerable#flat_map", "Array#map", "Array#map!"]
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Object#find_method
|
|
93
|
+
|
|
94
|
+
This gem also adds `Object#find_method`, which besides offering an alternative
|
|
95
|
+
interface to pretty much the same functionality as `MethodFinder.find`, also
|
|
96
|
+
allows you to test for state other than the return value of the method.
|
|
97
|
+
|
|
98
|
+
```ruby
|
|
99
|
+
%w[a b c].find_method { |a| a.unknown(1) ; a == %w[a c] }
|
|
100
|
+
#=> ["Array#delete_at", "Array#slice!"]
|
|
101
|
+
10.find_method { |n| n.unknown(3) == 1 }
|
|
102
|
+
#=> ["Fixnum#%", "Fixnum#<=>", "Fixnum#>>", "Fixnum#[]", "Integer#gcd", "Fixnum#modulo", "Numeric#remainder"]
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
Inside `find_method`'s block, the receiver is available as block argument and
|
|
106
|
+
the special method `unknown` is used as a placeholder for the desired method.
|
|
107
|
+
|
|
108
|
+
You can also call `find_method` without passing a block. This is the same as
|
|
109
|
+
calling `MethodFinder.find`.
|
|
110
|
+
|
|
111
|
+
```ruby
|
|
112
|
+
10.find_method(1, 3)
|
|
113
|
+
#=> ["Fixnum#%", "Fixnum#<=>", "Fixnum#>>", "Fixnum#[]", "Integer#gcd", "Fixnum#modulo", "Numeric#remainder"]
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
#### Ignorelists
|
|
117
|
+
|
|
118
|
+
You can exclude methods from being tried by editing the hashes
|
|
119
|
+
`MethodFinder::INSTANCE_METHOD_IGNORELIST` and
|
|
120
|
+
`MethodFinder::CLASS_METHOD_IGNORELIST`. Both use the class/module as key and
|
|
121
|
+
an array of method names as values (note that class, module and method names
|
|
122
|
+
have to be symbols).
|
|
123
|
+
|
|
124
|
+
For example, to ignore the instance method `shutdown` of `Object`, you would do
|
|
125
|
+
|
|
126
|
+
```ruby
|
|
127
|
+
MethodFinder::INSTANCE_METHOD_IGNORELIST[:Object] << :shutdown
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
This might come in handy when using `MethodFinder` together with other gems as
|
|
131
|
+
such as `interactive_editor`.
|
|
132
|
+
|
|
133
|
+
### MethodFinder.find_classes_and_modules
|
|
134
|
+
|
|
135
|
+
A simple method to return all currently defined modules and classes.
|
|
136
|
+
|
|
137
|
+
```ruby
|
|
138
|
+
MethodFinder.find_classes_and_modules
|
|
139
|
+
#=> [ArgumentError, Array, BasicObject, Bignum ... ZeroDivisionError]
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
### MethodFinder.find_in_class_or_module
|
|
143
|
+
|
|
144
|
+
Searches for a given name within a class. The first parameter can either be a
|
|
145
|
+
class object, a symbol or a string whereas the optional second parameter can
|
|
146
|
+
be a string or a regular expression:
|
|
147
|
+
|
|
148
|
+
```ruby
|
|
149
|
+
MethodFinder.find_in_class_or_module('Array', 'shuff')
|
|
150
|
+
#=> [:shuffle, :shuffle!]
|
|
151
|
+
MethodFinder.find_in_class_or_module(Float, /^to/)
|
|
152
|
+
#=> [:to_f, :to_i, :to_int, :to_r, :to_s]
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
If the second parameter is omitted, all methods of the class or module will be
|
|
156
|
+
returned.
|
|
157
|
+
|
|
158
|
+
```ruby
|
|
159
|
+
MethodFinder.find_in_class_or_module(Math)
|
|
160
|
+
#=> [:acos, :acosh, :asin ... :tanh]
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
## TROUBLESHOOTING
|
|
164
|
+
|
|
165
|
+
If the `METHOD_FINDER_DEBUG` environment variable is set, the name of each
|
|
166
|
+
candidate method is printed to `STDERR` before it is invoked. This can be useful
|
|
167
|
+
to identify (and consequently ignore) misbehaving methods.
|
|
168
|
+
|
|
169
|
+
It can be set on the command line e.g.:
|
|
170
|
+
|
|
171
|
+
```
|
|
172
|
+
$ METHOD_FINDER_DEBUG=1 irb
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
Or you can toggle it inside IRB/Pry:
|
|
176
|
+
|
|
177
|
+
```ruby
|
|
178
|
+
>> MethodFinder.toggle_debug!
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
## DEVELOPMENT
|
|
182
|
+
|
|
183
|
+
After checking out the repo, run `bin/setup` to install dependencies. Then, run
|
|
184
|
+
`rake test` to run the tests. You can also run `bin/console` for an interactive
|
|
185
|
+
prompt that will allow you to experiment.
|
|
186
|
+
|
|
187
|
+
To install this gem onto your local machine, run `bundle exec rake install`. To
|
|
188
|
+
release a new version, update the version number in `version.rb`, and then run
|
|
189
|
+
`bundle exec rake release`, which will create a git tag for the version, push
|
|
190
|
+
git commits and tags, and push the `.gem` file to
|
|
191
|
+
[rubygems.org](https://rubygems.org).
|
|
192
|
+
|
|
193
|
+
## CONTRIBUTING
|
|
194
|
+
|
|
195
|
+
Bug reports and pull requests are welcome on GitHub at
|
|
196
|
+
https://github.com/citizen428/methodfinder.
|
|
197
|
+
|
|
198
|
+
## SEE ALSO
|
|
199
|
+
|
|
200
|
+
### Gems
|
|
201
|
+
|
|
202
|
+
- [irbtools](https://github.com/janlelis/irbtools) - improvements for Ruby's IRB console (includes methodfinder)
|
|
203
|
+
|
|
204
|
+
### Misc
|
|
205
|
+
|
|
206
|
+
- [Other Implementations](https://github.com/citizen428/methodfinder/wiki/Other-Implementations) - a list of related projects in Ruby and other languages
|
|
207
|
+
|
|
208
|
+
## VERSION
|
|
209
|
+
|
|
210
|
+
2.2.1
|
|
211
|
+
|
|
212
|
+
## AUTHOR
|
|
213
|
+
|
|
214
|
+
- [Michael Kohl](https://github.com/citizen428)
|
|
215
|
+
|
|
216
|
+
## LICENSE
|
|
217
|
+
|
|
218
|
+
The gem is available as open source under the terms of the [MIT
|
|
219
|
+
License](https://opensource.org/licenses/MIT).
|
data/lib/methodfinder.rb
CHANGED
|
@@ -1,3 +1,6 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
require 'methodfinder/version'
|
|
1
4
|
require 'stringio'
|
|
2
5
|
|
|
3
6
|
class Object
|
|
@@ -8,7 +11,7 @@ class Object
|
|
|
8
11
|
# %w[a b c].find_method { |a| a.unknown(1) ; a == %w[a c] }
|
|
9
12
|
# #=> ["Array#delete_at", "Array#slice!"]
|
|
10
13
|
# 10.find_method { |n| n.unknown(3) == 1 }
|
|
11
|
-
# #=> ["Fixnum#%", "Fixnum#<=>", "Fixnum#>>",
|
|
14
|
+
# #=> ["Fixnum#%", "Fixnum#<=>", "Fixnum#>>", ...]
|
|
12
15
|
#
|
|
13
16
|
# Inside <tt>find_method</tt>'s block, the receiver is available as
|
|
14
17
|
# block argument and the special method <tt>unknown</tt> is used as
|
|
@@ -17,125 +20,185 @@ class Object
|
|
|
17
20
|
# <tt>find_method</tt> can be called without passing a block. This
|
|
18
21
|
# is the same as calling <tt>MethodFinder.find</tt>.
|
|
19
22
|
#
|
|
20
|
-
# 10.find_method(1,3)
|
|
21
|
-
# #=> ["Fixnum#%", "Fixnum#<=>", "Fixnum#>>",
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
STDERR.puts met if debug
|
|
27
|
-
self.class.class_eval("alias :unknown #{met}")
|
|
28
|
-
obj = self.dup rescue self # dup doesn't work for immutable types
|
|
29
|
-
block.call(obj) rescue nil
|
|
30
|
-
end
|
|
31
|
-
mets.map { |m| "#{self.method(m).owner}##{m}" }
|
|
32
|
-
else
|
|
33
|
-
MethodFinder.find(self, *args)
|
|
34
|
-
end
|
|
23
|
+
# 10.find_method(1, 3)
|
|
24
|
+
# #=> ["Fixnum#%", "Fixnum#<=>", "Fixnum#>>", ...]
|
|
25
|
+
def find_method(*args, &block)
|
|
26
|
+
return MethodFinder.find(self, *args) unless block_given?
|
|
27
|
+
|
|
28
|
+
MethodFinder.find_unknown(self, &block)
|
|
35
29
|
end
|
|
36
30
|
end
|
|
37
31
|
|
|
38
32
|
module MethodFinder
|
|
39
33
|
# Default arguments for methods
|
|
34
|
+
# :nodoc:
|
|
40
35
|
ARGS = {
|
|
41
36
|
cycle: [1] # prevent cycling forever
|
|
42
|
-
}
|
|
37
|
+
}.freeze
|
|
43
38
|
|
|
44
|
-
#
|
|
45
|
-
|
|
46
|
-
|
|
39
|
+
# Ignoring methods, e.g. { :Object => [:ri, :vim] }
|
|
40
|
+
INSTANCE_METHOD_IGNORELIST = Hash.new { |h, k| h[k] = [] }
|
|
41
|
+
# Ignoring class methods
|
|
42
|
+
CLASS_METHOD_IGNORELIST = Hash.new { |h, k| h[k] = [] }
|
|
43
|
+
# IGNORING classes
|
|
44
|
+
CLASS_IGNORELIST = []
|
|
47
45
|
|
|
48
|
-
|
|
49
|
-
|
|
46
|
+
if RUBY_VERSION.start_with?('3')
|
|
47
|
+
CLASS_IGNORELIST << :SortedSet # this moved to a gem
|
|
48
|
+
end
|
|
49
|
+
|
|
50
|
+
INSTANCE_METHOD_IGNORELIST[:Object] << :find_method # prevent stack overflow
|
|
51
|
+
INSTANCE_METHOD_IGNORELIST[:Object] << :gem # funny testing stuff w/ Bundler
|
|
50
52
|
|
|
51
53
|
if defined?(Pry)
|
|
52
|
-
|
|
53
|
-
|
|
54
|
+
INSTANCE_METHOD_IGNORELIST[:Object] << :pry
|
|
55
|
+
CLASS_METHOD_IGNORELIST[:Object] << :pry
|
|
54
56
|
end
|
|
55
57
|
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
58
|
+
# true if METHOD_FINDER_DEBUG is truthy, false otherwise e.g.:
|
|
59
|
+
#
|
|
60
|
+
# $ METHOD_FINDER_DEBUG=1 irb # true
|
|
61
|
+
# $ METHOD_FINDER_DEBUG=0 irb # false
|
|
62
|
+
# $ METHOD_FINDER_DEBUG=false irb # false
|
|
63
|
+
# $ METHOD_FINDER_DEBUG= irb # false
|
|
64
|
+
@debug = !ENV.fetch('METHOD_FINDER_DEBUG', '').match(/\A(0|false)?\z/i)
|
|
65
|
+
|
|
66
|
+
# Checks whether or not debugging is currently enabled
|
|
67
|
+
# :doc:
|
|
68
|
+
def self.debug?
|
|
69
|
+
@debug
|
|
70
|
+
end
|
|
71
|
+
|
|
72
|
+
# Toggles the debug mode
|
|
73
|
+
def self.toggle_debug!
|
|
74
|
+
@debug = !@debug
|
|
75
|
+
end
|
|
76
|
+
|
|
77
|
+
# Provided with a receiver, the desired result and possibly some
|
|
78
|
+
# arguments, <tt>MethodFinder.find</tt> will list all methods that
|
|
79
|
+
# produce the given result when called on the receiver with the
|
|
80
|
+
# provided arguments.
|
|
81
|
+
#
|
|
82
|
+
# MethodFinder.find(10, 1, 3)
|
|
83
|
+
# #=> ["Fixnum#%", "Fixnum#<=>", "Fixnum#>>", "Fixnum#[]", ...]
|
|
84
|
+
# MethodFinder.find("abc","ABC")
|
|
85
|
+
# #=> ["String#swapcase", "String#swapcase!", "String#upcase", ...]
|
|
86
|
+
# MethodFinder.find(10, 100, 2)
|
|
87
|
+
# #=> ["Fixnum#**"]
|
|
88
|
+
# MethodFinder.find(['a','b','c'], ['A','B','C']) { |x| x.upcase }
|
|
89
|
+
# #=> ["Array#collect", "Array#collect!", "Enumerable#collect_concat", ...]
|
|
90
|
+
def self.find(obj, res, *args, &block)
|
|
91
|
+
find_methods(obj) do |met|
|
|
92
|
+
o = begin
|
|
93
|
+
obj.dup
|
|
94
|
+
rescue StandardError
|
|
95
|
+
obj
|
|
96
|
+
end
|
|
97
|
+
m = o.method(met)
|
|
98
|
+
next unless m.arity <= args.size
|
|
99
|
+
|
|
100
|
+
warn(met) if debug?
|
|
101
|
+
a = args.empty? && ARGS.key?(met) ? ARGS[met] : args
|
|
102
|
+
begin
|
|
103
|
+
m.call(*a, &block) == res
|
|
104
|
+
rescue StandardError
|
|
105
|
+
nil
|
|
81
106
|
end
|
|
82
|
-
mets.map { |m| "#{obj.method(m).owner}##{m}" }
|
|
83
|
-
ensure
|
|
84
|
-
restore_streams
|
|
85
107
|
end
|
|
108
|
+
end
|
|
86
109
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
110
|
+
# Returns all currently defined modules and classes.
|
|
111
|
+
def self.find_classes_and_modules
|
|
112
|
+
with_redirected_streams do
|
|
113
|
+
candidates = Object.constants - CLASS_IGNORELIST
|
|
114
|
+
constants = candidates.sort.map { |c| Object.const_get(c) }
|
|
115
|
+
constants.select do |c|
|
|
116
|
+
c.instance_of?(Class) || c.instance_of?(Module)
|
|
117
|
+
end
|
|
91
118
|
end
|
|
119
|
+
end
|
|
92
120
|
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
121
|
+
# Searches for a given name within a class. The first parameter
|
|
122
|
+
# can either be a class object, a symbol or a string whereas the
|
|
123
|
+
# optional second parameter can be a string or a regular
|
|
124
|
+
# expression:
|
|
125
|
+
#
|
|
126
|
+
# MethodFinder.find_in_class_or_module('Array', 'shuff')
|
|
127
|
+
# #=> [:shuffle, :shuffle!]
|
|
128
|
+
# MethodFinder.find_in_class_or_module(Float, /^to/)
|
|
129
|
+
# #=> [:to_f, :to_i, :to_int, :to_r, :to_s]
|
|
130
|
+
#
|
|
131
|
+
# If the second parameter is omitted, all methods of the class or
|
|
132
|
+
# module will be returned.
|
|
133
|
+
#
|
|
134
|
+
# MethodFinder.find_in_class_or_module(Math)
|
|
135
|
+
# #=> [:acos, :acosh, :asin ... :tanh]
|
|
136
|
+
# :doc:
|
|
137
|
+
def self.find_in_class_or_module(klass, pattern = /./)
|
|
138
|
+
klasses = Object.const_get(klass.to_s)
|
|
139
|
+
class_methods = begin
|
|
140
|
+
klasses.methods(false)
|
|
141
|
+
rescue StandardError
|
|
142
|
+
[]
|
|
115
143
|
end
|
|
144
|
+
instance_methods = klasses.instance_methods(false)
|
|
145
|
+
all_methods = class_methods + instance_methods
|
|
146
|
+
all_methods.grep(/#{pattern}/).sort
|
|
147
|
+
end
|
|
116
148
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
klass.ancestors.each { |ancestor| ret -= blacklist[ancestor.to_s.intern] }
|
|
149
|
+
# Returns a list of candidate methods for a given object. Added by Jan Lelis.
|
|
150
|
+
def self.methods_to_try(obj)
|
|
151
|
+
ret = obj.methods
|
|
152
|
+
ignorelist = select_ignorelist(obj)
|
|
153
|
+
klass = obj.is_a?(Module) ? obj : obj.class
|
|
124
154
|
|
|
125
|
-
|
|
155
|
+
klass.ancestors.each { |ancestor| ret -= ignorelist[ancestor.to_s.intern] }
|
|
156
|
+
ret.sort
|
|
157
|
+
end
|
|
158
|
+
private_class_method :methods_to_try
|
|
159
|
+
|
|
160
|
+
# Used by Object.find_method
|
|
161
|
+
# :nodoc:
|
|
162
|
+
def self.find_unknown(obj, &block)
|
|
163
|
+
find_methods(obj) do |met|
|
|
164
|
+
warn(met) if debug?
|
|
165
|
+
obj.class.class_eval("alias :unknown #{met}", __FILE__, __LINE__)
|
|
166
|
+
subject = begin
|
|
167
|
+
obj.dup
|
|
168
|
+
rescue StandardError # dup doesn't work for immutable types
|
|
169
|
+
obj
|
|
170
|
+
end
|
|
171
|
+
begin
|
|
172
|
+
block.call(subject)
|
|
173
|
+
rescue StandardError
|
|
174
|
+
nil
|
|
175
|
+
end
|
|
126
176
|
end
|
|
177
|
+
end
|
|
127
178
|
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
$stdout = StringIO.new
|
|
133
|
-
$stderr = StringIO.new
|
|
179
|
+
def self.find_methods(obj, &block)
|
|
180
|
+
with_redirected_streams do
|
|
181
|
+
found = methods_to_try(obj).select(&block)
|
|
182
|
+
found.map { |m| "#{obj.method(m).owner}##{m}" }
|
|
134
183
|
end
|
|
184
|
+
end
|
|
185
|
+
private_class_method :find_methods
|
|
186
|
+
|
|
187
|
+
def self.with_redirected_streams
|
|
188
|
+
orig_stdout = $stdout
|
|
189
|
+
orig_stderr = $stderr
|
|
190
|
+
$stdout = StringIO.new
|
|
191
|
+
$stderr = StringIO.new
|
|
192
|
+
|
|
193
|
+
yield
|
|
194
|
+
ensure
|
|
195
|
+
$stdout = orig_stdout
|
|
196
|
+
$stderr = orig_stderr
|
|
197
|
+
end
|
|
198
|
+
private_class_method :with_redirected_streams
|
|
135
199
|
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
private_class_method :redirect_streams, :restore_streams
|
|
200
|
+
def self.select_ignorelist(object)
|
|
201
|
+
object.is_a?(Module) ? CLASS_METHOD_IGNORELIST : INSTANCE_METHOD_IGNORELIST
|
|
202
|
+
end
|
|
203
|
+
private_class_method :select_ignorelist
|
|
141
204
|
end
|
metadata
CHANGED
|
@@ -1,28 +1,118 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: methodfinder
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 2.
|
|
4
|
+
version: 2.2.3
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Michael Kohl
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date:
|
|
12
|
-
dependencies:
|
|
11
|
+
date: 2021-11-08 00:00:00.000000000 Z
|
|
12
|
+
dependencies:
|
|
13
|
+
- !ruby/object:Gem::Dependency
|
|
14
|
+
name: bundler
|
|
15
|
+
requirement: !ruby/object:Gem::Requirement
|
|
16
|
+
requirements:
|
|
17
|
+
- - "~>"
|
|
18
|
+
- !ruby/object:Gem::Version
|
|
19
|
+
version: '2.2'
|
|
20
|
+
type: :development
|
|
21
|
+
prerelease: false
|
|
22
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
23
|
+
requirements:
|
|
24
|
+
- - "~>"
|
|
25
|
+
- !ruby/object:Gem::Version
|
|
26
|
+
version: '2.2'
|
|
27
|
+
- !ruby/object:Gem::Dependency
|
|
28
|
+
name: github_changelog_generator
|
|
29
|
+
requirement: !ruby/object:Gem::Requirement
|
|
30
|
+
requirements:
|
|
31
|
+
- - "~>"
|
|
32
|
+
- !ruby/object:Gem::Version
|
|
33
|
+
version: '1.16'
|
|
34
|
+
type: :development
|
|
35
|
+
prerelease: false
|
|
36
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
37
|
+
requirements:
|
|
38
|
+
- - "~>"
|
|
39
|
+
- !ruby/object:Gem::Version
|
|
40
|
+
version: '1.16'
|
|
41
|
+
- !ruby/object:Gem::Dependency
|
|
42
|
+
name: minitest
|
|
43
|
+
requirement: !ruby/object:Gem::Requirement
|
|
44
|
+
requirements:
|
|
45
|
+
- - "~>"
|
|
46
|
+
- !ruby/object:Gem::Version
|
|
47
|
+
version: '5.0'
|
|
48
|
+
type: :development
|
|
49
|
+
prerelease: false
|
|
50
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
51
|
+
requirements:
|
|
52
|
+
- - "~>"
|
|
53
|
+
- !ruby/object:Gem::Version
|
|
54
|
+
version: '5.0'
|
|
55
|
+
- !ruby/object:Gem::Dependency
|
|
56
|
+
name: rake
|
|
57
|
+
requirement: !ruby/object:Gem::Requirement
|
|
58
|
+
requirements:
|
|
59
|
+
- - "~>"
|
|
60
|
+
- !ruby/object:Gem::Version
|
|
61
|
+
version: '13.0'
|
|
62
|
+
type: :development
|
|
63
|
+
prerelease: false
|
|
64
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
65
|
+
requirements:
|
|
66
|
+
- - "~>"
|
|
67
|
+
- !ruby/object:Gem::Version
|
|
68
|
+
version: '13.0'
|
|
69
|
+
- !ruby/object:Gem::Dependency
|
|
70
|
+
name: rdoc
|
|
71
|
+
requirement: !ruby/object:Gem::Requirement
|
|
72
|
+
requirements:
|
|
73
|
+
- - "~>"
|
|
74
|
+
- !ruby/object:Gem::Version
|
|
75
|
+
version: '6.3'
|
|
76
|
+
type: :development
|
|
77
|
+
prerelease: false
|
|
78
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
79
|
+
requirements:
|
|
80
|
+
- - "~>"
|
|
81
|
+
- !ruby/object:Gem::Version
|
|
82
|
+
version: '6.3'
|
|
83
|
+
- !ruby/object:Gem::Dependency
|
|
84
|
+
name: rubocop
|
|
85
|
+
requirement: !ruby/object:Gem::Requirement
|
|
86
|
+
requirements:
|
|
87
|
+
- - "~>"
|
|
88
|
+
- !ruby/object:Gem::Version
|
|
89
|
+
version: '1.22'
|
|
90
|
+
type: :development
|
|
91
|
+
prerelease: false
|
|
92
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
93
|
+
requirements:
|
|
94
|
+
- - "~>"
|
|
95
|
+
- !ruby/object:Gem::Version
|
|
96
|
+
version: '1.22'
|
|
13
97
|
description: A Smalltalk-like Method Finder for Ruby with some extra features
|
|
14
|
-
email:
|
|
98
|
+
email:
|
|
99
|
+
- citizen428@gmail.com
|
|
15
100
|
executables: []
|
|
16
101
|
extensions: []
|
|
17
102
|
extra_rdoc_files: []
|
|
18
103
|
files:
|
|
19
|
-
-
|
|
20
|
-
-
|
|
104
|
+
- CHANGELOG.md
|
|
105
|
+
- LICENSE.txt
|
|
106
|
+
- README.md
|
|
21
107
|
- lib/methodfinder.rb
|
|
108
|
+
- lib/methodfinder/version.rb
|
|
22
109
|
homepage: http://citizen428.github.com/methodfinder/
|
|
23
110
|
licenses:
|
|
24
111
|
- MIT
|
|
25
|
-
metadata:
|
|
112
|
+
metadata:
|
|
113
|
+
bug_tracker_uri: https://github.com/citizen428/methodfinder/issues
|
|
114
|
+
source_code_uri: https://github.com/citizen428/methodfinder
|
|
115
|
+
changelog_uri: https://github.com/citizen428/methodfinder/blob/master/CHANGELOG.md
|
|
26
116
|
post_install_message:
|
|
27
117
|
rdoc_options: []
|
|
28
118
|
require_paths:
|
|
@@ -31,15 +121,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
|
31
121
|
requirements:
|
|
32
122
|
- - ">="
|
|
33
123
|
- !ruby/object:Gem::Version
|
|
34
|
-
version: '
|
|
124
|
+
version: '2.6'
|
|
35
125
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
|
36
126
|
requirements:
|
|
37
127
|
- - ">="
|
|
38
128
|
- !ruby/object:Gem::Version
|
|
39
129
|
version: '0'
|
|
40
130
|
requirements: []
|
|
41
|
-
|
|
42
|
-
rubygems_version: 2.5.2
|
|
131
|
+
rubygems_version: 3.2.22
|
|
43
132
|
signing_key:
|
|
44
133
|
specification_version: 4
|
|
45
134
|
summary: A Smalltalk-like Method Finder for Ruby
|
data/README.rdoc
DELETED
|
@@ -1,135 +0,0 @@
|
|
|
1
|
-
= MethodFinder
|
|
2
|
-
|
|
3
|
-
This project was originally inspired by Smalltalk's Method Finder, but additonal features were added over time.
|
|
4
|
-
|
|
5
|
-
== Requirements
|
|
6
|
-
|
|
7
|
-
Ruby 1.9.3+ (also works with Rubinius in 1.9 mode). Versions of <tt>MethodFinder</tt> up to 1.2.5 will also work with Ruby 1.8.7.
|
|
8
|
-
|
|
9
|
-
== Usage
|
|
10
|
-
|
|
11
|
-
=== MethodFinder.find
|
|
12
|
-
|
|
13
|
-
Provided with a receiver, the desired result and possibly some arguments, <tt>MethodFinder.find</tt> will list all methods that produce the given result when called on the receiver with the provided arguments.
|
|
14
|
-
|
|
15
|
-
MethodFinder.find(10, 1, 3)
|
|
16
|
-
#=> ["Fixnum#%", "Fixnum#<=>", "Fixnum#>>", "Fixnum#[]", "Integer#gcd", "Fixnum#modulo", "Numeric#remainder"]
|
|
17
|
-
MethodFinder.find("abc","ABC")
|
|
18
|
-
#=> ["String#swapcase", "String#swapcase!", "String#upcase", "String#upcase!"]
|
|
19
|
-
MethodFinder.find(10, 100, 2)
|
|
20
|
-
#=> ["Fixnum#**"]
|
|
21
|
-
MethodFinder.find(['a','b','c'], ['A','B','C']) { |x| x.upcase }
|
|
22
|
-
#=> ["Array#collect", "Array#collect!", "Enumerable#collect_concat", "Enumerable#flat_map", "Array#map", "Array#map!"]
|
|
23
|
-
|
|
24
|
-
=== Object#find_method
|
|
25
|
-
|
|
26
|
-
This gem also adds <tt>Object#find_method</tt>, which besides offering an alternative interface to pretty much the same functionality as <tt>MethodFinder.find</tt>, also allows you to test for state other than the return value of the method.
|
|
27
|
-
|
|
28
|
-
%w[a b c].find_method { |a| a.unknown(1) ; a == %w[a c] }
|
|
29
|
-
#=> ["Array#delete_at", "Array#slice!"]
|
|
30
|
-
10.find_method { |n| n.unknown(3) == 1 }
|
|
31
|
-
#=> ["Fixnum#%", "Fixnum#<=>", "Fixnum#>>", "Fixnum#[]", "Integer#gcd", "Fixnum#modulo", "Numeric#remainder"]
|
|
32
|
-
|
|
33
|
-
Inside <tt>find_method</tt>'s block, the receiver is available as block argument and the special method <tt>unknown</tt> is used as a placeholder for the desired method.
|
|
34
|
-
|
|
35
|
-
You can also call <tt>find_method</tt> without passing a block. This is the same as calling <tt>MethodFinder.find</tt>.
|
|
36
|
-
|
|
37
|
-
10.find_method(1,3)
|
|
38
|
-
#=> ["Fixnum#%", "Fixnum#<=>", "Fixnum#>>", "Fixnum#[]", "Integer#gcd", "Fixnum#modulo", "Numeric#remainder"]
|
|
39
|
-
|
|
40
|
-
==== Blacklists
|
|
41
|
-
|
|
42
|
-
You can exclude methods from being tried by editing the hashes <tt>MethodFinder::INSTANCE_METHOD_BLACKLIST</tt> and <tt>MethodFinder::CLASS_METHOD_BLACKLIST</tt>. Both use the class/module as key and an array of method names as values (note that class, module and method names have to be symbols).
|
|
43
|
-
|
|
44
|
-
For example, to blacklist the instance method <tt>shutdown</tt> of <tt>Object</tt>, you would do
|
|
45
|
-
|
|
46
|
-
MethodFinder::INSTANCE_METHOD_BLACKLIST[:Object] << :shutdown
|
|
47
|
-
|
|
48
|
-
This might come in handy when using <tt>MethodFinder</tt> together with other gems as such as <tt>interactive_editor</tt>.
|
|
49
|
-
|
|
50
|
-
=== MethodFinder.find_classes_and_modules
|
|
51
|
-
|
|
52
|
-
A simple method to return all currently defined modules and classes.
|
|
53
|
-
|
|
54
|
-
MethodFinder.find_classes_and_modules
|
|
55
|
-
#=> [ArgumentError, Array, BasicObject, Bignum ... ZeroDivisionError]
|
|
56
|
-
|
|
57
|
-
=== MethodFinder.find_in_class_or_module
|
|
58
|
-
|
|
59
|
-
Searches for a given name within a class. The first parameter can either be a class object, a symbol or a string whereas the optional second parameter can be a string or a regular expression:
|
|
60
|
-
|
|
61
|
-
MethodFinder.find_in_class_or_module('Array', 'shuff')
|
|
62
|
-
#=> [:shuffle, :shuffle!]
|
|
63
|
-
MethodFinder.find_in_class_or_module(Float, /^to/)
|
|
64
|
-
#=> [:to_f, :to_i, :to_int, :to_r, :to_s]
|
|
65
|
-
|
|
66
|
-
If the second parameter is omitted, all methods of the class or module will be returned.
|
|
67
|
-
|
|
68
|
-
MethodFinder.find_in_class_or_module(Math)
|
|
69
|
-
#=> [:acos, :acosh, :asin ... :tanh]
|
|
70
|
-
|
|
71
|
-
== Troubleshooting
|
|
72
|
-
|
|
73
|
-
If the +METHOD_FINDER_DEBUG+ environment variable is set, the name of each candidate method is printed to stderr before it is invoked. This can be useful to identify (and blacklist) misbehaving methods.
|
|
74
|
-
|
|
75
|
-
It can be set on the command line e.g.:
|
|
76
|
-
|
|
77
|
-
$ METHOD_FINDER_DEBUG=1 irb
|
|
78
|
-
|
|
79
|
-
Or inside IRB/Pry:
|
|
80
|
-
|
|
81
|
-
>> ENV['METHOD_FINDER_DEBUG'] = '1'
|
|
82
|
-
|
|
83
|
-
Alternatively both <tt>Object#find_method</tt> and <tt>MethodFinder.find</tt> support an optional keyword argument +debug+ to toggle the behavior on a per-call basis (this argument defaults to the value of the environment variable described above):
|
|
84
|
-
|
|
85
|
-
>> 'a'.find_method(debug: true) { |n| n.unknown == 'A' }
|
|
86
|
-
!
|
|
87
|
-
!=
|
|
88
|
-
[output shortened]
|
|
89
|
-
yellowish
|
|
90
|
-
#=> ["String#capitalize", "String#capitalize!", "String#swapcase", "String#swapcase!", "String#upcase", "String#upcase!"]
|
|
91
|
-
>> MethodFinder.find('a', 'A', debug: true)
|
|
92
|
-
!
|
|
93
|
-
!=
|
|
94
|
-
[output shortened]
|
|
95
|
-
yellowish
|
|
96
|
-
#=> ["String#capitalize", "String#capitalize!", "String#swapcase", "String#swapcase!", "String#upcase", "String#upcase!"]
|
|
97
|
-
|
|
98
|
-
== Warning
|
|
99
|
-
|
|
100
|
-
Common sense not included!
|
|
101
|
-
|
|
102
|
-
While I never had any problems with this, it's still better to be safe than sorry, so use this with caution and maybe not on production data.
|
|
103
|
-
|
|
104
|
-
I initially wrote this for the students of the core Ruby course on {RubyLearning}[http://rubylearning.org], so Rails is not of interestto me (not saying it doesn't work there, just that I test in plain IRB/Pry and not with the Rails console.
|
|
105
|
-
|
|
106
|
-
== Thanks
|
|
107
|
-
|
|
108
|
-
* Matthew Lucas for {first packaging this as a gem}[https://github.com/citizen428/methodfinder/pull/1].
|
|
109
|
-
* Ryan Bates for {suggesting}[https://github.com/citizen428/methodfinder/issues/closed#issue/3] what eventually became <tt>Object#find_method</tt>.
|
|
110
|
-
* Jan Lelis for {implementing blacklists}[https://github.com/citizen428/methodfinder/issues/closed#issue/4].
|
|
111
|
-
* Brian Morearty for pointing out an {incompatibility with Ruby 1.8.7}[https://github.com/citizen428/methodfinder/pull/5] and adding the {blockless version}[https://github.com/citizen428/methodfinder/pull/6] of <tt>Object#find_method</tt>.
|
|
112
|
-
* Stefan Kanev for {adding Pry support}[https://github.com/citizen428/methodfinder/pull/7].
|
|
113
|
-
* chocolateboy for {compatibility fixes and updates}[https://github.com/citizen428/methodfinder/pull/8] as well as {the intitial debug implementation}[https://github.com/citizen428/methodfinder/pull/9].
|
|
114
|
-
|
|
115
|
-
== License
|
|
116
|
-
|
|
117
|
-
Copyright (c) 2011-2017 Michael Kohl
|
|
118
|
-
|
|
119
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
120
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
121
|
-
in the Software without restriction, including without limitation the rights
|
|
122
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
123
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
124
|
-
furnished to do so, subject to the following conditions:
|
|
125
|
-
|
|
126
|
-
The above copyright notice and this permission notice shall be included in
|
|
127
|
-
all copies or substantial portions of the Software.
|
|
128
|
-
|
|
129
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
130
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
131
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
132
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
133
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
134
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
135
|
-
THE SOFTWARE.
|