flexmock 0.7.0 → 0.7.1

data/CHANGES

@@ -1,6 +1,11 @@
 = Changes for FlexMock
 
-== Pre-Version 0.7.0
+== Pre-Version 0.7.1
+
+* Updated install.rb to handle non-root destination directories via
+  DESTDIR.
+
+== Version 0.7.0
 
 * Added +and_yield+ as an expectation clause.
 * Inspect on Mocks now yield a more consise description.

data/README

@@ -3,7 +3,7 @@
 FlexMock is a simple, but flexible, mock object library for Ruby unit
 testing.
 
-Version :: 0.7.0
+Version :: 0.7.1
 
 = Links
 

data/Rakefile

@@ -19,7 +19,7 @@ require 'rake/contrib/rubyforgepublisher'
 CLEAN.include('*.tmp')
 CLOBBER.include("html", 'pkg')
 
-PKG_VERSION = '0.7.0'
+PKG_VERSION = '0.7.1'
 
 PKG_FILES = FileList[
   '[A-Z]*',

data/doc/releases/flexmock-0.7.1.rdoc

@@ -0,0 +1,93 @@
+= FlexMock 0.7.1 Released
+
+FlexMock is a flexible mocking library for use in unit testing and behavior
+specification in Ruby. Version 0.7.1 includes a minor bug fix.
+
+== Bug Fixes n 0.7.1
+
+* A bug in demeter mocking in 0.7.0 prevented the mocking of
+  operators.  This has been fixed.
+
+== What is FlexMock?
+
+FlexMock is a flexible framework for creating mock object for testing. When
+running unit tests, it is often desirable to use isolate the objects being
+tested from the "real world" by having them interact with simplified test
+objects. Sometimes these test objects simply return values when called, other
+times they verify that certain methods were called with particular arguments
+in a particular order.
+
+FlexMock makes creating these test objects easy.
+
+=== Features
+
+* Easy integration with both Test::Unit and RSpec. Mocks created with the
+  flexmock method are automatically verified at the end of the test or
+  example.
+
+* A fluent interface that allows mock behavior to be specified very
+  easily.
+
+* A "record mode" where an existing implementation can record its
+  interaction with a mock for later validation against a new
+  implementation.
+
+* Easy mocking of individual methods in existing, non-mock objects.
+
+* Easy mocking of chains of method calls.
+
+* The ability to cause classes to instantiate test instances (instead of real
+  instances) for the duration of a test.
+
+=== Example
+
+Suppose you had a Dog object that wagged a tail when it was happy.
+Something like this:
+
+  class Dog
+    def initialize(a_tail)
+      @tail = a_tail
+    end
+    def happy
+      @tail.wag
+    end
+  end
+
+To test the +Dog+ class without a real +Tail+ object (perhaps because
+real +Tail+ objects activate servos in some robotic equipment), you
+can do something like this:
+
+require 'test/unit'
+require 'flexmock/test_unit'
+
+  class TestDog < Test::Unit::TestCase
+    def test_dog_wags_tail_when_happy
+      tail = flexmock("tail")
+      tail.should_receive(:wag).once
+      dog = Dog.new(tail)
+      dog.happy
+    end
+  end
+
+FlexMock will automatically verify that the mocked tail object received the
+message +wag+ exactly one time. If it doesn't, the test will not pass.
+
+See the FlexMock documentation at http://flexmock.rubyforge.org for details on
+specifying arguments and return values on mocked methods, as well as a simple
+technique for mocking tail objects when the Dog class creates the tail objects
+directly.
+
+== Availability
+
+You can make sure you have the latest version with a quick RubyGems command:
+
+  gem install flexmock    (you may need root/admin privileges)
+
+Otherwise, you can get it from the more traditional places:
+
+Download::  http://rubyforge.org/project/showfiles.php?group_id=170
+
+You will find documentation at: http://flexmock.rubyforge.org.
+
+-- Jim Weirich
+

data/install.rb

@@ -26,6 +26,14 @@ unless $sitedir
   end
 end
 
+if (destdir = ENV['DESTDIR'])
+  $sitedir = destdir + $sitedir
+  File::makedirs($sitedir)
+end
+
+flexmock_dest = File.join($sitedir, "flexmock")
+File::makedirs(flexmock_dest, true)
+File::chmod(0755, flexmock_dest)
 # The library files
 
 file = 'flexmock.rb'

data/lib/flexmock/mock_container.rb

@@ -303,11 +303,13 @@ class FlexMock
       end
     end
     
+    METHOD_NAME_RE = /^([A-Za-z_][A-Za-z0-9_]*[=!?]?|\[\]=?||\*\*|<<|>>|<=>|[<>=]=|=~|===|[-+]@|[-+\*\/%&^|<>~])$/
+
     # Check that all the names in the list are valid method names.
     def check_method_names(names)
       names.each do |name|
         fail FlexMock::UsageError, "Ill-formed method name '#{name}'" if
-          name !~ /^[A-Za-z_][A-Za-z0-9_]*[=!?]?$/
+          name !~ METHOD_NAME_RE
       end
     end
   end

data/test/test_demeter_mocking.rb

@@ -16,6 +16,21 @@ class TestDemeterMocking < Test::Unit::TestCase
     assert_equal :first, m.children.first
   end
 
+  def test_demeter_mocking_with_operators
+    m = flexmock("A")
+    m.should_receive("children.+@.last").and_return(:value)
+    assert_kind_of FlexMock, m
+    assert_kind_of FlexMock, m.children
+    assert_kind_of FlexMock, + m.children
+    assert_equal :value, (+ m.children).last
+  end
+
+  def test_demeter_mocking_with_multiple_operators
+    m = flexmock("A")
+    m.should_receive("+@.-@.~").and_return(:value)
+    assert_equal :value, ~-+m
+  end
+
   def test_multiple_demeter_mocks_on_same_branch_is_ok
     m = flexmock("A")
     m.should_receive("child.x.y.z.first").and_return(:first)

data/test/test_should_receive.rb

@@ -865,6 +865,41 @@ class TestFlexMockShoulds < Test::Unit::TestCase
     assert_equal :mkf, m2.mock_kernel_function
   end
 
+  def test_can_mock_operators
+    assert_operator(:[]) { |m| m[1] }
+    assert_operator(:[]=) { |m| m[1] = :value }
+    assert_operator(:**) { |m| m ** :x }
+    assert_operator(:+@) { |m| +m }
+    assert_operator(:-@) { |m| -m }
+    assert_operator(:+) { |m| m + :x }
+    assert_operator(:-) { |m| m - :x }
+    assert_operator(:*) { |m| m * :x }
+    assert_operator(:"/") { |m| m / :x }
+    assert_operator(:%) { |m| m % :x }
+    assert_operator(:~) { |m| ~m }
+    assert_operator(:&) { |m| m & :x }
+    assert_operator(:|) { |m| m | :x }
+    assert_operator(:^) { |m| m ^ :x }
+    assert_operator(:<) { |m| m < :x }
+    assert_operator(:>) { |m| m > :x }
+    assert_operator(:>=) { |m| m >= :x }
+    assert_operator(:<=) { |m| m <= :x }
+    assert_operator(:==) { |m| m == :x }
+    assert_operator(:===) { |m| m === :x }
+    assert_operator(:<<) { |m| m << :x }
+    assert_operator(:>>) { |m| m >> :x }
+    assert_operator(:<=>) { |m| m <=> :x }
+    assert_operator(:=~) { |m| m =~ :x }
+  end
+
+  private
+
+  def assert_operator(op, &block)
+    m = flexmock("mock")
+    m.should_receive(op).and_return(:value)
+    assert_equal :value, block.call(m)
+  end
+
 end
 
 class TestFlexMockShouldsWithInclude < Test::Unit::TestCase

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.4
 specification_version: 1
 name: flexmock
 version: !ruby/object:Gem::Version 
-  version: 0.7.0
-date: 2007-09-01 00:00:00 -04:00
+  version: 0.7.1
+date: 2007-09-24 00:00:00 -04:00
 summary: Simple and Flexible Mock Objects for Testing
 require_paths: 
 - lib
@@ -86,6 +86,7 @@ files:
 - doc/releases/flexmock-0.6.3.rdoc
 - doc/releases/flexmock-0.6.4.rdoc
 - doc/releases/flexmock-0.7.0.rdoc
+- doc/releases/flexmock-0.7.1.rdoc
 test_files: []
 
 rdoc_options: 
@@ -110,6 +111,7 @@ extra_rdoc_files:
 - doc/releases/flexmock-0.6.3.rdoc
 - doc/releases/flexmock-0.6.4.rdoc
 - doc/releases/flexmock-0.7.0.rdoc
+- doc/releases/flexmock-0.7.1.rdoc
 executables: []
 
 extensions: []