mynyml-swap 0.1.1

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright © 2009 Martin Aumont (mynyml)
+
+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. 

data/README

@@ -0,0 +1,30 @@
+==== Summary
+
+Swap allows dynamically replacing and restoring methods.
+Useful as a stubbing device, as it allows unstubbing as well.
+
+==== Examples
+  # We can use ruby2ruby to inspect changes
+  require 'ruby2ruby'
+
+  class User
+    attr_accessor :name
+  end
+  user = User.new
+  user.name = 'martin'
+  puts user.name #=> 'martin'
+
+  puts Ruby2Ruby.translate(User, :name)
+
+  User.swap!(:name) { @name.reverse }
+  puts user.name #=> 'nitram'
+
+  puts Ruby2Ruby.translate(User, :name)
+
+  User.unswap!(:name)
+  puts user.name #=> 'martin'
+
+  puts Ruby2Ruby.translate(User, :name)
+
+
+Calling #unswap! without argument will restore all swapped methods.

data/Rakefile

@@ -0,0 +1,49 @@
+require 'rake/gempackagetask'
+require 'pathname'
+require 'yaml'
+
+def gem
+  RUBY_1_9 ? 'gem19' : 'gem'
+end
+
+def all_except(paths)
+  Dir['**/*'] - paths.map {|path| path.strip.gsub(/^\//,'').gsub(/\/$/,'') }
+end
+
+spec = Gem::Specification.new do |s|
+  s.name            = 'swap'
+  s.version         = '0.1.1'
+  s.summary         = "Ruby lib that allows dynamically replacing and restoring methods."
+  s.description     = "Ruby lib that allows dynamically replacing and restoring methods. Organic stubbing/unstubbing."
+  s.author          = "Martin Aumont"
+  s.email           = 'mynyml@gmail.com'
+  s.homepage        = ''
+  s.has_rdoc        = true
+  s.require_path    = "lib"
+  s.files           = Dir['**/*']
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.gem_spec = spec
+end
+
+
+desc "Remove package products"
+task :clean => :clobber_package
+
+desc "Update the gemspec for GitHub's gem server"
+task :gemspec do
+  Pathname("#{spec.name}.gemspec").open('w') {|f| f << YAML.dump(spec) }
+end
+
+desc "Install gem"
+task :install => [:clobber, :package] do
+  sh "#{SUDO} #{gem} install pkg/#{spec.full_name}.gem"
+end
+
+desc "Uninstall gem"
+task :uninstall => :clean do
+  sh "#{SUDO} #{gem} uninstall -v #{spec.version} -x #{spec.name}"
+end
+
+

data/examples/simple.rb

@@ -0,0 +1,27 @@
+require 'pathname'
+require 'rubygems'
+require 'ruby2ruby'
+root  =  Pathname(__FILE__).dirname.parent
+require root.join('lib/swap')
+
+class User
+  attr_writer :name
+  def name
+    @name
+  end
+end
+user = User.new
+user.name = 'martin'
+puts user.name #=> 'martin'
+
+puts Ruby2Ruby.translate(User, :name)
+
+User.swap!(:name) { @name.reverse }
+puts user.name #=> 'nitram'
+
+puts Ruby2Ruby.translate(User, :name)
+
+User.unswap!(:name)
+puts user.name #=> 'martin'
+
+puts Ruby2Ruby.translate(User, :name)

data/lib/swap.rb

@@ -0,0 +1,76 @@
+class Class
+
+  # Swaps a method for another
+  #
+  # ==== Arguments
+  # name<Symbol>::
+  #   Name of original method to swap
+  # code<String|Proc|UnboundMethod>::
+  #   New code for method
+  #
+  # ==== Block
+  # Alternative way to pass method code
+  #
+  # ==== Returns
+  # self
+  #
+  # ==== Examples
+  # User.swap!(:name, "@name.reverse")
+  # User.swap!(:name, lambda { @name.reverse })
+  # User.swap!(:name) { @name.reverse }
+  # User.swap!(:name, User.instance_method(:first_name))
+  #
+  def swap!(name, code=nil, &block)
+    name = name.to_sym
+    meth = self.instance_method(name.to_sym)
+    @swapped_methods ||= {}
+    @swapped_methods[name] = meth
+    if block_given?
+      self.class_eval { define_method(name, &block) }
+    else
+      case code
+      when String
+        self.class_eval(%|def #{name}() #{code}; end|)
+      when Proc, UnboundMethod
+        self.class_eval { define_method(name, code) }
+      end
+    end
+    self
+  end
+
+  # Restores a swapped method
+  #
+  # ==== Arguments
+  # name<String>::
+  #   Name of method to restore. If nil, all swapped methods for this class
+  #   will be restored.
+  #
+  # ==== Returns
+  # self
+  #
+  # ==== Examples
+  # class User
+  #   attr_accessor :name
+  # end
+  # user = User.new
+  # user.name = 'martin'
+  # puts user.name #=> 'martin'
+  #
+  # User.swap!(:name) { @name.reverse }
+  # puts user.name #=> 'nitram'
+  #
+  # User.unswap!(:name)
+  # puts user.name #=> 'martin'
+  #
+  def unswap!(name=nil)
+    if name
+      name = name.to_sym
+      self.class_eval { define_method(name, @swapped_methods[name]) }
+    else
+      @swapped_methods.each do |name, code|
+        self.class_eval { define_method(name, code) }
+      end
+    end
+    self
+  end
+end

data/swap.gemspec

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification 
+name: swap
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- Martin Aumont
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-03-18 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Ruby lib that allows dynamically replacing and restoring methods. Organic stubbing/unstubbing.
+email: mynyml@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib
+- lib/swap.rb
+- examples
+- examples/simple.rb
+- LICENSE
+- README
+- Rakefile
+- test
+- test/test_swap.rb
+- test/test_helper.rb
+- swap.gemspec
+- TODO
+has_rdoc: true
+homepage: ""
+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.3.1
+signing_key: 
+specification_version: 2
+summary: Ruby lib that allows dynamically replacing and restoring methods.
+test_files: []
+

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'test/unit'
+require 'rubygems'
+require 'context'
+require 'matchy'
+begin
+  require 'ruby-debug'
+  require 'quietbacktrace'
+rescue LoadError, RuntimeError
+  # pass
+end

data/test/test_swap.rb

@@ -0,0 +1,59 @@
+require 'pathname'
+root  =  Pathname(__FILE__).dirname.parent
+require root.join('test/test_helper')
+require root.join('lib/swap')
+
+class SwapTest < Test::Unit::TestCase
+  context "Swap" do
+    before do
+      class ::Kitty
+        def say() 'ohaie' end
+      end
+    end
+    after do
+      Object.class_eval { remove_const(:Kitty) }
+      defined?(::Kitty).should be(nil)
+    end
+    context "replacing instance method" do
+      test "accepts string" do
+        Kitty.swap!(:say, %( 'kthxbai'.reverse ))
+        Kitty.new.say.should be('kthxbai'.reverse)
+      end
+      test "accepts block" do
+        Kitty.swap!(:say) { 'kthxbai' }
+        Kitty.new.say.should be('kthxbai')
+      end
+      test "accepts proc" do
+        Kitty.swap!(:say, lambda { 'kthxbai' })
+        Kitty.new.say.should be('kthxbai')
+      end
+      test "accepts unbound method" do
+        class ::Kitty
+          def bai() 'kthxbai' end
+        end
+        Kitty.swap!(:say, Kitty.instance_method(:bai))
+        Kitty.new.say.should be('kthxbai')
+      end
+    end
+    context "reseting original methods" do
+      test "restores single method" do
+        Kitty.swap!(:say) { 'kthxbai' }
+        Kitty.new.say.should be('kthxbai')
+        Kitty.unswap!(:say)
+        Kitty.new.say.should be('ohaie')
+      end
+      test "restores all methods" do
+        class ::Kitty
+          def bai() 'kthxbai' end
+        end
+        Kitty.swap!(:say) { 'o.0'  }
+        Kitty.swap!(:bai) { 'zZzz' }
+        Kitty.new.say.should be('o.0' )
+        Kitty.new.bai.should be('zZzz')
+        Kitty.unswap!
+        Kitty.new.say.should be('ohaie')
+        Kitty.new.bai.should be('kthxbai')
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification 
+name: mynyml-swap
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- Martin Aumont
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-03-17 21:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Ruby lib that allows dynamically replacing and restoring methods. Organic stubbing/unstubbing.
+email: mynyml@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib
+- lib/swap.rb
+- examples
+- examples/simple.rb
+- LICENSE
+- README
+- Rakefile
+- test
+- test/test_swap.rb
+- test/test_helper.rb
+- swap.gemspec
+- TODO
+has_rdoc: true
+homepage: ""
+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: Ruby lib that allows dynamically replacing and restoring methods.
+test_files: []
+