nayutaya-kagemusha 0.0.9

data/HISTORY

@@ -0,0 +1,33 @@
+
+== 0.0.8 2009-02-09
+
+...
+
+== 0.0.7 2008-07-19
+
+...
+
+== 0.0.6 2008-07-17
+
+...
+
+== 0.0.5 2008-07-16
+
+...
+
+== 0.0.4 2008-07-09
+
+...
+
+== 0.0.3 2007-09-10
+
+...
+
+== 0.0.2 2007-08-27
+
+...
+
+== 0.0.1 2007-08-15
+
+* 1 major enhancement:
+  * Initial release

data/HISTORY.ja

@@ -0,0 +1,43 @@
+
+== 0.0.9 2009-06-29
+
+* github.comへ移動
+
+== 0.0.8 2009-02-09
+
+* Ruby 1.9.1対応
+  * マジックコメントを追加
+  * ブロック引数のチェックが厳しくなった変更に対応
+  * メソッド一覧を取得するメソッド（methods等）がシンボルの配列を返すようになった変更に対応
+
+== 0.0.7 2008-07-19
+
+* lib/kagemusha/composite.rb、test/test_composite.rbがgemに格納されていなかったのを修正 :-(
+
+== 0.0.6 2008-07-17
+
+* Kagemusha::Compositeクラスを追加
+* Kagemusha#+を追加
+* private/protectedなインスタンスメソッドの置換に対応
+
+== 0.0.5 2008-07-16
+
+* Kernelモジュールのメソッドの復元に失敗する不具合を修正
+
+== 0.0.4 2008-07-09
+
+* インスタンスメソッド、クラスメソッドの復元に失敗する不具合を修正
+* newgem 0.25.0で生成したパッケージに変更
+
+== 0.0.3 2007-09-10
+
+* インスタンスメソッド、クラスメソッドの追加/削除機能を追加
+
+== 0.0.2 2007-08-27
+
+* ブロックによる初期化機能を追加
+* 各種スタイルでの記述例を追加
+
+== 0.0.1 2007-08-15
+
+* 初版

data/LICENSE

@@ -0,0 +1,54 @@
+
+Kagemusha is copyrighted free software by Yuya Kato
+<yuyakato at gmail dot com> You can redistribute it and/or modify it under
+either the terms of the GPL or the conditions below:
+
+1. You may make and give away verbatim copies of the source form of the
+   software without restriction, provided that you duplicate all of the
+   original copyright notices and associated disclaimers.
+
+2. You may modify your copy of the software in any way, provided that
+   you do at least ONE of the following:
+
+     a) place your modifications in the Public Domain or otherwise make them
+     Freely Available, such as by posting said modifications to Usenet or an
+     equivalent medium, or by allowing the author to include your
+     modifications in the software.
+
+     b) use the modified software only within your corporation or
+        organization.
+
+     c) rename any non-standard executables so the names do not conflict with
+     standard executables, which must also be provided.
+
+     d) make other distribution arrangements with the author.
+
+3. You may distribute the software in object code or executable
+   form, provided that you do at least ONE of the following:
+
+     a) distribute the executables and library files of the software,
+     together with instructions (in the manual page or equivalent) on where
+     to get the original distribution.
+
+     b) accompany the distribution with the machine-readable source of the
+     software.
+
+     c) give non-standard executables non-standard names, with
+        instructions on where to get the original software distribution.
+
+     d) make other distribution arrangements with the author.
+
+4. You may modify and include the part of the software into any other
+   software (possibly commercial).  But some files in the distribution
+   are not written by the author, so that they are not under this terms.
+
+5. The scripts and library files supplied as input to or produced as 
+   output from the software do not automatically fall under the
+   copyright of the software, but belong to whomever generated them, 
+   and may be sold commercially, and may be aggregated with this
+   software.
+
+6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+   IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+   WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+   PURPOSE.

data/README

