minitest-given 3.0.0.beta.3 → 3.0.0.beta.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 415321f18ce3e534a5966a0c63591feee1f2e0cb
-  data.tar.gz: db077329d1a26df30dd4f1b1ef3a7af1e1800dc1
+  metadata.gz: 669e03394bda8c007546ee125f5df18d2290be83
+  data.tar.gz: 6282eed5233e6c6a5a044e91536475778ab93065
 SHA512:
-  metadata.gz: f4ae26247a55cfea57487820e29ac289285f84943f430564c3857283e31c639794bc55d124653d87e69d6db150a33e6924dd008bc781a930527dfb132d8c5027
-  data.tar.gz: bd5a8fa7ff59635edf22d8d917afa3f1e4a243be44eae2b51bc51f0e05bc7bc226f034b06e9b0eafaa5dc5cf008b49ac2c0feae0d749d69210aed5661a39fecb
+  metadata.gz: b6327e8424e6d1a79138cb62c3d8a26f65fd37f62ff919a016ba32e5b80c14816a8c3aacbe3fbe6c58ba0cb3717029aaa280b1b0d467022bedf45a7e2ad4e974
+  data.tar.gz: cc526134b165db9db94534b9e02c643f0c942fe877e2bf000fc5c46fad9b6836bba58f804603c13c254ab16504c3d00a77e822a902dec7888023b05282ecf93e

data/README.md

@@ -1,4 +1,4 @@
-# rspec-given
+# Given/When/Then for RSpec and Minitest
 
 | Master |
 | :----: |
@@ -28,7 +28,7 @@ The rspec-given gem is the original given/when/then extension for
 RSpec. It now depends on a given_core gem for the basic functionality
 and then adds the RSpec specific code.
 
-* rspec-given now require RSpec version 2.12 or better.
+* rspec-given now requires RSpec version 2.12 or better.
 
 ### Minitest/Given
 
@@ -58,7 +58,7 @@ things to watch out for:
 
 ### Auto Selecting
 
-If you exclusively use natural assertions in your specs, it's quite
+If you use natural assertions exclusively in your specs, it's quite
 possible to write specs that run under both RSpec and Minitest::Spec.
 
 Use this at the start of your spec file:
@@ -94,22 +94,22 @@ describe Stack do
   end
 
   Given(:stack) { stack_with(initial_contents) }
-  Invariant { stack.empty?.should == (stack.depth == 0) }
+  Invariant { stack.empty? == (stack.depth == 0) }
 
   context "with no items" do
     Given(:initial_contents) { [] }
-    Then { stack.depth.should == 0 }
+    Then { stack.depth == 0 }
 
     context "when pushing" do
       When { stack.push(:an_item) }
 
-      Then { stack.depth.should == 1 }
-      Then { stack.top.should == :an_item }
+      Then { stack.depth == 1 }
+      Then { stack.top == :an_item }
     end
 
     context "when popping" do
       When(:result) { stack.pop }
-      Then { result.should have_failed(Stack::UnderflowError, /empty/) }
+      Then { result == Failure(Stack::UnderflowError, /empty/) }
     end
   end
 
@@ -119,8 +119,8 @@ describe Stack do
     context "when popping" do
       When(:pop_result) { stack.pop }
 
-      Then { pop_result.should == :an_item }
-      Then { stack.depth.should == 0 }
+      Then { pop_result == :an_item }
+      Then { stack.depth == 0 }
     end
   end
 
@@ -131,16 +131,16 @@ describe Stack do
     context "when pushing" do
       When { stack.push(:new_item) }
 
-      Then { stack.top.should == :new_item }
-      Then { stack.depth.should == original_depth + 1 }
+      Then { stack.top == :new_item }
+      Then { stack.depth == original_depth + 1 }
     end
 
     context "when popping" do
       When(:pop_result) { stack.pop }
 
-      Then { pop_result.should == :top_item }
-      Then { stack.top.should == :second_item }
-      Then { stack.depth.should == original_depth - 1 }
+      Then { pop_result == :top_item }
+      Then { stack.top == :second_item }
+      Then { stack.depth == original_depth - 1 }
     end
   end
 end
@@ -307,7 +307,7 @@ should use an empty _Then_ clause, like this:
 #### Then examples:
 
 ```ruby
-    Then { stack.should be_empty }
+    Then { stack.empty? }
 ```
 
 After the related block for the _When_ clause is run, the stack should
