spectus 2.8.0 → 2.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f9c5f017cdf442b8b5b030ba4a89faec996d46d0
-  data.tar.gz: e92e7bce6997f75a1932d8593cf21e0150e95d08
+  metadata.gz: 3f1486affdd6feecdb555121c32c11c69a448e96
+  data.tar.gz: 4bd260c2f0295db5d5ffd7ecde20144be6509308
 SHA512:
-  metadata.gz: 6ccc7b4ab0aea3ee90b6a9cb28fe62e7d4458118df8cb34ccdbf3fdd530cf1fce8f0c1aab2a9884df30f99a1586708bc071ce5056fb8277d4d94b6e7f7c3ee0e
-  data.tar.gz: 62c3f9dd0ab650be6226c5564f4df238876683175b9cd20694467674dc6533afcae2f07aef42f4908390a2a56244349dabbf719a9c243af7798b896881df2b94
+  metadata.gz: ba367974543e1325be7846b697aa7f14766e1135ecf95f6d7b3af0fd1bed4cd7b805274b85f26b5d5f97b5af29e30c6d5c829cd6635817dcecc8a4bbbf2e5589
+  data.tar.gz: 33ed94ab7562d3ecfb0ca19c1efcac1b153bcfee782078fe1b166692bd5770a1803b3fe44823a01b59cfb1060ab1329735b37f0dfa1be16bf48c81e5f4a8f7b1

data/.rubocop_todo.yml

@@ -1,15 +1,11 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2015-10-10 17:44:08 +0200 using RuboCop version 0.34.2.
+# on 2015-10-13 23:48:38 +0200 using RuboCop version 0.34.2.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 1
-Metrics/AbcSize:
-  Max: 18
-
 # Offense count: 4
 # Configuration parameters: CountComments.
 Metrics/MethodLength:
@@ -25,5 +21,5 @@ Metrics/ParameterLists:
 # Configuration parameters: ExactNameMatch, AllowPredicates, AllowDSLWriters, IgnoreClassMethods, Whitelist.
 Style/TrivialAccessors:
   Exclude:
-    - 'lib/spectus/level/base.rb'
     - 'lib/spectus/report.rb'
+    - 'lib/spectus/requirement_level/base.rb'

data/README.md

@@ -51,6 +51,31 @@ An expectation is an assertion that is either `true` or `false`.
 | Implemented & Exception   | `false`  | `false`    | `false` |
 | Not implemented           | `false`  | `false`    | `true`  |
 
+## Isolation
+
+There are two cases:
+
+* when the requirement level of an expectation ends with `!`, the test is performed in isolation;
+* when the requirement level of an expectation does not end with `!`, the test is performed without isolation.
+
+Example of test in isolation:
+
+```ruby
+greeting = 'Hello, world!'
+Spectus.this { greeting.gsub!('world', 'Alice') }.MUST! Eql: 'Hello, Alice!'
+# => #<Spectus::Result::Pass:0x007fd6312e5310 @message="Pass: Expected \"Hello, Alice!\" to eql \"Hello, Alice!\".", @subject=#<Proc:0x007fd6312e6238@(irb):2>, @challenge=#<Defi::Challenge:0x007fd6312e59c8 @method=:call, @args=[]>, @actual="Hello, Alice!", @expected={:Eql=>"Hello, Alice!"}, @got=true, @error=nil, @level=:High, @negate=false, @valid=true>
+greeting # => "Hello, world!"
+```
+
+Example of test without isolation:
+
+```ruby
+greeting = 'Hello, world!'
+Spectus.this { greeting.gsub!('world', 'Alice') }.MUST Eql: 'Hello, Alice!'
+# => #<Spectus::Result::Pass:0x007fabbab88f68 @message="Pass: Expected \"Hello, Alice!\" to eql \"Hello, Alice!\".", @subject=#<Proc:0x007fabbab895a8@(irb):2>, @challenge=#<Defi::Challenge:0x007fabbab89530 @method=:call, @args=[]>, @actual="Hello, Alice!", @expected={:Eql=>"Hello, Alice!"}, @got=true, @error=nil, @level=:High, @negate=false, @valid=true>
+greeting # => "Hello, Alice!"
+```
+
 ## Results
 
 There are two cases:

data/VERSION.semver

@@ -1 +1 @@
-2.8.0
+2.9.0

data/checksum/spectus-2.8.0.gem.sha512

@@ -0,0 +1 @@
+2f4cc7cc8d6b32effa58c91d04e2bd2baea946c55782af86b9ac51669af56368ae68bb9dfe12ea702efa88b6b67003944e59ad876899dc950f0f590c9f26bb8f

data/lib/spectus/expectation_target.rb

@@ -39,6 +39,14 @@ module Spectus
       RequirementLevel::High.new(req, false, subject, *challenges).result
     end
 
+    # @example _Absolute requirement_ definition with isolation
+    #   this { 'foo'.upcase }.MUST! Eql: 'FOO'
+    #
+    # @see MUST
+    def MUST!(req)
+      RequirementLevel::High.new(req, false, subject, *challenges).result(true)
+    end
+
     # This phrase, or the phrase "SHALL NOT", mean that the
     # definition is an absolute prohibition of the specification.
     #
@@ -52,6 +60,14 @@ module Spectus
       RequirementLevel::High.new(req, true, subject, *challenges).result
     end
 
+    # @example _Absolute prohibition_ definition with isolation
+    #   this { 'foo'.size }.MUST_NOT! Equal: 42
+    #
+    # @see MUST_NOT
+    def MUST_NOT!(req)
+      RequirementLevel::High.new(req, true, subject, *challenges).result(true)
+    end
+
     # This word, or the adjective "RECOMMENDED", mean that there
     # may exist valid reasons in particular circumstances to ignore a
     # particular item, but the full implications must be understood and
@@ -67,6 +83,15 @@ module Spectus
       RequirementLevel::Medium.new(req, false, subject, *challenges).result
     end
 
+    # @example _Recommended_ definition with isolation
+    #   this { 'foo'.valid_encoding? }.SHOULD! Equal: true
+    #
+    # @see SHOULD
+    def SHOULD!(req)
+      RequirementLevel::Medium.new(req, false, subject, *challenges)
+        .result(true)
+    end
+
     # This phrase, or the phrase "NOT RECOMMENDED" mean that
     # there may exist valid reasons in particular circumstances when the
     # particular behavior is acceptable or even useful, but the full
@@ -83,6 +108,14 @@ module Spectus
       RequirementLevel::Medium.new(req, true, subject, *challenges).result
     end
 
+    # @example _Not recommended_ definition with isolation
+    #   this { ''.blank? }.SHOULD_NOT! RaiseException: NoMethodError
+    #
+    # @see SHOULD_NOT
+    def SHOULD_NOT!(req)
+      RequirementLevel::Medium.new(req, true, subject, *challenges).result(true)
+    end
+
     # This word, or the adjective "OPTIONAL", mean that an item is
     # truly optional.  One vendor may choose to include the item because a
     # particular marketplace requires it or because the vendor feels that
@@ -104,9 +137,17 @@ module Spectus
     def MAY(req)
       RequirementLevel::Low.new(req, false, subject, *challenges).result
     end
+
+    # @example _Optional_ definition with isolation
+    #   this { 'foo'.bar }.MAY! Match: /^foo$/
+    #
+    # @see MAY
+    def MAY!(req)
+      RequirementLevel::Low.new(req, false, subject, *challenges).result(true)
+    end
   end
 end
 
-require_relative File.join 'level', 'high'
-require_relative File.join 'level', 'medium'
-require_relative File.join 'level', 'low'
+require_relative File.join 'requirement_level', 'high'
+require_relative File.join 'requirement_level', 'medium'
+require_relative File.join 'requirement_level', 'low'