@@ -0,0 +1,57 @@
+
+= Kagemusha - a library of testing mock-objects
+
+http://github.com/nayutaya/kagemusha/
+
+== DESCRIPTION:
+
+Kagemusha is a library of helper functions
+for testing Ruby scripts.  It helps you generating
+scoped mock-objects which overrides behavior of
+the class restricted in given blocks, without
+tainting a global area.
+
+For example, if you override Date.today when you write
+something about dates, then the code will taint global
+areas to no purpose.
+
+If you use Kagemusha, the test code will override
+behavior of the class restricted in given block.
+
+Example:
+  require "kagemusha"
+
+  musha = Kagemusha.new(Time)
+  musha.defs(:now) { self.local(2000, 1, 1) }
+  musha.def(:to_s) { self.strftime("%Y-%m-%d") } 
+
+  musha.swap {
+    p Time.now      #=> Sat Jan 01 00:00:00 +0900 2000
+    p Time.now.to_s #=> "2000-01-01"
+  }
+
+Also, it has default useful mock-objects set Date, Time,
+rand, and so on.
+
+Example:
+  require "kagemusha/date"
+
+  musha = Kagemusha::Date.at(2000, 1, 1)
+  musha.swap {
+    p Date.today.to_s #=> "2000-01-01"
+  }
+
+== SYNOPSIS:
+
+see example directory.
+
+== INSTALL:
+
+The easiest way to get started with Kagemusha is to
+install it via RubyGems. You can do this easily:
+
+  $ gem install nayutaya-kagemusha
+
+== LICENSE:
+
+Ruby's License

data/README.ja

@@ -0,0 +1,59 @@
+
+影武者 - テスト用モック作成支援ライブラリ
+=========================================
+
+これって何?
+-----------
+
+  Rubyでテストコードを記述するための便利ライブラリです。
+  
+  例えば日付関係のテストを記述する際にはDate.todayなどの
+  挙動を上書きするなどの手法がありますが、このやり方ですと
+  無駄にグローバル領域を汚染してしまいます。
+  
+  ブロックで指定された範囲内のみに限定して基本的なクラスの
+  挙動を上書きするために、このライブラリを作りました。
+
+  例:
+    require "kagemusha"
+
+    musha = Kagemusha.new(Time)
+    musha.defs(:now) { self.local(2000, 1, 1) }
+    musha.def(:to_s) { self.strftime("%Y-%m-%d") } 
+
+    musha.swap {
+      p Time.now      #=> Sat Jan 01 00:00:00 +0900 2000
+      p Time.now.to_s #=> "2000-01-01"
+    }
+
+  なお、よく使うと思われるDate、Time、randなどに対するモックを
+  いくつか標準で用意されています。
+  
+  例:
+    require "kagemusha/date"
+
+    musha = Kagemusha::Date.at(2000, 1, 1)
+    musha.swap {
+      p Date.today.to_s #=> "2000-01-01"
+    }
+
+
+インストール
+------------
+
+  Gemでインストールしてください。
+
+    $ gem install nayutaya-kagemusha
+
+
+利用例
+------
+
+  exampleディレクトリを見てください。
+
+
+サポート
+--------
+
+  何かありましたら下記までお願いします。
+    加藤 勇也 (Yuya Kato) <yuyakato at gmail.com>

data/Rakefile

@@ -0,0 +1,29 @@
+
+require "rake/testtask"
+
+task :default => [:test]
+
+Rake::TestTask.new do |test|
+  test.libs << "test"
+  test.test_files = Dir.glob("test/test_*.rb")
+  test.verbose    =  true
+end
+
+desc "Generate gemspec file from template"
+task :gemspec do
+  require "erb"
+  require "lib/kagemusha"
+
+  src = File.open("kagemusha.gemspec.erb", "rb") { |file| file.read }
+  erb = ERB.new(src, nil, "-")
+
+  version = Kagemusha::VERSION
+  date    = Time.now.strftime("%Y-%m-%d")
+
+  files      = Dir.glob("**/*").select { |s| File.file?(s) }
+  test_files = Dir.glob("test/**").select { |s| File.file?(s) }
+
+  File.open("kagemusha.gemspec", "wb") { |file|
+    file.write(erb.result(binding))
+  }
+end

data/examples/date.rb

@@ -0,0 +1,22 @@
+# coding: utf-8
+# $Id: date.rb 108 2009-02-09 06:04:39Z yuyakato $
+
+require "rubygems"
+require "kagemusha/date"
+
+p Date.today.strftime("%Y-%m-%d") #=> today
+
+# Normal Style.
+musha = Kagemusha::Date.on(2007, 1, 1)
+musha.swap {
+  p Date.today.strftime("%Y-%m-%d") #=> 2007-01-01
+}
+
+p Date.today.strftime("%Y-%m-%d") #=> today
+
+# Block Style.
+Kagemusha::Date.on(2007, 1, 1) {
+  p Date.today.strftime("%Y-%m-%d") #=> 2007-01-01
+}
+
+p Date.today.strftime("%Y-%m-%d") #=> today

data/examples/datetime.rb

