minitest-given 3.6.0 → 3.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ca2121241515d109726c7305514f84ade99a5411
-  data.tar.gz: b711c3dc935f472e88c8dc8c4cd3b0dc1c53c4f2
+SHA256:
+  metadata.gz: fd3d164a314ccce6dcff4898b68e050f021209d265c4fcf8040222781e9addf9
+  data.tar.gz: 652592b056739a640159ede981c2869dddd6b0975983819d977b66d216f006fc
 SHA512:
-  metadata.gz: 9b26fbd9e5c54f0801d2cb8e03ef64671689f7798adf075ac47d359af518c4db73bfd28785f0390bffc7a9b85de60a73c0192a921a3fb4f48ea634afb9bcfd60
-  data.tar.gz: 4dfb410a738e8b27ba546991f3cb418826a949f7b016ac31cfbfe1253b6ac085ba1b6ac16dd69cbe1eaef99aff0024d0914c2369a4a875a61b28419303e7bea1
+  metadata.gz: 56bb654001246ebee0e060181d1ce1b559e1914c7d26e91b8ae2e5fd5f62cb2ae01ea4201a2b7fc42a86929b6eb1b6c8cc1a7599acc6ba972cb6a7ba3e8e1c82
+  data.tar.gz: 6162d7a38540731542e752ee9a2844d86296faf5a942dd32ec3516d6100655dbc24ae5acdd4775ea5a240985fecb6a47305a8227309cc1f56feb67e4b82fe6d8

data/Gemfile.lock

@@ -1,25 +1,25 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    diff-lcs (1.2.5)
-    minitest (5.5.0)
-    rake (10.4.2)
-    rspec (3.1.0)
-      rspec-core (~> 3.1.0)
-      rspec-expectations (~> 3.1.0)
-      rspec-mocks (~> 3.1.0)
-    rspec-core (3.1.7)
-      rspec-support (~> 3.1.0)
-    rspec-expectations (3.1.2)
+    diff-lcs (1.4.4)
+    minitest (5.14.3)
+    rake (13.0.3)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.1.0)
-    rspec-mocks (3.1.3)
-      rspec-support (~> 3.1.0)
-    rspec-support (3.1.2)
-    sorcerer (1.0.2)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.2)
+    sorcerer (2.0.1)
 
 PLATFORMS
-  java
   ruby
 
 DEPENDENCIES
@@ -27,3 +27,6 @@ DEPENDENCIES
   rake
   rspec (>= 2.14.0)
   sorcerer (>= 0.3.7)
+
+BUNDLED WITH
+   2.1.4

data/README.md

