baretest 0.1.0 → 0.2.3

data/test/{lib/test.rb → suite/lib/baretest.rb}

@@ -6,36 +6,36 @@
 
 
 
-Test.define "Test" do
+BareTest.suite "BareTest" do
   suite "::extender" do
     assert "Should return an Array" do
-      kind_of(Array, Test.extender)
+      kind_of(Array, ::BareTest.extender)
     end
   end
 
   suite "::format" do
     assert "Should return a Hash" do
-      kind_of(Hash, Test.format)
+      kind_of(Hash, ::BareTest.format)
     end
   end
 
   suite "::toplevel_suite" do
-    assert "Should return an instance of Test::Suite" do
-      kind_of(::Test::Suite, ::Test.toplevel_suite)
+    assert "Should return an instance of BareTest::Suite" do
+      kind_of(::BareTest::Suite, ::BareTest.toplevel_suite)
     end
 
-    assert "Should be used by Test::define" do
-      test = ::Test.clone # avoid interfering with the current run
+    assert "Should be used by BareTest::suite" do
+      test = ::BareTest.clone # avoid interfering with the current run
       test.init
       suites_before = test.toplevel_suite.suites.size
-      test.define "A new suite" do end
+      test.suite "A new suite" do end
       suites_after = test.toplevel_suite.suites.size
 
       equal(suites_before+1, suites_after)
     end
 
-    assert "Should be used by Test::run_if_mainfile" do
-      test = ::Test.clone # avoid interfering with the current run
+    assert "Should be used by BareTest::run_if_mainfile" do
+      test = ::BareTest.clone # avoid interfering with the current run
       test.init
       suites_before = test.toplevel_suite.suites.size
       test.run_if_mainfile "A new suite" do end
@@ -44,23 +44,23 @@ Test.define "Test" do
       equal(suites_before+1, suites_after)
     end
 
-    assert "Should be run by Test::run" do
+    assert "Should be run by BareTest::run" do
       this = self # needed because touch is called in the block of another assertion, so otherwise it'd be local to that assertion
-      test = ::Test.clone # avoid interfering with the current run
+      test = ::BareTest.clone # avoid interfering with the current run
       test.init
-      test.define "A new suite" do assert do this.touch(:assertion_executed) end end
+      test.suite "A new suite" do assert do this.touch(:assertion_executed) end end
       test.run
 
       touched(:assertion_executed)
     end
   end
 
-  suite "::define" do
-    assert "Should add the contained suites and asserts to Test::toplevel_suite" do
-      test = ::Test.clone # avoid interfering with the current run
+  suite "::suite" do
+    assert "Should add the contained suites and asserts to BareTest::toplevel_suite" do
+      test = ::BareTest.clone # avoid interfering with the current run
       test.init
       suites_before = test.toplevel_suite.suites.size
-      test.define "A new suite" do end
+      test.suite "A new suite" do end
       suites_after = test.toplevel_suite.suites.size
 
       equal(suites_before+1, suites_after)
@@ -71,14 +71,14 @@ Test.define "Test" do
     setup do
       ENV['FORMAT'] = 'minimal'
       @ruby      = File.join(Config::CONFIG['bindir'], Config::CONFIG['ruby_install_name'])
-      @test_path = Shellwords.escape(File.expand_path("#{__FILE__}/../../external/bootstraptest.rb"))
-      @wrap_path = Shellwords.escape(File.expand_path("#{__FILE__}/../../external/bootstrapwrap.rb"))
-      @inc_path  = Shellwords.escape(File.dirname(Test.required_file))
+      @test_path = Shellwords.escape(File.expand_path("#{__FILE__}/../../../external/bootstraptest.rb"))
+      @wrap_path = Shellwords.escape(File.expand_path("#{__FILE__}/../../../external/bootstrapwrap.rb"))
+      @inc_path  = Shellwords.escape(File.dirname(BareTest.required_file))
     end
 
     suite "File is the program" do
       assert "Should run the suite" do
