reusing 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a0a624b8d21979282d101db2474ea7ad3d1cce00
+  data.tar.gz: cb0419a8e426ba527840d769edf72683f57ac7c7
+SHA512:
+  metadata.gz: 7e3e03c9452c15c5295f7ed7ec5616ab05a5be5971527a10de376ab2c9b7189503f51ca28d5dd2eb14e0c0db19b76b618bfab70ccc7df6a33d9206b6ea1bfb44
+  data.tar.gz: c27da6f4e1853666c162681a26d997ba077110c2da0cf57d64c72e9a166f5603a88545fa6301571a2bc00b6feadc81a92d440dfdca3598dff2a4bc72bca5f4d6

data/.index

@@ -0,0 +1,62 @@
+---
+revision: 2013
+type: ruby
+sources:
+- Indexfile
+- Gemfile
+authors:
+- name: Thomas Sawyer
+  email: transfire@gmail.com
+organizations:
+- name: Rubyworks
+requirements:
+- version: '>= 0'
+  name: finder
+- groups:
+  - test
+  version: '>= 0'
+  name: rubytest
+- groups:
+  - test
+  version: '>= 0'
+  name: rubytest-cli
+- groups:
+  - test
+  version: '>= 0'
+  name: microtest
+- groups:
+  - build
+  version: '>= 0'
+  name: indexer
+conflicts: []
+alternatives: []
+resources:
+- type: home
+  uri: http://rubyworks.github.com/reusing
+  label: Homepage
+- type: code
+  uri: http://github.com/rubyworks/reusing
+  label: Source Code
+repositories:
+- name: upstream
+  scm: git
+  uri: git@github.com:rubyworks/reusing.git
+categories: []
+copyrights:
+- holder: Rubyworks
+  year: '2014'
+  license: BSD-2-Clause
+customs: []
+paths:
+  load:
+  - lib
+name: reusing
+title: Reusing
+version: 1.0.0
+summary: Use `using` with extension files.
+description: Reusing makes it possible to use refinements without all the boiler plate
+  normally necessary in their creation. Instead extension scripts can be loaded directly
+  as refinements.
+scm_uri: https://github.com/rubyworks/reusing/tree/master
+created: '2014-04-16'
+date: '2014-04-22'

data/Gemfile.lock