data/lib/spectus/report.rb

@@ -63,7 +63,7 @@ module Spectus
     def summary
       return state.exception.message unless state.valid? || state.exception.nil?
 
-      'Expected ' + state.actual.inspect + maybe_negate + ' to ' + definition
+      "Expected #{state.actual.inspect}#{maybe_negate} to #{definition}"
     end
 
     # The negation, if any.
@@ -85,7 +85,7 @@ module Spectus
     # @return [String] The readable definition string.
     def definition
       if req.is_a?(Hash)
-        snake_case(req.keys.first) + ' ' + req.values.first.inspect
+        "#{snake_case(req.keys.first)} #{req.values.first.inspect}"
       else
         snake_case(req)
       end

data/lib/spectus/{level → requirement_level}/base.rb

@@ -84,9 +84,11 @@ module Spectus
         self.class.name.split('::').last.to_sym
       end
 
+      # @param isolation [Boolean] Test in isolation.
+      #
       # @return [Sandbox] The sandbox.
-      def sandbox
-        Process.respond_to?(:fork) ? fork_and_return { execute } : execute
+      def sandbox(isolation)
+        isolation ? fork_and_return { execute } : execute
       end
 
       # @return [Sandbox] The sandbox.

data/lib/spectus/{level → requirement_level}/high.rb

@@ -11,8 +11,8 @@ module Spectus
       #
       # @return [Result::Fail, Result::Pass] Report if the high expectation
       #   pass or fail.
-      def result
-        state = sandbox
+      def result(isolation = false)
+        state = sandbox(isolation)
 
         if state.valid?
           pass!(state)

data/lib/spectus/{level → requirement_level}/low.rb

@@ -11,8 +11,8 @@ module Spectus
       #
       # @return [Result::Fail, Result::Pass] Report if the low expectation
       #   pass or fail.
-      def result
-        state = sandbox
+      def result(isolation = false)
+        state = sandbox(isolation)
 
         if state.valid? || state.exception.class.equal?(::NoMethodError)
           pass!(state)

data/lib/spectus/{level → requirement_level}/medium.rb

@@ -11,8 +11,8 @@ module Spectus
       #
       # @return [Result::Fail, Result::Pass] Report if the medium expectation
       #   pass or fail.
-      def result
-        state = sandbox
+      def result(isolation = false)
+        state = sandbox(isolation)
 
         if state.valid? || state.exception.nil?
           pass!(state)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spectus
 version: !ruby/object:Gem::Version
-  version: 2.8.0
+  version: 2.9.0
 platform: ruby
 authors:
 - Cyril Wack
@@ -30,7 +30,7 @@ cert_chain:
   dzJvWzQ1+dJU6WQv75E9ddSkaQrK3nhdgQVu+/wgvGSrsMvOGNz+LXaSDxQqZuwX
   0KNQFuIukfrdk8URwRnHoAnvx4U93iUw
   -----END CERTIFICATE-----
-date: 2015-10-10 00:00:00.000000000 Z
+date: 2015-10-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: defi
@@ -168,13 +168,14 @@ files:
 - checksum/spectus-2.6.0.gem.sha512
 - checksum/spectus-2.7.0.gem.sha512
 - checksum/spectus-2.7.1.gem.sha512
+- checksum/spectus-2.8.0.gem.sha512
 - lib/spectus.rb
 - lib/spectus/expectation_target.rb
-- lib/spectus/level/base.rb
-- lib/spectus/level/high.rb
-- lib/spectus/level/low.rb
-- lib/spectus/level/medium.rb
 - lib/spectus/report.rb
+- lib/spectus/requirement_level/base.rb
+- lib/spectus/requirement_level/high.rb
+- lib/spectus/requirement_level/low.rb
+- lib/spectus/requirement_level/medium.rb
 - lib/spectus/result/base.rb
 - lib/spectus/result/fail.rb
 - lib/spectus/result/pass.rb