@@ -354,9 +354,9 @@ stick with _Then_ clauses.
 #### Then/And examples:
 
 ```ruby
-  Then { pop_result.should == :top_item }           # Required
-  And  { stack.top.should == :second_item }         # No Setup rerun
-  And  { stack.depth.should == original_depth - 1 } # ... for these
+  Then { pop_result == :top_item }           # Required
+  And  { stack.top == :second_item }         # No Setup rerun
+  And  { stack.depth == original_depth - 1 } # ... for these
 ```
 
 ### Invariant
@@ -420,29 +420,56 @@ clauses and _before_ blocks.
 
 ## Natural Assertions
 
-**NOTE:** <em>Natural assertions are currently an experimental feature
-of RSpec/Given. They are currently disabled by default, but can be
-enabled by a simple configuration option (see "use_natural_assertions"
-below).</em>
-
 RSpec/Given now supports the use of "natural assertions" in _Then_,
 _And_, and _Invariant_ blocks. Natural assertions are just Ruby
 conditionals, without the _should_ or _expect_ methods that RSpec
-provides. Here are the Then/And examples from above, but written using
-natural assertions:
+provides. Here are the Then/And examples showing natural assertions:
+
+### Using Natural Assertions
+
+```ruby
+  Then { stack.top == :second_item }
+  Then { stack.depth == original_depth - 1 }
+  Then { result == Failure(Stack::UnderflowError, /empty/) }
+```
+
+### Using RSpec expect().to
 
 ```ruby
-  Then { pop_result == :top_item }
-  And  { stack.top == :second_item }
-  And  { stack.depth == original_depth - 1 }
+  Then { expect(stack.top).to eq(:second_item) }
+  Then { expect(stack.depth).to eq(original_depth - 1) }
+  Then { expect(result).to have_failed(Stack::UnderflowError, /empty/) }
 ```
 
-Natural assertions must be enabled, either globally or on a per
-context basis, to be recognized.
+### Using Minitest asserts
 
-Here's a heads up: If you use natural assertions, but fail to enable
-them, all your specs will mysteriously pass. This is why the **red**
-part of _Red/Green/Refactor_ is so important.
+```ruby
+  Then { assert_equal :second_item, stack.top }
+  Then { assert_equal original_depth - 1, stack.depth }
+  Then {
+    assert_raises(Stack::UnderflowError, /empty/) do
+      result.call()
+    end
+  }
+```
+
+### Using Minitest expectations
+
+```ruby
+  Then { stack.top.must_equal :second_item }
+  Then { stack.depth.must_equal original_depth - 1}
+  Then { result.must_raise(Stack::UnderflowError, /empty/) }
+```
+
+### Disabling Natural Assertions
+
+Natural assertions may be disabled, either globally or on a per
+context basis. See the **configuration** section below to see how to
+disable natural assertions project wide.
+
+Here's a heads up: If you use natural assertions, but configure Given
+to disable them, then all your specs will mysteriously pass. This is
+why the **red** part of _Red/Green/Refactor_ is so important.
 
 ### Failure Messages with Natural Assertions
 
@@ -552,19 +579,18 @@ problems with And clauses.
 
 ### Mixing Natural Assertions and RSpec Assertions
 
-Natural assertions and RSpec assertions for the most part can be
-intermixed in a single test suite, even within a single context.
-Because there are a few corner cases that might cause problems, they
-must be explicitly enabled before they will be considered.
-
-To enable natural assertions in a context, call the
-_use_natural_assertions_ method in that context. For example:
+Natural assertions, RSpec should assertions and Minitest assertions
+can be intermixed in a single test suite, even within a single
+context.
 
 ```ruby
   context "Outer" do
-    use_natural_assertions
-
     context "Inner" do
+      Then { a == b }               # Natural Assertions
+      Then { a.should == b }        # RSpec style
+      Then { expect(a).to eq(b) }   # RSpec style
+      Then { assert_equal b, a }    # Minitest style
+      Then { a.must_equal b }       # Minitest style
     end
 
     context "Disabled" do
@@ -577,7 +603,7 @@ Both the _Outer_ and _Inner_ contexts will use natural assertions. The
 _Disabled_ context overrides the setting inherited from _Outer_ and
 will not process natural assertions.
 
-See the **configuration** section below to see how to enable natural
+See the **configuration** section below to see how to disable natural
 assertions project wide.
 
 ### Matchers and Natural Assertions
@@ -622,7 +648,7 @@ There are several ways of creating fuzzy numbers:
 
 * <code>about(n)</code> -- Same as <code>about(n).epsilon(10)</code>.
 
-When the file <code>rspec/given/fuzzy_shortcuts</code> is required,
+When the file <code>given/fuzzy_shortcuts</code> is required,
 the following unicode shortcut methods are added to Numeric to create
 fuzzy numbers.
 
@@ -648,7 +674,7 @@ For example, the following two Then clauses are equivalent:
     Then { result.should have_failed(StandardError, /message/) }
 
     # Using natural assertions
-    Then { result == have_failed(StandardError, /message/) }
+    Then { result == Failure(StandardError, /message/) }
 ```
 
 ### Processing Natural Assertions