@@ -0,0 +1,21 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ansi (1.4.3)
+    finder (0.4.0)
+    microtest (0.2.1)
+      rubytest
+    rubytest (0.7.0)
+      ansi
+    rubytest-cli (0.1.0)
+      ansi
+      rubytest (>= 0.7.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  finder
+  microtest
+  rubytest
+  rubytest-cli

data/LICENSE.txt

@@ -0,0 +1,23 @@
+BSD-2-Clause License (http://spdx.org/licenses/BSD-2-Clause)
+
+Redistribution and use in source and binary forms, with or without modification, are
+permitted provided that the following conditions are met:
+
+   1. Redistributions of source code must retain the above copyright notice, this list of
+      conditions and the following disclaimer.
+
+   2. Redistributions in binary form must reproduce the above copyright notice, this list
+      of conditions and the following disclaimer in the documentation and/or other materials
+      provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS'' AND ANY EXPRESS OR IMPLIED
+WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS
+OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+

data/README.md

@@ -0,0 +1,112 @@
+# Reusing
+
+## Short Story
+
+Reusing allows one to use refinements directly from an extension file.
+
+```ruby
+require 'reusing'
+
+using 'some_extension_script'
+```
+
+## Long Story
+
+Ruby introduced refinements in version 2.0. Refinements are essentially
+a safe alternative to monkey-patching. Unfortunately, a serious problem
+with the syntax of refinements is the degree to which they differ from
+writing tradition class extensions. Traditionally, if you want to add
+a method to the String class, for instance, you simply open the class
+and define them method.
+
+```ruby
+class String
+  def some_method
+    ...
+  end
+end
+```
+
+And that's it. You could put that code in a file and require as needed.
+Refinements, on the other hand, hand much more *boiler-plate*. The
+above would have to be written:
+
+```ruby
+module SomeModule
+  refine String do
+    def some_method
+      ...
+    end
+  end
+end
+
+using SomeModule
+```
+
+This can be put in a file too, but the `using SomeModule` will have to 
+be reissued in every file the refinement is needed.
+
+For a one off use, this isn't a big deal. But for a method library such as
+Ruby Facets, this has huge implications. In fact, Facets does not yet support
+refinements precisely b/c of this issue. To do so would require maintaining
+a second copy of every method in refinement format. While doable, it is obviously
+not DRY, and quite simply a pain in the ass.
+
+So the idea of overriding the `using` method to accept a library file name was
+hatched. With it, most extension scripts can be readily used as-is, without all
+the boiler-plate. Usage is pretty simple. Let's say the example given
+above is in a library file called `some_method.rb`, then we can do:
+
+```ruby
+require 'reusing'
+
+using 'some_method'
+```
+
+The refinement method will find the file, read it in, perform a transformation
+converting `class String` into `refine String do` and wrap it all in a module
+which it then passes to the original `using` method, which has been aliased, btw,
+as `reusing` (hence the name of this library).
+
+
+## Caveats
+
+Unfortunately the implementation of Reusing is necessarily a bit hackish. Although
+it works fine for basic extensions scripts there are complications if, for instance,
+the script requires another extension script. While the scripts extensions will become
+refinements, the further requirements will not.
+
+
+## Thoughts
+
+Probably the ideal solution would be if refinement syntax could use normal `class` and
+`module` keywords, instead of the special `refine` clause.
+
+```ruby
+module M
+  class String
+    def important!
+      self + "!"
+    end
+  end
+end
+
+# refinement
+using M::*
+```
+
+In conjunction with this is should be possible to monkey patch with the same code as well.
+
+```ruby
+# core extension
+patch M::*
+```
+
+In this way the both techniques could be used via the same code, while still being modular.
+
+
+## Copyrights
+
+Copyright (c) 2014 Rubyworks (BSD-2 License)
+
+See LICENSE.txt for details.

data/lib/reusing.rb

@@ -0,0 +1,25 @@
+require 'finder'
+
+class << self
+  alias :reusing :using
+
+  define_method :using do |feature|
+    if String === feature
+      file = Find.feature(feature, :absolute=>true).first
+
+      raise LoadError, "LoadError: cannot load such file -- #{file}" unless file
+
+      text = File.read(file)
+
+      text = text.gsub(/^\s*class\s*([A-Z]\w*)\s*$/, 'refine \1 do')
+      text = "m = Module.new do\n" + text + "\nend\nreusing m\n"
+
+      eval(text, TOPLEVEL_BINDING)
+    else
+      text = "reusing #{feature}"
+
+      eval(text, TOPLEVEL_BINDING)
+    end
+  end
+end
+

data/test/example.rb

@@ -0,0 +1,6 @@
+class String
+  def example
+    self + " example"
+  end
+end
+

data/test/test_reusing.rb

@@ -0,0 +1,23 @@
+require 'reusing'
+
+$LOAD_PATH.unshift(__dir__)
+
+using 'example'
+
+module M
+  refine String do
+    def important
+      self + "!"
+    end
+  end
+end
+
+using M
+
+result = "this".example
+raise unless result == "this example"
+
+result = "this".important
+raise unless result == "this!"
+
+

metadata

@@ -0,0 +1,128 @@
+--- !ruby/object:Gem::Specification
+name: reusing
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Thomas Sawyer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: finder
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubytest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubytest-cli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: microtest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: indexer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Reusing makes it possible to use refinements without all the boiler plate
+  normally necessary in their creation. Instead extension scripts can be loaded directly
+  as refinements.
+email:
+- transfire@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- .index
+- lib/reusing.rb
+- test/test_reusing.rb
+- test/example.rb
+- Gemfile.lock
+- README.md
+- LICENSE.txt
+homepage: http://rubyworks.github.com/reusing
+licenses:
+- BSD-2-Clause
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Use `using` with extension files.
+test_files:
+- test/test_reusing.rb
+- test/example.rb
+has_rdoc: