rkh-chainable 0.0.2

data/LICENSE

@@ -0,0 +1,27 @@
+copyright (c) 2009 Konstantin Haase.  All rights reserved.
+
+Developed by: Konstantin Haase
+              http://github.com/rkh/chainable
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal with 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:
+  1. Redistributions of source code must retain the above copyright notice,
+     this list of conditions and the following disclaimers.
+  2. Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimers in the
+     documentation and/or other materials provided with the distribution.
+  3. Neither the name of Konstantin Haase, nor the names of other contributors
+     may be used to endorse or promote products derived from this Software without
+     specific prior written permission.
+
+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
+CONTRIBUTORS 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
+WITH THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,82 @@
+<b>A word of warning:</b>
+
+This is heavy ruby abuse. It even got the Evil of the Day Award™ from zenspider.
+
+== Thou shalt not use alias_method_chain!
+- http://yehudakatz.com/2009/03/06/alias_method_chain-in-models
+- http://yehudakatz.com/2009/01/18/other-ways-to-wrap-a-method
+- http://www.codefluency.com/articles/2009/01/03/wrapping-a-method-in-ruby
+
+== What it does
+Chainable is an alternative to alias_method_chain, that uses inheritance, rather
+than aliasing. It does the following when "chaining" a method:
+
+- copy the original method to a new model
+- include the model
+- overwrite the method
+
+Thus you can use super and keep your method list clean, too!
+It even supports a (rather dangerous) auto chaining mode, so you do not have
+to explicitly chain a method, but chain a method whenever it would be
+overwritten instead.
+
+
+Example:
+
+  class Foo
+
+    def foo
+     10
+    end
+
+    # now chain to foo
+    chain_method :foo do
+      super + 3
+    end
+
+    # or turn on auto chaining
+    auto_chain do
+
+      def bar
+        10
+      end
+
+      def bar
+        super + 1
+      end
+
+      def bar
+        super ** 2
+      end
+
+    end
+  end
+
+  f = Foo.new
+  puts f.foo # => 13
+  puts f.bar # => 121
+
+Of course you can do this with any class (or module):
+
+  Array.class_eval do
+    chain_method :each
+    def each
+      return super if block_given? or RUBY_VERSION >= "1.8.7"
+      MyStuff::Enumerator.new self, :each
+    end
+  end
+
+== Benchmark
+chain_method tends do produce slightly faster methods than alias_method_chain:
+                                           user     system      total        real
+  chainable (define_method)            0.160000   0.010000   0.170000 (  0.183363)
+  chainable (def & eval)               0.170000   0.010000   0.180000 (  0.177084)
+  alias_method_chain (define_method)   0.570000   0.030000   0.600000 (  0.607330)
+  alias_method_chain (def & eval)      0.170000   0.020000   0.190000 (  0.190048)
+
+== Installation
+Add github gems, if you haven't already:
+  gem sources -a http://gems.github.com
+
+Install gem:
+  gem install rkh-chainable

metadata

@@ -0,0 +1,142 @@
+--- !ruby/object:Gem::Specification 
+name: rkh-chainable
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Konstantin Haase
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-03-20 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: never use alias_method_chain, again
+email: konstantin.mailinglists@googlemail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- LICENSE
+files: 
+- tmp/rkh/chainable/lib/chainable.rb
+- tmp/rkh/chainable/spec/chainable/chain_method_spec.rb
+- tmp/rkh/chainable/spec/chainable/auto_chain_spec.rb
+- tmp/rkh/chainable/benchmark/chainable.rb
+- rack/lib/rack/cascade.rb
+- rack/lib/rack/auth/digest/nonce.rb
+- rack/lib/rack/auth/digest/md5.rb
+- rack/lib/rack/auth/digest/request.rb
+- rack/lib/rack/auth/digest/params.rb
+- rack/lib/rack/auth/abstract/handler.rb
+- rack/lib/rack/auth/abstract/request.rb
+- rack/lib/rack/auth/openid.rb
+- rack/lib/rack/auth/basic.rb
+- rack/lib/rack/recursive.rb
+- rack/lib/rack/response.rb
+- rack/lib/rack/reloader.rb
+- rack/lib/rack/urlmap.rb
+- rack/lib/rack/commonlogger.rb
+- rack/lib/rack/session/cookie.rb
+- rack/lib/rack/session/abstract/id.rb
+- rack/lib/rack/session/pool.rb
+- rack/lib/rack/session/memcache.rb
+- rack/lib/rack/lint.rb
+- rack/lib/rack/showstatus.rb
+- rack/lib/rack/showexceptions.rb
+- rack/lib/rack/file.rb
+- rack/lib/rack/mock.rb
+- rack/lib/rack/builder.rb
+- rack/lib/rack/lobster.rb
+- rack/lib/rack/handler/mongrel.rb
+- rack/lib/rack/handler/scgi.rb
+- rack/lib/rack/handler/fastcgi.rb
+- rack/lib/rack/handler/webrick.rb
+- rack/lib/rack/handler/lsws.rb
+- rack/lib/rack/handler/cgi.rb
+- rack/lib/rack/adapter/camping.rb
+- rack/lib/rack/request.rb
+- rack/lib/rack/static.rb
+- rack/lib/rack/utils.rb
+- rack/lib/rack.rb
+- rack/test/spec_rack_session_pool.rb
+- rack/test/spec_rack_mongrel.rb
+- rack/test/spec_rack_utils.rb
+- rack/test/spec_rack_urlmap.rb
+- rack/test/spec_rack_fastcgi.rb
+- rack/test/spec_rack_showexceptions.rb
+- rack/test/spec_rack_lint.rb
+- rack/test/spec_rack_camping.rb
+- rack/test/spec_rack_recursive.rb
+- rack/test/spec_rack_webrick.rb
+- rack/test/spec_rack_auth_digest.rb
+- rack/test/spec_rack_file.rb
+- rack/test/spec_rack_builder.rb
+- rack/test/spec_rack_session_memcache.rb
+- rack/test/spec_rack_mock.rb
+- rack/test/spec_rack_lobster.rb
+- rack/test/spec_rack_request.rb
+- rack/test/spec_rack_auth_basic.rb
+- rack/test/testrequest.rb
+- rack/test/spec_rack_cgi.rb
+- rack/test/spec_rack_showstatus.rb
+- rack/test/spec_rack_session_cookie.rb
+- rack/test/spec_rack_response.rb
+- rack/test/spec_rack_static.rb
+- rack/test/spec_rack_cascade.rb
+- rack/test/spec_rack_commonlogger.rb
+- rack/example/protectedlobster.rb
+- sinatra/lib/sinatra/test/methods.rb
+- sinatra/lib/sinatra/test/spec.rb
+- sinatra/lib/sinatra/test/unit.rb
+- sinatra/lib/sinatra.rb
+- sinatra/test/use_in_file_templates_test.rb
+- sinatra/test/app_test.rb
+- sinatra/test/rest_test.rb
+- sinatra/test/custom_error_test.rb
+- sinatra/test/sym_params_test.rb
+- sinatra/test/diddy_test.rb
+- sinatra/test/template_test.rb
+- sinatra/test/haml_test.rb
+- sinatra/test/streaming_test.rb
+- sinatra/test/erb_test.rb
+- sinatra/test/event_context_test.rb
+- sinatra/test/builder_test.rb
+- sinatra/test/sass_test.rb
+- sinatra/test/events_test.rb
+- sinatra/test/mapped_error_test.rb
+- sinatra/test/helper.rb
+- sinatra/test/sessions_test.rb
+- sinatra/test/application_test.rb
+has_rdoc: true
+homepage: http://rkh.github.com/chainable
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: never use alias_method_chain, again
+test_files: []
+