-        IO.popen("#{@ruby} -I#{@inc_path} -rtest #{@test_path}") { |sio|
+        IO.popen("#{@ruby} -I#{@inc_path} -rbaretest #{@test_path}") { |sio|
           sio.read
         } =~ /\ATests:    1\nSuccess:  1\nPending:  0\nFailures: 0\nErrors:   0\nTime:     [^\n]+\nStatus:   success\n\z/
       end
@@ -86,7 +86,7 @@ Test.define "Test" do
 
     suite "File is not the program" do
       assert "Should not run the suite if the file is not the program" do
-        IO.popen("#{@ruby} -I#{@inc_path} -rtest #{@wrap_path}") { |sio|
+        IO.popen("#{@ruby} -I#{@inc_path} -rbaretest #{@wrap_path}") { |sio|
           sio.read
         } =~ /\ADone\n\z/
       end
@@ -94,11 +94,11 @@ Test.define "Test" do
   end
 
   suite "::run" do
-    assert "Should run Test's toplevel suite" do
+    assert "Should run BareTest's toplevel suite" do
       this = self # needed because touch is called in the block of another assertion, so otherwise it'd be local to that assertion
-      test = ::Test.clone # avoid interfering with the current run
+      test = ::BareTest.clone # avoid interfering with the current run
       test.init
-      test.define "A new suite" do assert do this.touch(:assertion_executed) end end
+      test.suite "A new suite" do assert do this.touch(:assertion_executed) end end
       test.run
 
       touched(:assertion_executed)
@@ -108,10 +108,10 @@ Test.define "Test" do
   suite "Skipped" do
     suite "Suite" do
       setup do
-        parent = ::Test::Suite.new
+        parent = ::BareTest::Suite.new
         parent.setup do end
         parent.teardown do end
-        @suite = ::Test::Skipped::Suite.new("None", parent)
+        @suite = ::BareTest::Skipped::Suite.new("None", parent)
         @suite.setup do end
         @suite.teardown do end
       end
@@ -144,36 +144,36 @@ Test.define "Test" do
         assert "Should add new skipped assertions to a suite." do
           equal(
             :expected => 0,
-            :actual   => @suite.tests.size,
+            :actual   => @suite.assertions.size,
             :message  => "number of defined tests before adding any"
           )
 
           @suite.assert "a"
           equal(
             :expected => 1,
-            :actual   => @suite.tests.size,
+            :actual   => @suite.skipped.size,
             :message  => "number of defined tests after adding one"
           )
 
           @suite.assert "b"
           equal(
             :expected => 2,
-            :actual   => @suite.tests.size,
+            :actual   => @suite.skipped.size,
             :message  => "number of defined tests after adding two"
           )
 
           equal_unordered(
             :expected => ['a', 'b'],
-            :actual   => @suite.tests.map { |child| child.description },
+            :actual   => @suite.skipped.map { |child| child.description },
             :message  => "the descriptions"
           )
 
-          @suite.tests.all? { |test| kind_of(::Test::Skipped::Assertion, test) }
+          @suite.skipped.all? { |test| kind_of(::BareTest::Skipped::Assertion, test) }
         end
 
         assert "Added tests should have the receiving suite as suite." do
           @suite.assert "a"
-          assertion = @suite.tests.first
+          assertion = @suite.skipped.first
 
           same(
             :expected => @suite,
@@ -188,7 +188,7 @@ Test.define "Test" do
       suite "#execute" do
         suite "Given a test that succeeds" do
           assert "Should have status :skipped" do
-            assertion = ::Test::Skipped::Assertion.new(nil, "") do true end
+            assertion = ::BareTest::Skipped::Assertion.new(nil, "") do true end
             assertion.execute
 
             equal(:skipped, assertion.status)
@@ -197,7 +197,7 @@ Test.define "Test" do
 
         suite "Given a test that is pending" do
           assert "Should have status :skipped" do
-            assertion = ::Test::Skipped::Assertion.new(nil, "")
+            assertion = ::BareTest::Skipped::Assertion.new(nil, "")
             assertion.execute
 
             equal(:skipped, assertion.status)
@@ -206,7 +206,7 @@ Test.define "Test" do
 
         suite "Given a test that fails" do
           assert "Should have status :skipped" do
-            assertion = ::Test::Skipped::Assertion.new(nil, "") do false end
+            assertion = ::BareTest::Skipped::Assertion.new(nil, "") do false end
             assertion.execute
 
             equal(:skipped, assertion.status)
@@ -215,7 +215,7 @@ Test.define "Test" do
 
         suite "Given a test that errors" do
           assert "Should have status :skipped" do
-            assertion = ::Test::Skipped::Assertion.new(nil, "") do raise end
+            assertion = ::BareTest::Skipped::Assertion.new(nil, "") do raise end
             assertion.execute
 
             equal(:skipped, assertion.status)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: baretest
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
+  version: 0.2.3
 platform: ruby
 authors: 
 - Stefan Rusterholz
@@ -9,59 +9,80 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-06-16 00:00:00 +02:00
+date: 2009-11-27 00:00:00 +01:00
 default_executable: 
 dependencies: []
 
-description: "Baretest is a Testframework that tries to stay out of your way, but support you when you want it. In order to do so it has a load of features:"
+description: |-
+  Baretest is a Testframework that tries to stay out of your way, but support
+  you when you want it. In order to do so it has a load of features:
 email: stefan.rusterholz@gmail.com
-executables: []
-
+executables: 
+- baretest
 extensions: []
 
 extra_rdoc_files: []
 
 files: 
+- LICENSE.txt
 - MANIFEST.txt
-- README.markdown
+- README.rdoc
 - bin/baretest
+- doc/baretest.rdoc
+- doc/mocking_stubbing_test_doubles.rdoc
+- doc/quickref.rdoc
+- doc/writing_tests.rdoc
+- examples/tests/irb_mode/failures.rb
+- examples/tests/mock_developer/test/helper/mocks.rb
+- examples/tests/mock_developer/test/setup.rb
+- examples/tests/mock_developer/test/suite/mock_demo.rb
+- examples/tests/overview/test.rb
+- examples/tests/variations/variations_01.rb
+- examples/tests/variations/variations_02.rb
+- examples/tests/variations/variations_03.rb
 - examples/test.rake
-- examples/test.rb
-- lib/test.rb
-- lib/test/assertion.rb
-- lib/test/assertion/failure.rb
-- lib/test/assertion/support.rb
-- lib/test/debug.rb
-- lib/test/irb_mode.rb
-- lib/test/run.rb
-- lib/test/run/cli.rb
-- lib/test/run/errors.rb
-- lib/test/run/interactive.rb
-- lib/test/run/minimal.rb
-- lib/test/run/spec.rb
-- lib/test/run/tap.rb
-- lib/test/run/xml.rb
-- lib/test/suite.rb
-- lib/test/version.rb
+- lib/baretest.rb
+- lib/baretest/assertion.rb
+- lib/baretest/assertion/context.rb
+- lib/baretest/assertion/failure.rb
+- lib/baretest/assertion/skip.rb
+- lib/baretest/assertion/support.rb
+- lib/baretest/irb_mode.rb
+- lib/baretest/layout.rb
+- lib/baretest/mocha.rb
+- lib/baretest/run.rb
+- lib/baretest/run/cli.rb
+- lib/baretest/run/errors.rb
+- lib/baretest/run/minimal.rb
+- lib/baretest/run/profile.rb
+- lib/baretest/run/spec.rb
+- lib/baretest/run/tap.rb
+- lib/baretest/run/xml.rb
+- lib/baretest/setup.rb
+- lib/baretest/skipped.rb
+- lib/baretest/skipped/assertion.rb
+- lib/baretest/skipped/suite.rb
+- lib/baretest/suite.rb
+- lib/baretest/utilities.rb
+- lib/baretest/version.rb
 - test/external/bootstraptest.rb
 - test/external/bootstrapwrap.rb
 - test/helper/mocks.rb
-- test/lib/test.rb
-- test/lib/test/assertion.rb
-- test/lib/test/assertion/support.rb
-- test/lib/test/debug.rb
-- test/lib/test/irb_mode.rb
-- test/lib/test/run.rb
-- test/lib/test/run/cli.rb
-- test/lib/test/run/errors.rb
-- test/lib/test/run/interactive.rb
-- test/lib/test/run/spec.rb
-- test/lib/test/run/tap.rb
-- test/lib/test/run/xml.rb
-- test/lib/test/suite.rb
 - test/setup.rb
+- test/suite/lib/baretest.rb
+- test/suite/lib/baretest/assertion.rb
+- test/suite/lib/baretest/assertion/support.rb
+- test/suite/lib/baretest/irb_mode.rb
+- test/suite/lib/baretest/run.rb
+- test/suite/lib/baretest/run/cli.rb
+- test/suite/lib/baretest/run/errors.rb
+- test/suite/lib/baretest/run/interactive.rb
+- test/suite/lib/baretest/run/spec.rb
+- test/suite/lib/baretest/run/tap.rb
+- test/suite/lib/baretest/run/xml.rb
+- test/suite/lib/baretest/suite.rb
 has_rdoc: true
-homepage: http://
+homepage: http://baretest.rubyforge.org
 licenses: []
 
 post_install_message: 
@@ -73,7 +94,7 @@ rdoc_options:
 - --tab-width
 - "2"
 - -t
-- baretest-#<Proc:0x00539b20@/Users/Shared/Development/Gems/baretest/rake/lib/silverplatter/project/bonesplitter.rb:60> Documentation
+- baretest-0.2.3 Documentation
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -91,9 +112,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: baretest
-rubygems_version: 1.3.3
+rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
-summary: "A minimal Testframework. Three methods to use it, Twenty to master it, about hundred lines of code1. Bare Test, try it and you\xE2\x80\x99ll love it."
+summary: "A testframework that doesn\xE2\x80\x99t stand in your way or forces you to learn a new language. Two methods is all that is required to know."
 test_files: []
 

data/README.markdown

@@ -1,229 +0,0 @@
-Bare Test
-=========
-
-
-
-Summary
--------
-
-A minimal Testframework.
-Three methods to use it, Twenty to master it, about hundred lines of code[1].
-Bare Test, try it and you'll love it.
-
-
-
-Description
------------
-
-Baretest is a Testframework that tries to stay out of your way, but support you when you want it.
-In order to do so it has a load of features:
-
-* Strightforward and terse assertions (just a block whose return value defines
-  success/failure)
-* Easy grouping of assertions into suites
-* BDD style specifications/test descriptions (NOT code), also extractable
-* Uncomplicated dependency testing and skipping
-* Helpers to deal painlessly with raising, throwing, float imprecision,
-  unordered collections etc.
-* Ships with colored Shell formatter, Diagnostic-, Interactive-, XML- and TAP
-  formatter
-* Interactive formatter - drops you into an irb session within failed assertion
-  with all setup methods executed, so you can inspect interactively why it
-  failed.
-* Trivial to add new formatters (the standard formatters are only roughly 20-50
-  lines of code each)
-* Teardown and Setup for suites
-* Callbacks to integrate mock libraries
-* API to use it from code, such as rake tasks (comes with an example rake-task)
-* baretest executable to run tests on multiple files at once
-* Diagnostic assertion helpers (e.g. same(:a, :b) will give you 'Expected
-  :a but got :b' as diagnostic)
-
-
-
-Quick Try
----------
-
-1. Download from github and unpack (or clone)
-2. Change into the baretest directory: `cd the/baretest/directory`
-3. Run the examples: `./bin/baretest examples/test.rb`
-
-That's it. Alternatively you can run baretests own tests, and play with formatters:
-`./bin/baretest -f tap`
-
-Unfortunately the installer and gem installer aren't ready yet.
-
-
-
-Executable
-----------
-
-    Usage: baretest [options] [glob, ...]
-    Glob defaults to 'test/**/*.rb'
-    Providing a directory as glob is equivalent to dir/**/*.rb
-    Options:
-      -f, --format FORMAT      use FORMAT for output
-      -F, --formats            show available formats
-      -d, --debug              set debugging flags (set $DEBUG to true)
-      -i, --interactive        drop into IRB on error or failure
-      -s, --setup FILE         specify setup file
-      -v, --version            print the version and exit
-      -w, --warn               turn warnings on for your script
-
-
-
-Planned Features
-----------------
-
-* --fail-all flag, to test/review diagnostics of tests
-* Word-wrapping for CLI runner
-* Flags for color and verbose (\[no-]color and \[no-]verbose) for the executable
-* Passing on flags/options for formatters
-* Alternative CLI runner with status implicit via colored/bg-colored descriptions
-* Alternative CLI runner which prints the name of the test prior the label and rewrites
-  the line when the test has executed to add status & coloring.
-* Simple stubbing with automatic cleanup at teardown. Example:
-
-        assert "Should require a single file listed in :requires option." do |a|
-          file = 'foo/bar'
-          stub(Kernel, :require) do |file, *args| a.touch(file) end
-          ::Test::Suite.create(nil, nil, :requires => file)
-        
-          touched file
-        end
-
-* Inline tests via Module#describe (basically the same as Test::Suite#suite)
-* YARD code to extract the specifications without running the code
-* A redmine plugin
-
-
-
-Rejected Features
------------------
-
-* Currently none
-
-
-A Bit of Background
--------------------
-
-Originally, bare-test started out as a project for shits & giggles on the flight
-back from vegas (railsconf09), to prove that it is possible to have a fully
-fledged test-framework in under 100 lines of source-code.
-Later I realized that this project could become more. For one it was (still is)
-dead simple to add another formatter, it is just as dead simple to embedd it
-in code.
-The principles are trivial to understand, embrace and extend.
-Upon that it dawned me, that the project was viable and I began adding features
-not found in other projects.
-
-
-
-Example Testsuite
------------------
-
-From examples/test.rb:
-
-    Test.run_if_mainfile do
-      # assertions and refutations can be grouped in suites. They will share
-      # setup and teardown
-      # they don't have to be in suites, though
-      suite "Success" do
-        assert "An assertion returning a trueish value (non nil/false) is a success" do
-          true
-        end
-      end
-
-      suite "Failure" do
-        assert "An assertion returning a falsish value (nil/false) is a failure" do
-          false
-        end
-      end
-
-      suite "Pending" do
-        assert "An assertion without a block is pending"
-      end
-
-      suite "Error" do
-        assert "Uncaught exceptions in an assertion are an error" do
-          raise "Error!"
-        end
-      end
-
-      suite "Special assertions" do
-        assert "Assert a block to raise" do
-          raises do
-            sleep(rand()/3+0.05)
-            raise "If this raises then the assertion is a success"
-          end
-        end
-
-        assert "Assert a float to be close to another" do
-          a = 0.18 - 0.01
-          b = 0.17
-          within_delta a, b, 0.001
-        end
-
-        suite "Nested suite" do
-          assert "Assert two randomly ordered arrays to contain the same values" do
-            a = [*"A".."Z"] # an array with values from A to Z
-            b = a.sort_by { rand }
-            a.equal_unordered(b) # can be used with any Enumerable, uses hash-key identity
-          end
-        end
-      end
-
-      suite "Setup & Teardown" do
-        setup do
-          @foo = "foo"
-          @bar = "bar"
-        end
-
-        assert "@foo should be set" do
-          @foo == "foo"
-        end
-
-        suite "Nested suite" do
-          setup do
-            @bar = "inner bar"
-            @baz = "baz"
-          end
-
-          assert "@foo is inherited" do
-            @foo == "foo"
-          end
-
-          assert "@bar is overridden" do
-            @bar == "inner bar"
-          end
-
-          assert "@baz is defined only for inner" do
-            @baz == "baz"
-          end
-        end
-
-        teardown do
-          @foo = nil # not that it'd make much sense, just to demonstrate
-        end
-      end
-
-      suite "Dependencies", :requires => ['foo', 'bar'] do
-        assert "Will be skipped, due to unsatisfied dependencies" do
-          raise "This code therefore will never be executed"
-        end
-      end
-    end
-
-
-
-Known bugs
-----------
-
-* touch/touched have to clean up after every Assertion#execute. Should use the mock hooks.
-
-
-
-Foot Notes
-----------
-[1]: "" The abbreviated form without support code and output formatters.
-        The normal code is expanded to more lines for readability.

data/examples/test.rb

@@ -1,93 +0,0 @@
-require 'test'
-
-
-
-Test.run_if_mainfile do
-	# assertions and refutations can be grouped in suites. They will share
-	# setup and teardown
-	# they don't have to be in suites, though
-	suite "Success" do
-		assert "An assertion returning a trueish value (non nil/false) is a success" do
-			true
-		end
-	end
-
-	suite "Failure" do
-		assert "An assertion returning a falsish value (nil/false) is a failure" do
-			false
-		end
-	end
-
-	suite "Pending" do
-		assert "An assertion without a block is pending"
-	end
-
-	suite "Error" do
-		assert "Uncaught exceptions in an assertion are an error" do
-			raise "Error!"
-		end
-	end
-
-	suite "Special assertions" do
-		assert "Assert a block to raise" do
-			raises do
-				sleep(rand()/3+0.05)
-				raise "If this raises then the assertion is a success"
-			end
-		end
-
-		assert "Assert a float to be close to another" do
-			a = 0.18 - 0.01
-			b = 0.17
-			within_delta a, b, 0.001
-		end
-
-		suite "Nested suite" do
-			assert "Assert two randomly ordered arrays to contain the same values" do
-				a = [*"A".."Z"] # an array with values from A to Z
-				b = a.sort_by { rand }
-				equal_unordered(a, b) # can be used with any Enumerable, uses hash-key identity
-			end
-		end
-	end
-
-	suite "Setup & Teardown" do
-		setup do
-			@foo = "foo"
-			@bar = "bar"
-		end
-
-		assert "@foo should be set" do
-			@foo == "foo"
-		end
-
-		suite "Nested suite" do
-			setup do
-				@bar = "inner bar"
-				@baz = "baz"
-			end
-
-			assert "@foo is inherited" do
-				@foo == "foo"
-			end
-
-			assert "@bar is overridden" do
-				@bar == "inner bar"
-			end
-
-			assert "@baz is defined only for inner" do
-				@baz == "baz"
-			end
-		end
-
-		teardown do
-			@foo = nil # not that it'd make much sense, just to demonstrate
-		end
-	end
-
-	suite "Dependencies", :requires => ['foo', 'bar'] do
-		assert "Will be skipped, due to unsatisfied dependencies" do
-			failure "Why the heck do you have a 'foo/bar' file?"
-		end
-	end
-end