mac_bacon 1.1.21

data/COPYING

@@ -0,0 +1,18 @@
+Copyright (c) 2007, 2008 Christian Neukirchen <purl.org/net/chneukirchen>
+
+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 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/ChangeLog

@@ -0,0 +1,272 @@
+Mon Jan 10 22:43:37 2011 +0100  Eloy Duran <eloy.de.enige@gmail.com>
+  * Create MacBacon fork that works in a NSRunloop based environment. I.e. MacRuby/Objectove-C.
+
+Wed Apr 14 05:40:31 2010 -0400  Gabriel Horner <gabriel.horner@gmail.com>
+  * Indent nested contexts for SpecDoxOutput
+    Based on similar patch from http://github.com/wvl/bacon/commit/af940dbeb789f5eef2d998e227e5425d
+
+Mon Mar 29 14:06:47 2010 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Merge remote branch 'cldwalker/timer'
+
+Sun Mar 28 23:16:49 2010 -0400  Gabriel Horner <gabriel.horner@gmail.com>
+  * give TestUnitOutput the same timer that Test::Unit has
+
+Sat Mar 20 04:19:18 2010 -0400  Gabriel Horner <gabriel.horner@gmail.com>
+  * methods in a context should serve as behavior that is inherited by sibling contexts
+
+Sun Jan 17 12:17:42 2010 -0800  Eoin Hennessy <eoin@randomrules.org>
+  * Add support for finding specs with RSpec style naming.
+
+Tue Sep 22 21:17:55 2009 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add ChangeLog as gem dependency
+    reported by lian
+
+Mon Aug 31 23:36:56 2009 +0200  Eloy Duran <eloy.de.enige@gmail.com>
+  * Revert old change that was made because 1.9.0 couldn't rescue a splatted array of Exception classes. MacRuby currently can't use when with the same array and 1.9.2dev does.
+    
+    Also some other minor changes which didn't work currently on 1.9.2dev, but are nicer anyway imo.
+
+Thu Jan 22 06:07:53 2009 +0000  Anna Gabutero <amdg@lavabit.com>
+  * Add libs to include path when invoking Test::Unit
+
+Sun Jan 11 14:41:01 2009 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Update homepage
+
+Sat Jan 10 14:01:30 2009 -0800  Christian Neukirchen <chneukirchen@gmail.com>
+  * Allow negated nontrue values outside specs
+
+Sat Jan 10 13:44:14 2009 -0800  Ian Dees <undees@gmail.com>
+  * Added test for nontrue values outside specs
+
+Sun Nov 30 11:14:31 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Push VERSION to 1.1
+
+Sun Nov 30 11:13:33 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Last fixes
+
+Sun Nov 30 11:06:09 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Update README
+
+Sun Nov 30 11:00:28 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add Knock output
+
+Sat Oct 25 12:30:00 2008 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * De-metaprogram and document nested before/after
+
+Fri Oct 24 17:20:17 2008 -0500  Yossef Mendelssohn <ymendel@pobox.com>
+  * Having higher-level after blocks also be run for nested contexts.
+
+Fri Oct 24 17:14:30 2008 -0500  Yossef Mendelssohn <ymendel@pobox.com>
+  * Cleaning up setting of nested before blocks
+
+Fri Oct 24 17:09:42 2008 -0500  Yossef Mendelssohn <ymendel@pobox.com>
+  * Ensuring that nested before blocks are run in the correct order
+
+Fri Oct 24 17:06:18 2008 -0500  Yossef Mendelssohn <ymendel@pobox.com>
+  * Ensuring that before blocks don't bleed into sibling levels
+
+Fri Oct 24 17:01:51 2008 -0500  Yossef Mendelssohn <ymendel@pobox.com>
+  * Letting before blocks be run from higher levels in nested context
+    
+    Split up Context#initialize to let running be a separate step.
+    Added attr_reader for Context name and block to let the running step have access
+    to them without resorting to instance variables.
+
+Sat Oct 4 13:38:23 2008 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Move to git
+
+Sun Aug 17 13:32:40 2008 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add option to disable backtraces
+
+Sun Aug 17 12:48:29 2008 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Don't %-expand twice in TAP output
+
+Fri Aug 1 12:01:28 2008 +0200  jftucker <jftucker@gmail.com>
+  * pols-for-at-exit
+    
+    Added an alias for summary_on_exit to summary_at_exit to save on POLS for some people (me!).
+
+Sun Jul 6 18:47:42 2008 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add bacon_rspec.rb to avoid errors when .bacon doesn't exist
+
+Sun Jul 6 18:05:13 2008 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Push VERSION to 1.0
+
+Sun Jul 6 18:04:55 2008 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Small reformatting
+
+Sun Jul 6 18:04:41 2008 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Update README
+
+Sun Jul 6 18:03:51 2008 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Allow 50 lines more code
+
+Sun Jul 6 17:46:07 2008 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Suppress warnings when the suite loads Bacon again
+
+Wed Jun 25 13:56:34 2008 +0200  jftucker <jftucker@gmail.com>
+  * support spec/test subdirs for -a
+
+Wed Jun 25 13:20:29 2008 +0200  jftucker <jftucker@gmail.com>
+  * support mappings for subdirs in autotest
+
+Wed Jun 25 00:27:08 2008 +0200  jftucker <jftucker@gmail.com>
+  * adding autotest support
+    
+    The autotest auto discovery uses bacons test/unit output.
+    It does not currently call specific examples (TODO).
+    It currently attempts to fix the rspec auto discovery by removing it if it
+    finds a .bacon under test/ or spec/. In fact, these are the only conditions
+    under which the bacon autotest will load.
+
+Thu Mar 13 04:00:42 2008 +0100  Michael Fellinger m.fellinger@gmail.com <chneukirchen@gmail.com>
+  * Show exception instead of missing error if a spec is empty because of it.
+
+Sun Mar 2 11:52:38 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Call after-blocks even if before-blocks or spec raise exceptions
+    
+    Based on a patch by Keita Yamaguchi
+
+Sun Mar 2 11:52:09 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Count failed requirements too
+
+Sun Feb 10 18:45:24 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Reformats
+
+Sun Feb 10 18:42:32 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Empty specifications are now erroneous
+
+Sun Feb 10 14:49:58 2008 +0100  Michael Fellinger <m.fellinger@gmail.com>
+  * Improve require for lib/bacon
+
+Wed Jan 23 23:59:40 2008 +0100  rff.rff <rff.rff@gmail.com>
+  * allows multiple arguments to #describe to allow specialized behaviours such as
+    
+     describe Queue,'empty'
+     describe Queue,'full'
+    
+    Some tests for this and manveru's latest patch are included
+
+Sat Jan 19 23:07:25 2008 +0100  Michael Fellinger <m.fellinger@gmail.com>
+  * #to_s the argument to describe
+
+Fri Jan 18 15:25:27 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Flunk if there are no arguments to #it
+
+Mon Jan 14 01:34:44 2008 +0100  rff.rff <rff.rff@gmail.com>
+  * add should('foo') shortcut for it('should foo')
+
+Mon Jan 7 20:24:04 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Last minute
+
+Mon Jan 7 20:21:43 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Update copyright
+
+Mon Jan 7 20:08:40 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Tighten code
+
+Mon Jan 7 19:33:39 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Update README
+
+Mon Jan 7 19:33:25 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add bacon -o FORMAT
+
+Mon Jan 7 19:33:07 2008 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Improve TAP output
+
+Mon Dec 31 19:01:49 2007 +0100  Michael Fellinger <m.fellinger@gmail.com>
+  * behaves_like should take multiple names
+
+Sun Dec 30 19:38:18 2007 +0100  Michael Fellinger <m.fellinger@gmail.com>
+  * Adding Proc#change? to check for changes on repeated calling of proc.
+
+Fri Dec 28 12:42:04 2007 +0100  Michael Fellinger <m.fellinger@gmail.com>
+  * Patching for ruby 1.9.0 and removing useless spaces
+
+Wed Dec 5 14:56:51 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Make code nicer
+
+Wed Dec 5 14:48:06 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Fix Rakefile
+
+Wed Dec 5 14:46:32 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Integrate Rakefile
+
+Wed Dec 5 14:43:26 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add Rakefile
+
+Wed Dec 5 14:41:53 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add README
+
+Wed Dec 5 14:41:26 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add copyright
+
+Wed Dec 5 14:18:54 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Move #close? to Numeric
+
+Wed Dec 5 14:11:34 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add flunking
+
+Wed Dec 5 13:42:13 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Allow using Object#should outside of contexts providing boolean return
+
+Wed Dec 5 13:41:00 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Move summary outputter to lib/bacon.rb
+
+Wed Dec 5 13:26:27 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Fix output of summary
+
+Wed Dec 5 13:26:16 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add identical_to/same_as
+
+Wed Dec 5 02:12:24 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Remove debugging statements
+
+Wed Dec 5 02:00:03 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Refactor tests
+
+Wed Dec 5 01:58:08 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Test Context#should.{throw,raise}
+
+Wed Dec 5 01:56:29 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add should.throw
+
+Wed Dec 5 01:49:33 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Implement -n and -t for filtering on context/specification names
+
+Wed Dec 5 01:41:56 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add shared contexts
+
+Wed Dec 5 01:41:39 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Make directives belong to Kernel and private
+
+Wed Dec 5 01:41:17 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Clear up error reporting
+
+Wed Dec 5 01:23:27 2007 +0100  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add TAP generator
+
+Thu May 31 14:32:48 2007 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Set correct $?
+
+Thu May 31 14:28:35 2007 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add Test::Unit-like output (-q)
+
+Thu May 31 14:18:00 2007 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Add standalone runner, bin/bacon
+
+Thu May 31 14:17:40 2007 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Import test-suite
+
+Thu May 31 14:17:05 2007 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Fix for testsuite
+
+Thu May 31 14:16:25 2007 +0200  Christian Neukirchen <chneukirchen@gmail.com>
+  * Fix output
+
+Wed May 30 17:50:23 2007 +0200  Christian Neukirchen <chneukirchen��@gmail.com>
+  * Externalize spec/req handling
+
+Wed May 30 17:32:15 2007 +0200  Christian Neukirchen <chneukirchen��@gmail.com>
+  * Import Bacon, a small spec framework
+

data/RDOX

@@ -0,0 +1,96 @@
+Bacon
+  - should have should.satisfy
+  - should have should.equal
+  - should have should.raise
+  - should have should.raise with a block
+  - should have a should.raise should return the exception
+  - should have should.be.an.instance_of
+  - should have should.be.nil
+  - should have should.include
+  - should have should.be.a.kind_of
+  - should have should.match
+  - should have should.not.raise
+  - should have should.throw
+  - should have should.not.satisfy
+  - should have should.not.equal
+  - should have should.not.match
+  - should have should.be.identical_to/same_as
+  - should have should.respond_to
+  - should have should.be.close [FAILED]
+  - should support multiple negation
+  - should have should.<predicate>
+  - should have should <operator> (>, >=, <, <=, ===)
+  - should allow for custom shoulds
+  - should have should.flunk
+
+before/after
+  - should run in the right order
+  - should not run from lower level
+
+when nested
+  - should run from higher level
+  - should run at the nested level
+  - should run in the right order
+
+when nested at a sibling level
+  - should not run from sibling level
+
+shared/behaves_like
+  - gets called where it is included
+  - raises NameError when the context is not found
+  - gets called where it is included
+  - can access data
+
+Methods
+  - should be accessible in a test
+
+when in a sibling context
+  - should be accessible in a test
+
+describe arguments
+  - should work with string
+  - should work with symbols
+  - should work with modules
+  - should work with namespaced modules
+  - should work with multiple arguments
+
+NSRunloop aware Bacon
+  - allows the user to postpone execution of a block for n seconds, which will halt any further execution of specs
+
+A non-true value
+  - should pass negated tests inside specs
+  - should pass negated tests outside specs
+
+#should shortcut for #it('should')
+  - should be called
+  - should save some characters by typing should
+  - should save characters even on failure
+  - should work nested
+  - should add new specifications
+  - should have been called
+
+string
+
+behaviour
+
+Bacon
+
+Bacon::Context
+
+Bacon::Context empty
+
+Bacon::Error: not #<Proc:0x20055dc20 (lambda)>.raise?(Bacon::Error) failed
+	/Users/eloy/Documents/DEVELOPMENT/MacBacon/lib/mac_bacon.rb:425:in `satisfy': Bacon - should have should.be.close
+	/Users/eloy/Documents/DEVELOPMENT/MacBacon/lib/mac_bacon.rb:439:in `method_missing:'
+	/Users/eloy/Documents/DEVELOPMENT/MacBacon/test/spec_bacon.rb:9:in `block'
+	/Users/eloy/Documents/DEVELOPMENT/MacBacon/lib/mac_bacon.rb:422:in `satisfy'
+	/Users/eloy/Documents/DEVELOPMENT/MacBacon/lib/mac_bacon.rb:408:in `an:'
+	/Users/eloy/Documents/DEVELOPMENT/MacBacon/lib/mac_bacon.rb:374:in `should:'
+	/Users/eloy/Documents/DEVELOPMENT/MacBacon/test/spec_bacon.rb:182:in `block'
+	/Users/eloy/Documents/DEVELOPMENT/MacBacon/lib/mac_bacon.rb:157:in `block'
+	/Users/eloy/Documents/DEVELOPMENT/MacBacon/lib/mac_bacon.rb:194:in `execute_block'
+	/Users/eloy/Documents/DEVELOPMENT/MacBacon/lib/mac_bacon.rb:153:in `run'
+	/Users/eloy/Documents/DEVELOPMENT/MacBacon/lib/mac_bacon.rb:233:in `run'
+	/Users/eloy/Documents/DEVELOPMENT/MacBacon/bin/macbacon:118:in `<main>'
+
+49 specifications (375 requirements), 1 failures, 0 errors

data/README

@@ -0,0 +1,324 @@
+= MacBacon -- small RSpec clone.
+
+   "Truth will sooner come out from error than from confusion."
+                                               ---Francis Bacon
+
+Bacon is a small RSpec clone weighing less than 350 LoC but
+nevertheless providing all essential features.
+
+This MacBacon fork is created and maintained by Eloy Durán (@alloy).
+It differs with regular Bacon in that it operates properly in a
+NSRunloop based environment. I.e. MacRuby/Objective-C. See the
+paragraph about the `wait` command for more info.
+
+== Whirl-wind tour
+
+    require 'mac_bacon'
+    
+    describe 'A new array' do
+      before do
+        @ary = Array.new
+      end
+      
+      it 'should be empty' do
+        @ary.should.be.empty
+        @ary.should.not.include 1
+      end
+    
+      it 'should have zero size' do
+        @ary.size.should.equal 0
+        @ary.size.should.be.close 0.1, 0.5
+      end
+    
+      it 'should raise on trying fetch any index' do
+        lambda { @ary.fetch 0 }.
+          should.raise(IndexError).
+          message.should.match(/out of array/)
+    
+        # Alternatively:
+        should.raise(IndexError) { @ary.fetch 0 }
+      end
+    
+      it 'should have an object identity' do
+        @ary.should.not.be.same_as Array.new
+      end
+    
+      it 'should perform a long running operation' do
+        @ary.performSelector("addObject:", withObject:"soup", afterDelay:0.5)
+        wait 0.6 do
+          @ary.size.should.be 1
+        end
+      end
+    
+      # Custom assertions are trivial to do, they are lambdas returning a
+      # boolean vale:
+      palindrome = lambda { |obj| obj == obj.reverse }
+      it 'should be a palindrome' do
+        @ary.should.be.a palindrome
+      end
+    
+      it 'should have super powers' do
+        should.flunk "no super powers found"
+      end
+    end
+
+Now run it:
+
+    $ macbacon whirlwind.rb
+    A new array
+      - should be empty
+      - should have zero size
+      - should raise on trying fetch any index
+      - should have an object identity
+      - should perform a long running operation
+      - should be a palindrome
+      - should have super powers [MISSING]
+
+    Bacon::Error: no super powers found
+    	./whirlwind.rb:44:in `block': A new array - should have super powers
+
+    Bacon::Error: empty specification: A new array should have super powers
+
+    7 specifications (10 requirements), 1 failures, 0 errors
+
+If you want shorter output, use the Test::Unit format:
+
+    $ macbacon -q whirlwind.rb
+    ......F
+    Bacon::Error: no super powers found
+    	./whirlwind.rb:39: A new array - should have super powers
+    	./whirlwind.rb:38
+    	./whirlwind.rb:3
+    
+    7 tests, 10 assertions, 1 failures, 0 errors
+
+It also supports TAP:
+
+    $ macbacon -p whirlwind.rb
+    ok 1        - should be empty
+    ok 2        - should have zero size
+    ok 3        - should raise on trying fetch any index
+    ok 4        - should have an object identity
+    ok 5        - should be a palindrome
+    ok 6        - should perform a long running operation
+    not ok 7    - should have super powers: FAILED
+    # Bacon::Error: no super powers found
+    # 	./whirlwind.rb:44: A new array - should have super powers
+    1..7
+    # 7 tests, 10 assertions, 1 failures, 0 errors
+
+    $ macbacon -p whirlwind.rb | taptap -q
+    Tests took 0.00 seconds.
+    FAILED tests 7
+       7) should have super powers: FAILED
+
+    Failed 1/7 tests, 83.33% okay.
+
+(taptap is available from http://chneukirchen.org/repos/taptap/)
+
+As of Bacon 1.1, it also supports Knock:
+
+    $ macbacon -k whirlwind.rb
+    ok - should be empty
+    ok - should have zero size
+    ok - should raise on trying fetch any index
+    ok - should have an object identity
+    ok - should be a palindrome
+    ok - should perform a long running operation
+    not ok - should have super powers: FAILED
+    # Bacon::Error: no super powers found
+    # 	./whirlwind.rb:4: A new array - should have super powers
+
+    $ bacon -k whirlwind.rb | kn-sum
+    7 tests, 1 failed (83.3333% succeeded)
+
+(knock is available from http://github.com/chneukirchen/knock/)
+
+
+== Implemented assertions
+
+* should.<predicate> and should.be.<predicate>
+* should.equal
+* should.match
+* should.be.identical_to / should.be.same_as
+* should.raise(*exceptions) { }
+* should.change { }
+* should.throw(symbol) { }
+* should.satisfy { |object| }
+
+
+== Added core predicates
+
+* Object#true?
+* Object#false?
+* Proc#change?
+* Proc#raise?
+* Proc#throw?
+* Numeric#close?
+
+
+== before/after
+
+before and after need to be defined before the first specification in
+a context and are run before and after each specification.
+
+As of Bacon 1.1, before and after do nest in nested contexts.
+
+
+== Shared contexts
+
+You can define shared contexts in Bacon like this:
+
+    shared "an empty container" do
+      it "should have size zero" do
+      end
+
+      it "should be empty" do
+      end
+    end
+
+    context "A new array" do
+      behaves_like "an empty container"
+    end
+
+These contexts are not executed on their own, but can be included with
+behaves_like in other contexts.  You can use shared contexts to
+structure suites with many recurring specifications.
+
+
+== Matchers
+
+Custom matchers are simply lambdas returning a boolean value, for
+example:
+
+  def shorter_than(max_size)
+    lambda { |obj| obj.size < max_size }
+  end
+
+  [1,2,3].should.be shorter_than(5)
+
+You can use modules and extend to group matchers for use in multiple
+contexts.
+
+
+== wait
+
+Often in Objective-C apps, code will *not* execute immediately, but
+scheduled on a runloop for later execution. Therefor a mechanism is
+needed that will postpone execution of some assertions for a period of
+time. This is where the `wait` macro comes in:
+
+      it 'should perform a long running operation' do
+        # Here a method call is scheduled to be performed ~0.5 seconds in the future
+        @ary.performSelector("addObject:", withObject:"soup", afterDelay:0.5)
+        wait 0.6 do
+          # This block is executed ~0.6 seconds in the future
+          @ary.size.should.be 1
+        end
+      end
+
+The postponed block does *not* halt the thread, but is scheduled on
+the runloop as well. This means that your runloop based code will have
+a chance to perform its job before the assertions in the block are
+executed.
+
+You can schedule as many blocks as you’d want and even nest them.
+
+
+== bacon standalone runner
+
+  -s, --specdox            do AgileDox-like output (default)
+  -q, --quiet              do Test::Unit-like non-verbose output
+  -p, --tap                do TAP (Test Anything Protocol) output
+  -k, --knock              do Knock output
+  -o, --output FORMAT      do FORMAT (SpecDox/TestUnit/Tap) output
+  -Q, --no-backtrace       don't print backtraces  
+  -a, --automatic          gather tests from ./test/, include ./lib/
+  -n, --name NAME          runs tests matching regexp NAME
+  -t, --testcase TESTCASE  runs tests in TestCases matching regexp TESTCASE
+
+
+== Object#should
+
+You can use Object#should outside of contexts, where the result of
+assertion will be returned as a boolean.  This is nice for
+demonstrations, quick checks and doctest tests.
+
+    >> require 'mac_bacon'
+    >> (1 + 1).should.equal 2
+    => true
+    >> (6*9).should.equal 42
+    => false
+
+
+== Converting specs
+
+spec-converter is a simple tool to convert test-unit or dust style
+tests to test/spec specs.
+
+It can be found at http://opensource.thinkrelevance.com/wiki/spec_converter.
+
+
+== Thanks to
+
+* Michael Fellinger, for fixing Bacon for 1.9 and various improvements.
+* Gabriele Renzi, for implementing Context#should.
+* James Tucker, for the autotest support.
+* Yossef Mendelssohn, for nested contexts.
+* everyone contributing bug fixes.
+
+
+== History
+
+* January 7, 2008: First public release 0.9.
+
+* July 6th, 2008: Second public release 1.0.
+  * Add Context#should as a shortcut for Context#it('should ' + _).
+  * describe now supports multiple arguments for better organization.
+  * Empty specifications are now erroneous.
+  * after-blocks run in the case of exceptions too.
+  * Autotest support.
+  * Bug fixes.
+
+* November 30th, 2008: Third public release 1.1.
+  * Nested before/after.
+  * Add -Q/--no-backtraces to not show details about failed specifications.
+  * Add Knock output.
+  * Bug fixes.
+
+* January 10th, 2011: MacBacon fork release 1.1
+  * Make it work in a NSRunloop environment
+  * Add `wait'
+  * Remove extras, for now
+
+== Contact
+
+Please mail bugs, suggestions and patches for Bacon to
+<mailto:chneukirchen@gmail.com>
+
+Git repository (patches rebased on HEAD are most welcome):
+https://github.com/chneukirchen/bacon
+git://github.com/chneukirchen/bacon.git
+
+For MacBacon contact
+<mailto:eloy.de.enige@gmail.com>
+
+And repository location:
+https://github.com/alloy/MacBacon
+git://github.com/alloy/MacBacon.git
+
+== Copying
+
+Copyright (C) 2007, 2008 Christian Neukirchen <purl.org/net/chneukirchen>
+
+Bacon is freely distributable under the terms of an MIT-style license.
+See COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+
+== Links
+
+Behavior-Driven Development:: <http://behaviour-driven.org/>
+RSpec:: <http://rspec.rubyforge.org/>
+test/spec:: <http://test-spec.rubyforge.org/>
+
+Christian Neukirchen:: <http://chneukirchen.org/>