Add bin and edit workflow

bin/gems/method_source-1.1.0/README.markdown

@@ -0,0 +1,101 @@
+method_source
+=============
+
+[![Circle Build Status](https://circleci.com/gh/banister/method_source.svg?style=shield)](https://circleci.com/gh/banister/method_source)
+
+(C) John Mair (banisterfiend) 2011
+
+_retrieve the sourcecode for a method_
+
+*NOTE:* This simply utilizes `Method#source_location`; it
+ does not access the live AST.
+
+`method_source` is a utility to return a method's sourcecode as a
+Ruby string. Also returns `Proc` and `Lambda` sourcecode.
+
+Method comments can also be extracted using the `comment` method.
+
+It is written in pure Ruby (no C).
+
+* Some Ruby 1.8 support now available.
+* Support for MRI, RBX, JRuby, REE
+
+`method_source` provides the `source` and `comment` methods to the `Method` and
+`UnboundMethod` and `Proc` classes.
+
+* Install the [gem](https://rubygems.org/gems/method_source): `gem install method_source`
+* Read the [documentation](https://www.rubydoc.info/github/banister/method_source/master)
+* See the [source code](http://github.com/banister/method_source)
+
+Example: display method source
+------------------------------
+
+    Set.instance_method(:merge).source.display
+    # =>
+    def merge(enum)
+      if enum.instance_of?(self.class)
+        @hash.update(enum.instance_variable_get(:@hash))
+      else
+        do_with_enum(enum) { |o| add(o) }
+      end
+
+      self
+    end
+
+Example: display method comments
+--------------------------------
+
+    Set.instance_method(:merge).comment.display
+    # =>
+    # Merges the elements of the given enumerable object to the set and
+    # returns self.
+
+Example: display module/class comments
+--------------------------------------
+
+    MethodSource::MethodExtensions.method(:included).module_comment
+    # =>
+    # This module is to be included by `Method` and `UnboundMethod` and
+    # provides the `#source` functionality
+
+Limitations:
+------------
+
+* Occasional strange behaviour in Ruby 1.8
+* Cannot return source for C methods.
+* Cannot return source for dynamically defined methods.
+
+Special Thanks
+--------------
+
+[Adam Sanderson](https://github.com/adamsanderson) for `comment` functionality.
+
+[Dmitry Elastic](https://github.com/dmitryelastic) for the brilliant Ruby 1.8 `source_location` hack.
+
+[Samuel Kadolph](https://github.com/samuelkadolph) for the JRuby 1.8 `source_location`.
+
+License
+-------
+
+(The MIT License)
+
+Copyright (c) 2011 John Mair (banisterfiend)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.