@@ -4,7 +4,7 @@
 | :----: |
 | [![Master Build Status](https://secure.travis-ci.org/rspec-given/rspec-given.png?branch=master)](https://travis-ci.org/rspec-given/rspec-given) |
 
-Covering rspec-given, minitest-given, and given-core, version 3.6.0.
+Covering rspec-given, minitest-given, and given-core, version 3.8.2.
 
 rspec-given and minitest-given are extensions to your favorite testing
 framework to allow Given/When/Then notation when writing specs.
@@ -53,7 +53,7 @@ things to watch out for:
 
 * Only one before block is allowed in any given Minitest::Spec
   describe block. This doesn't effect the number of Givens you are
-  allowed to use, but it may surprise if you are use to RSpec.
+  allowed to use, but it may surprise you if you are used to RSpec.
 
 ### Auto Selecting
 
@@ -347,6 +347,17 @@ should use an empty _Then_ clause, like this:
     Then { }
 ```
 
+A _Then_ clause accepts arguments for user-defined RSpec metadata:
+
+```ruby
+    Then(:zippy, :foo => 17) { ... }
+```
+
+Metadata on _Then_ clauses is an RSpec-only feature. You can read more about
+metadata [in RSpec's
+documentation](https://www.relishapp.com/rspec/rspec-core/docs/metadata/user-defined-metadata).
+
+
 #### Then examples:
 
 ```ruby
@@ -760,12 +771,13 @@ _expect_.
 
 Given uses the Ripper library to parse the source lines and failing
 conditions to find all the sub-expression values upon a failure.
-Currently Ripper is not supported on Rubinius and versions of JRuby
-prior to JRuby-1.7.5.
 
-If you want to use a version of Ruby that does not support Ripper,
-then natural assertions will disabled. In addition, you should also
-disable source caching in the configuration (see the configuration
+If Ripper is not available, like on Rubinius and versions of JRuby prior to
+JRuby-1.7.5, detailed explanations of failures for natural assertions won't be
+available.  Natural assertions will still work, though.
+
+If you want to use a version of Ruby that does not support Ripper, then you
+should disable source caching in the configuration (see the configuration
 section below).
 
 ### Non-Spec Assertions
@@ -870,6 +882,26 @@ License. See the MIT-LICENSE file in the source distribution.
 
 # History
 
+* Version 3.8.1
+
+  * Fix deprecation warnings fro Ruby 2.6 & up
+
+* Version 3.8.0
+
+  * RSpec metadata can now be added to _Then_ clauses (see [#11](https://github.com/rspec-given/rspec-given/pull/11))
+  * Natural assertions now run on Rubinius and older versions of JRuby (see [#15](https://github.com/rspec-given/rspec-given/issues/15))
+    * WARNING: On these platforms, detailed failure explanations aren't available and source code snippets of Then clauses will only show the first line.
+    * WARNING: Assertions of void statements (e.g. `Then { }`) will fail only under runtimes lacking Ripper support
+  * `Given.ok_to_use_natural_assertions` was removed; the method was never properly supported as public, but it was publicly reachable
+
+* Version 3.7.1
+
+  * Mixin Minitest extensions for both ActiveSupport::TestCase (when present) as well as for MiniTest::Spec (see [#8](https://github.com/rspec-given/rspec-given/pulls/8))
+
+* Version 3.7.0
+
+  * Add support for Rails tests when using minitest-given (See [#6](https://github.com/rspec-given/rspec-given/pull/6))
+
 * Version 3.6.0
 
   * Various fixes for RSpec 3.0 (See [#1](https://github.com/rspec-given/rspec-given/pull/1))

data/Rakefile

@@ -62,13 +62,10 @@ end
 EXAMPLES = FileList['examples/**/*_spec.rb', 'examples/use_assertions.rb'].
   exclude('examples/failing/*.rb').
   exclude('examples/minitest/*.rb').
+  exclude('examples/minitest-rails/*.rb').
   exclude('examples/integration/failing/*.rb')
 
-MT_EXAMPLES = FileList['examples/minitest/**/*_spec.rb']
-
-unless Given::NATURAL_ASSERTIONS_SUPPORTED
-  EXAMPLES.exclude("examples/stack/*.rb")
-end
+MT_EXAMPLES = FileList['examples/minitest-rails/**/*_spec.rb', 'examples/minitest/**/*_spec.rb']
 
 FAILING_EXAMPLES = FileList['examples/failing/**/*_spec.rb']
 

data/examples/active_support_helper.rb

@@ -0,0 +1,10 @@
+module ActiveSupport
+  class TestCase < Minitest::Test
+    # Add spec DSL
+    extend ::Minitest::Spec::DSL
+
+    register_spec_type(self) do |desc, *addl|
+      addl.include? :model
+    end
+  end
+end

data/examples/example_helper.rb

@@ -5,6 +5,7 @@ if defined?(RSpec)
   require 'spec_helper'
 else
   require 'minitest/autorun'
+  require 'active_support_helper'
   require 'minitest/given'
   require 'minitest_helper'
 end

data/examples/integration/failing_messages_spec.rb

@@ -2,30 +2,44 @@ require 'example_helper'
 require 'open3'
 
 describe "Failing Messages" do
-  use_natural_assertions_if_supported
-
   IOS = Struct.new(:out, :err)
 
   def run_spec(filename)
-    inn, out, err, wait = Open3.popen3("rspec", "examples/integration/failing/#{filename}")
+    _inn, out, err, _wait = Open3.popen3(
+      "rspec", "examples/integration/failing/#{filename}",
+      # Ensure our `project_source_dirs` config is set when we shell out to RSpec.
+      "-rexample_helper"
+    )
     IOS.new(out.read, err.read)
   end
 
   When(:ios) { run_spec(failing_test) }
 
   context "when referencing constants from nested modules" do
+    skip_natural_assertions_if_not_supported
     Given(:failing_test) { "module_nesting_spec.rb" }
     Then { ios.err == "" }
     And { ios.out !~ /uninitialized constant RSpec::Given::InstanceExtensions::X/ }
   end
 
   context "when referencing undefined methods" do
+    skip_natural_assertions_if_not_supported
     Given(:failing_test) { "undefined_method_spec.rb" }
     Then { ios.err == "" }
-    And { ios.out =~ /undefined local variable or method `xyz'/ }
+    And { complains_xyz_is_not_in_scope?(ios.out) }
+
+    def complains_xyz_is_not_in_scope?(out)
+      [
+        # RSpec <3.2's message:
+        "undefined local variable or method `xyz'",
+        # RSpec >3.2's message:
+        "`xyz` is not available from within an example"
+      ].any? { |msg| out.include?(msg) }
+    end
   end
 
   context "when breaking down expressions" do
+    skip_natural_assertions_if_not_supported
     Given(:failing_test) { "eval_subexpression_spec.rb" }
     Then { ios.err == "" }
     And  { ios.out =~ /false *<- array\[index\]\.upcase == value$/ }
@@ -42,8 +56,9 @@ describe "Failing Messages" do
   end
 
   context "with an oddly formatted then" do
+    skip_natural_assertions_if_not_supported
     Given(:failing_test) { "oddly_formatted_then.rb" }
-    Then { ios.out =~ /Failure\/Error: Then \{ result == \['a',$/ }
+    Then { ios.out =~ /Failure\/Error:\s*Then \{ result == \['a',$/ }
     And  { ios.out =~ /expected: "anything"/ }
     And  { ios.out =~ /to equal: \["a", "a"\]/ }
   end

data/examples/integration/given_spec.rb

@@ -55,8 +55,8 @@ describe "Lazy Givens" do
   end
 
   context "when not called" do
-    Given(:value) { :ok }
-    Then { given_assert_equal :ok, value }
+    Given(:some_value) { :ok }
+    Then { given_assert_equal :ok, some_value }
   end
 end
 

data/examples/integration/then_spec.rb

@@ -11,11 +11,10 @@ end
 
 describe "Then" do
   context "empty thens with natural assertions" do
-    use_natural_assertions_if_supported
+    skip_natural_assertions_if_not_supported #<--we can't detect void statements
     Then { }
   end
   context "thens to_bool/true will pass" do
-    use_natural_assertions_if_supported
     Then { ToBool.new(true) }
   end
 end

data/examples/minitest-rails/test_case_spec.rb

@@ -0,0 +1,33 @@
+require 'minitest/autorun'
+require 'active_support_helper'
+require 'minitest/given'
+require 'example_helper'
+
+
+describe ActiveSupport::TestCase, :model do
+  Given(:info) { [] }
+  Given { info << "outer1" }
+  Given { info << "outer2" }
+
+  context "using a when without result" do
+    When { info << "when" }
+
+    context "inner with When" do
+      Given { info << "inner1" }
+      Given { info << "inner2" }
+      Then { given_assert_equal ["outer1", "outer2", "inner1", "inner2", "when"], info }
+
+      context "using a nested When" do
+        When { info << "when2" }
+        Then { given_assert_equal ["outer1", "outer2", "inner1", "inner2", "when", "when2"], info}
+      end
+
+      context "using two nested When" do
+        When { info << "when2a" }
+        When { info << "when2b" }
+        Then { given_assert_equal ["outer1", "outer2", "inner1", "inner2", "when", "when2a", "when2b"], info }
+      end
+    end
+  end
+end
+

data/examples/minitest_helper.rb

@@ -1,4 +1,3 @@
-
 module GivenAssertions
   def given_assert(cond)
     assert cond
@@ -23,16 +22,13 @@ module GivenAssertions
 end
 
 module NaturalAssertionControl
-  def use_natural_assertions_if_supported(enabled=true)
-    if enabled && ! Given::NATURAL_ASSERTIONS_SUPPORTED
-      Given {
-        skip "Natural assertions are not supported in JRuby"
-      }
-    else
-      use_natural_assertions(enabled)
+  def skip_natural_assertions_if_not_supported
+    if !Given::NATURAL_ASSERTIONS_SUPPORTED
+      Given { skip "This test requires a Ruby runtime with full natural assertions support." }
     end
   end
 end
 
 Minitest::Spec.send(:include, GivenAssertions)
+Minitest::Test.send(:include, GivenAssertions)
 include NaturalAssertionControl

data/examples/use_assertions.rb

@@ -1,47 +1,44 @@
 require 'given/module_methods'
 
-if Given::NATURAL_ASSERTIONS_SUPPORTED
+require 'given/assertions'
+require 'given/fuzzy_number'
 
-  require 'given/assertions'
-  require 'given/fuzzy_number'
+include Given::Assertions
+include Given::Fuzzy
 
-  include Given::Assertions
-  include Given::Fuzzy
-
-  def sqrt(n)
-    Precondition { n >= 0 }
-    result = Math.sqrt(n)
-    Postcondition { result ** 2 == about(n) }
-    result
-  end
+def sqrt(n)
+  Precondition { n >= 0 }
+  result = Math.sqrt(n)
+  Postcondition { result ** 2 == about(n) }
+  result
+end
 
-  def sqrt_bad_postcondition(n)
-    Precondition { n >= 0 }
-    result = Math.sqrt(n)
-    Postcondition { result ** 2 == about(n+1) }
-    result
-  end
+def sqrt_bad_postcondition(n)
+  Precondition { n >= 0 }
+  result = Math.sqrt(n)
+  Postcondition { result ** 2 == about(n+1) }
+  result
+end
 
-  def use_assert(n)
-    Assert { n == 1 }
-  end
+def use_assert(n)
+  Assert { n == 1 }
+end
 
-  def should_fail
-    begin
-      yield
-      fail "Expected error"
-    rescue Given::Assertions::AssertError => ex
-      true
-    end
+def should_fail
+  begin
+    yield
+    fail "Expected error"
+  rescue Given::Assertions::AssertError => ex
+    true
   end
+end
 
-  sqrt(1)
-  sqrt(2)
-  sqrt(0)
+sqrt(1)
+sqrt(2)
+sqrt(0)
 
-  should_fail { sqrt(-1) }
-  should_fail { sqrt_bad_postcondition(1) }
+should_fail { sqrt(-1) }
+should_fail { sqrt_bad_postcondition(1) }
 
-  use_assert(1)
-  should_fail { use_assert(0) }
-end
+use_assert(1)
+should_fail { use_assert(0) }

data/lib/minitest-given.rb

@@ -6,4 +6,4 @@
 #
 # Thanks.
 
-require 'given/minitest/all'
+require 'minitest/given'

data/lib/minitest/given.rb

@@ -1 +1,2 @@
+require 'minitest/spec'
 require 'given/minitest/all'

data/rakelib/gemspec.rake

@@ -56,7 +56,6 @@ EOF
     s.author = "Jim Weirich"
     s.email = "jim.weirich@gmail.com"
     s.homepage = "http://github.com/rspec-given/rspec-given"
-    s.rubyforge_project = "given"
   end
 
   MINITEST_GIVEN_SPEC = Gem::Specification.new do |s|
@@ -84,7 +83,6 @@ EOF
     s.author = "Jim Weirich"
     s.email = "jim.weirich@gmail.com"
     s.homepage = "http://github.com/rspec-given/rspec-given"
-    s.rubyforge_project = "given"
   end
 
   GIVEN_CORE_SPEC = Gem::Specification.new do |s|
@@ -112,7 +110,6 @@ EOF
     s.author = "Jim Weirich"
     s.email = "jim.weirich@gmail.com"
     s.homepage = "http://github.com/rspec-given/rspec-given"
-    s.rubyforge_project = "given"
   end
 
   Gem::PackageTask.new(MINITEST_GIVEN_SPEC) do |pkg|

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: minitest-given
 version: !ruby/object:Gem::Version
-  version: 3.6.0
+  version: 3.8.2
 platform: ruby
 authors:
 - Jim Weirich
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2015-01-09 00:00:00.000000000 Z
+date: 2021-01-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: given_core
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.6.0
+        version: 3.8.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.6.0
+        version: 3.8.2
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -54,6 +54,7 @@ files:
 - TODO
 - doc/article/custom_error_messages.md
 - doc/main.rdoc
+- examples/active_support_helper.rb
 - examples/example_helper.rb
 - examples/failing/natural_failing_spec.rb
 - examples/failing/sample_spec.rb
@@ -69,6 +70,7 @@ files:
 - examples/integration/invariant_spec.rb
 - examples/integration/then_spec.rb
 - examples/loader.rb
+- examples/minitest-rails/test_case_spec.rb
 - examples/minitest/assert_raises_spec.rb
 - examples/minitest_helper.rb
 - examples/other/line_example.rb
@@ -87,7 +89,7 @@ homepage: http://github.com/rspec-given/rspec-given
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options:
 - "--line-numbers"
 - "--inline-source"
@@ -108,9 +110,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: given
-rubygems_version: 2.4.4
-signing_key: 
+rubygems_version: 3.1.4
+signing_key:
 specification_version: 4
 summary: Given/When/Then Specification Extensions for Minitest::Spec.
 test_files: []