@@ -662,7 +688,9 @@ following are true:
 1. The block returns false (blocks that return true pass the
    assertion and don't need a failure message).
 
-1. The block does not use RSpec's _should_ or _expect_ methods.
+1. The block does not use the native frameworks assertions or
+   expectations (e.g. RSpec's _should_ or _expect_ methods, or
+   Minitest's _assert\_xxx_ or _must\_xxx_ methods).
 
 Detecting that last point (the use of _should_ and _expect_) is done
 by modifying the RSpec runtime to report uses of _should_ and
@@ -672,11 +700,11 @@ _expect_.
 
 Natural assertions use the Ripper library to parse the failing
 condition and find all the sub-expression values upon a failure.
-Currently Ripper is not supported on JRuby 1.7.2. Charles Nutter has
-said that Ripper support is coming soon and may arrive as early as
-version 1.7.3. Until then, natural assertions are disabled when
-running under JRuby. Never fear, JRuby supports all the other features
-of rspec-given and will work just fine.
+Currently Ripper is not fully supported on JRuby 1.7.4. Charles Nutter
+has said that Ripper support is coming soon and may arrive soon. Until
+then, natural assertions are disabled when running under JRuby. Never
+fear, JRuby supports all the other features of rspec-given and will
+work just fine.
 
 ### Further Reading
 
@@ -697,7 +725,7 @@ the pretty output and wish to disable source code caching
 unconditionally, then add the following line to your spec helper file:
 
 ```ruby
-    RSpec::Given.source_caching_disabled = true
+    Given.source_caching_disabled = true
 ```
 
 Natural assertions are disabled by default. To globally configure
@@ -714,8 +742,8 @@ file:
 
 # License
 
-RSpec-Given is available under the MIT License.  See the MIT-LICENSE
-file in the source distribution.
+rspec-given, minitest-given and given_core are available under the MIT
+License. See the MIT-LICENSE file in the source distribution.
 
 # History
 

data/Rakefile

@@ -57,8 +57,11 @@ end
 
 EXAMPLES = FileList['examples/**/*_spec.rb'].
   exclude('examples/failing/*.rb').
+  exclude('examples/minitest/*.rb').
   exclude('examples/integration/failing/*.rb')
 
+MT_EXAMPLES = FileList['examples/minitest/**/*_spec.rb']
+
 unless Given::NATURAL_ASSERTIONS_SUPPORTED
   EXAMPLES.exclude("examples/stack/*.rb")
 end
@@ -80,7 +83,7 @@ end
 desc "Run the examples in Minitest"
 task :mt_examples do
   puts "Running examples (with Minitest)"
-  sh "ruby -Ilib:examples examples/loader.rb #{EXAMPLES}"
+  sh "ruby -Ilib:examples examples/loader.rb #{EXAMPLES} #{MT_EXAMPLES}"
 end
 
 desc "Run failing examples"

data/examples/loader.rb

@@ -1,4 +1,3 @@
 ARGV.each do |fn|
-  puts "Loading #{fn} ..."
   load fn
 end

data/examples/minitest/assert_raises_spec.rb

@@ -0,0 +1,25 @@
+require 'minitest/given'
+require 'minitest/autorun'
+
+describe "stacks" do
+  context "when it fails" do
+    When(:result) { fail StandardError, "Oops" }
+
+    Then { result.must_raise(StandardError, /oops/i) }
+    Then {
+      assert_raises(StandardError, /oops/i) do
+        result.die
+      end
+    }
+    Then { result == Failure() }
+    Then { result == Failure(StandardError) }
+  end
+
+  context "when it does not fail" do
+    When(:result) { :ok }
+
+    Then { result != Failure() }
+    Then { result != Failure(StandardError) }
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: minitest-given
 version: !ruby/object:Gem::Version
-  version: 3.0.0.beta.3
+  version: 3.0.0.beta.4
 platform: ruby
 authors:
 - Jim Weirich
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.0.0.beta.3
+        version: 3.0.0.beta.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.0.0.beta.3
+        version: 3.0.0.beta.4
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -74,6 +74,7 @@ files:
 - examples/integration/invariant_spec.rb
 - examples/integration/then_spec.rb
 - examples/loader.rb
+- examples/minitest/assert_raises_spec.rb
 - examples/minitest_helper.rb
 - examples/other/line_example.rb
 - examples/stack/stack.rb