@@ -0,0 +1,32 @@
+# coding: utf-8
+# $Id: datetime.rb 108 2009-02-09 06:04:39Z yuyakato $
+
+require "rubygems"
+require "kagemusha/datetime"
+
+p Date.today.strftime("%Y-%m-%d") #=> today
+p Time.now                        #=> now
+puts "---"
+
+# Normal Style.
+musha = Kagemusha::DateTime.at(1984, 5, 11, 5, 15, 30)
+musha.swap {
+  p Date.today.strftime("%Y-%m-%d") #=> 1984-05-11
+  p Time.now                        #=> 1984-05-11 05:15:30
+  puts "---"
+}
+
+p Date.today.strftime("%Y-%m-%d") #=> today
+p Time.now                        #=> now
+puts "---"
+
+# Block Style.
+Kagemusha::DateTime.at(1984, 5, 11, 5, 15, 30) {
+  p Date.today.strftime("%Y-%m-%d") #=> 1984-05-11
+  p Time.now                        #=> 1984-05-11 05:15:30
+  puts "---"
+}
+
+p Date.today.strftime("%Y-%m-%d") #=> today
+p Time.now                        #=> now
+puts "---"

data/examples/first.rb

@@ -0,0 +1,23 @@
+# coding: utf-8
+# $Id: first.rb 108 2009-02-09 06:04:39Z yuyakato $
+
+require "rubygems"
+require "kagemusha"
+
+musha = Kagemusha.new(Time)
+musha.defs(:now) { self.local(1984, 5, 11) }
+musha.def(:+) { |other| other }
+
+p Time.now                #=> now
+p Time.now + 60 * 60 * 24 #=> now + 24 hours
+puts "---"
+
+musha.swap {
+  p Time.now                #=> 1984-05-11 00:00:00
+  p Time.now + 60 * 60 * 24 #=> 86400
+  puts "---"
+}
+
+p Time.now                #=> now
+p Time.now + 60 * 60 * 24 #=> now + 24 hours
+puts "---"

data/examples/rand.rb

@@ -0,0 +1,32 @@
+# coding: utf-8
+# $Id: rand.rb 108 2009-02-09 06:04:39Z yuyakato $
+
+require "rubygems"
+require "kagemusha/rand"
+
+p rand(100) #=> rand
+p rand(100) #=> rand
+puts "---"
+
+# Normal Style.
+musha = Kagemusha::Rand.always(1)
+musha.swap {
+  p rand(100) #=> 1
+  p rand(100) #=> 1
+  puts "---"
+}
+
+p rand(100) #=> rand
+p rand(100) #=> rand
+puts "---"
+
+# Block Style.
+Kagemusha::Rand.always(1) {
+  p rand(100) #=> 1
+  p rand(100) #=> 1
+  puts "---"
+}
+
+p rand(100) #=> rand
+p rand(100) #=> rand
+puts "---"

data/examples/style.rb

@@ -0,0 +1,39 @@
+# coding: utf-8
+# $Id: style.rb 117 2009-02-09 08:09:27Z yuyakato $
+
+require "rubygems"
+require "kagemusha"
+
+def one_plus_one
+  return 1 + 1
+end
+
+p one_plus_one #=> 2
+
+# Normal Style.
+musha = Kagemusha.new(Fixnum)
+musha.def(:+) { |x| 1 }
+musha.swap {
+  p one_plus_one #=> 1
+}
+
+p one_plus_one #=> 2
+
+# Block Style.
+Kagemusha.new(Fixnum) { |m|
+  m.def(:+) { |x| 1 }
+  m.swap {
+    p one_plus_one #=> 1
+  }
+}
+
+p one_plus_one #=> 2
+
+# Chain Style.
+Kagemusha.new(Fixnum).
+  def(:+) { |x| 1 }.
+  swap {
+    p one_plus_one #=> 1
+  }
+
+p one_plus_one #=> 2

data/examples/time.rb

@@ -0,0 +1,22 @@
+# coding: utf-8
+# $Id: time.rb 108 2009-02-09 06:04:39Z yuyakato $
+
+require "rubygems"
+require "kagemusha/time"
+
+p Time.now #=> now
+
+# Normal Style.
+musha = Kagemusha::Time.at(2007, 1, 1)
+musha.swap {
+  p Time.now #=> 2007-01-01 00:00:00
+}
+
+p Time.now #=> now
+
+# Block Style.
+Kagemusha::Time.at(2007, 1, 1) {
+  p Time.now #=> 2007-01-01 00:00:00
+}
+
+p Time.now #=> now

data/kagemusha.gemspec

@@ -0,0 +1,67 @@
+
+Gem::Specification.new do |s|
+  s.specification_version     = 2
+  s.required_rubygems_version = Gem::Requirement.new(">= 0")
+  s.required_ruby_version     = Gem::Requirement.new(">= 1.8.6")
+
+  s.name    = "kagemusha"
+  s.version = "0.0.9"
+  s.date    = "2009-06-29"
+
+  s.authors = ["Yuya Kato"]
+  s.email   = "yuyakato@gmail.com"
+
+  s.summary     = "kagemusha"
+  s.description = "kagemusha"
+  s.homepage    = "http://github.com/nayutaya/kagemusha/"
+
+  s.rubyforge_project = nil
+  s.has_rdoc          = false
+  s.require_paths     = ["lib"]
+
+  s.files = [
+    "examples/date.rb",
+    "examples/datetime.rb",
+    "examples/first.rb",
+    "examples/rand.rb",
+    "examples/style.rb",
+    "examples/time.rb",
+    "HISTORY",
+    "HISTORY.ja",
+    "kagemusha.gemspec",
+    "kagemusha.gemspec.erb",
+    "lib/kagemusha/composite.rb",
+    "lib/kagemusha/core.rb",
+    "lib/kagemusha/date.rb",
+    "lib/kagemusha/datetime.rb",
+    "lib/kagemusha/rand.rb",
+    "lib/kagemusha/time.rb",
+    "lib/kagemusha/version.rb",
+    "lib/kagemusha.rb",
+    "LICENSE",
+    "Rakefile",
+    "README",
+    "README.ja",
+    "test/test_bugs.rb",
+    "test/test_complex_cases.rb",
+    "test/test_composite.rb",
+    "test/test_date.rb",
+    "test/test_datetime.rb",
+    "test/test_helper.rb",
+    "test/test_kagemusha.rb",
+    "test/test_rand.rb",
+    "test/test_time.rb",
+  ]
+  s.test_files = [
+    "test/test_bugs.rb",
+    "test/test_complex_cases.rb",
+    "test/test_composite.rb",
+    "test/test_date.rb",
+    "test/test_datetime.rb",
+    "test/test_helper.rb",
+    "test/test_kagemusha.rb",
+    "test/test_rand.rb",
+    "test/test_time.rb",
+  ]
+  s.extra_rdoc_files = []
+end

data/kagemusha.gemspec.erb

@@ -0,0 +1,33 @@
+
+Gem::Specification.new do |s|
+  s.specification_version     = 2
+  s.required_rubygems_version = Gem::Requirement.new(">= 0")
+  s.required_ruby_version     = Gem::Requirement.new(">= 1.8.6")
+
+  s.name    = "kagemusha"
+  s.version = <%= version.dump %>
+  s.date    = <%= date.dump %>
+
+  s.authors = ["Yuya Kato"]
+  s.email   = "yuyakato@gmail.com"
+
+  s.summary     = "kagemusha"
+  s.description = "kagemusha"
+  s.homepage    = "http://github.com/nayutaya/kagemusha/"
+
+  s.rubyforge_project = nil
+  s.has_rdoc          = false
+  s.require_paths     = ["lib"]
+
+  s.files = [
+<%- files.each { |path| -%>
+    <%= path.dump %>,
+<%- } -%>
+  ]
+  s.test_files = [
+<%- test_files.each { |path| -%>
+    <%= path.dump %>,
+<%- } -%>
+  ]
+  s.extra_rdoc_files = []
+end

data/lib/kagemusha/composite.rb

@@ -0,0 +1,42 @@
+# coding: utf-8
+
+#==============================================================================#
+# $Id: composite.rb 108 2009-02-09 06:04:39Z yuyakato $
+#==============================================================================#
+
+class Kagemusha
+  class Composite
+    def initialize(*mocks)
+      @mocks = []
+      mocks.each { |mock| self << mock }
+    end
+
+    attr_reader :mocks
+
+    def size
+      return @mocks.size
+    end
+
+    def add(mock)
+      raise(ArgumentError) unless mock.kind_of?(Kagemusha) || mock.kind_of?(Kagemusha::Composite)
+      @mocks << mock
+      return self
+    end
+    alias << add
+
+    def concat(mock)
+      return self.class.new(*self.mocks) << mock
+    end
+    alias + concat
+
+    def swap(&block)
+      src = (0...self.size).to_a.reverse.inject("return yield") { |memo, index|
+        "@mocks[#{index}].swap { #{memo} }"
+      }
+      return eval(src, &block)
+    end
+  end
+end
+
+#==============================================================================#
+#==============================================================================#