r_spec-clone 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3cbbbb0e875f54ccff6794dfc52606e5d712f82a8e270e2d325cbaf59a62910e
-  data.tar.gz: 33a3f94a742cad452bf55ce4a9968f9f46b5af98e9db0bc63c9fe25860e730a5
+  metadata.gz: 6d314d17896138ce2ff2b6d7eb389a1ba2316690f40923684c68632227692a5f
+  data.tar.gz: af8efe2d9ab1b773db062263503221dd56b6b7a604e73d5f1a84baf0ccbf2b35
 SHA512:
-  metadata.gz: 89fea25a7d8bc02a3abbc31000d2b5690168d8e711513913b41b0df7692e1bebd3eececfb630f7ee710d940cb9a40588b48e5ac852457fc7ef5c93786795c1ec
-  data.tar.gz: b37a7a661bde709da6cb1c218329c1eef418e4ef1ea6777d649687da348a014aeae65706d202accb8d850a9fb73a55dcd8241854ded13d82288db837553e9006
+  metadata.gz: a57d31c77a3da5d120651efbbc1f6d28f808fa47d9c7184e04f79723273df0ce6d84ba08628bc2f60c98c7756a0f2cf1d46774f42d1c505ca9f4e522f418e404
+  data.tar.gz: 2b2cb13a1620fd98107b3f82e8d7427ae11eb054e9e4bd8c36fe21402efc9dc38af0f6aa41850dc65c05eeba9cfc918a23dfcdea743658963459ef9e5b35c689

data/README.md

@@ -7,7 +7,7 @@ A minimalist __RSpec clone__ with all the essentials.
 ## Status
 
 [![Version](https://img.shields.io/github/v/tag/cyril/r_spec-clone.rb?label=Version&logo=github)](https://github.com/cyril/r_spec-clone.rb/releases)
-[![Yard documentation](https://img.shields.io/badge/Yard-documentation-blue.svg?)](https://rubydoc.info/github/cyril/r_spec-clone.rb/main)
+[![Yard documentation](https://img.shields.io/badge/Yard-documentation-blue.svg?logo=github)](https://rubydoc.info/github/cyril/r_spec-clone.rb/main)
 [![CI](https://github.com/cyril/r_spec-clone.rb/workflows/CI/badge.svg?branch=main)](https://github.com/cyril/r_spec-clone.rb/actions?query=workflow%3Aci+branch%3Amain)
 [![RuboCop](https://github.com/cyril/r_spec-clone.rb/workflows/RuboCop/badge.svg?branch=main)](https://github.com/cyril/r_spec-clone.rb/actions?query=workflow%3Arubocop+branch%3Amain)
 [![License](https://img.shields.io/github/license/cyril/r_spec-clone.rb?label=License&logo=github)](https://github.com/cyril/r_spec-clone.rb/raw/main/LICENSE.md)
@@ -32,14 +32,14 @@ A minimalist __RSpec clone__ with all the essentials.
 * The `let` method defines a helper method rather than a memoized helper method.
 * The one-liner `is_expected` syntax also works with block expectations.
 * `subject`, `before`, `after` and `let` definitions must come before examples.
-* Each [`context` runs its tests in _isolation_](https://asciinema.org/a/29070?autoplay=1&speed=2) to prevent side effects.
+* Groups and examples are _executed in subprocesses_ the order they are defined.
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem "r_spec-clone", ">= 1.0.2"
+gem "r_spec-clone"
 ```
 
 And then execute:
@@ -93,8 +93,6 @@ For unit tests, it is recommended to follow the conventions for method names:
 * instance methods are prefixed with `#`, class methods with `.`.
 
 To establish certain contexts — think _empty array_ versus _array with elements_ — the `context` method may be used to communicate this to the reader.
-Its behavior is slightly different from `describe` because each `context` runs its tests in isolation,
-so side effects caused by testing do not propagate out of contexts.
 
 ### Expectations
 
@@ -211,11 +209,11 @@ bundle exec rake
 
 ## Performance
 
-### Runtime
+### Boot time
 
 Benchmark against [100 executions of a file containing one expectation](https://github.com/cyril/r_spec-clone.rb/blob/main/benchmark/) (lower is better).
 
-![Runtime](https://clone.r-spec.dev/benchmark-runtime.png)
+![Runtime](https://r-spec.dev/benchmark-boot-time.svg)
 
 ## Test suite
 
@@ -224,7 +222,7 @@ __RSpec clone__'s specifications are self-described here: [spec/](https://github
 ## Contact
 
 * Home page: [https://r-spec.dev/](https://r-spec.dev/)
-* Cheatsheet: [https://clone.r-spec.dev/cheatsheet.html](https://clone.r-spec.dev/cheatsheet.html)
+* Cheatsheet: [https://r-spec.dev/cheatsheet.html](https://r-spec.dev/cheatsheet.html)
 * Source code: [https://github.com/cyril/r_spec-clone.rb](https://github.com/cyril/r_spec-clone.rb)
 * API Doc: [https://rubydoc.info/gems/r_spec-clone](https://rubydoc.info/gems/r_spec-clone)
 * Twitter: [https://twitter.com/cyri\_](https://twitter.com/cyri\_)

data/lib/r_spec.rb

@@ -68,9 +68,6 @@ module RSpec
   # Defines an example group that establishes a specific context, like _empty
   # array_ versus _array with elements_.
   #
-  # Unlike {.describe}, the block is evaluated in isolation in order to scope
-  # possible side effects inside its context.
-  #
   # @example
   #   require "r_spec/clone"
   #

data/lib/r_spec/clone/dsl.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "aw"
-
 require_relative "console"
 require_relative "error"
 require_relative "expectation_helper"
@@ -152,14 +150,11 @@ module RSpec
       def self.describe(const, &block)
         desc = ::Class.new(self)
         desc.let(:described_class) { const } if const.is_a?(::Module)
-        desc.instance_eval(&block)
+        fork! { desc.instance_eval(&block) }
       end
 
-      # Defines an example group that establishes a specific context, like _empty
-      # array_ versus _array with elements_.
-      #
-      # Unlike {.describe}, the block is evaluated in isolation in order to scope
-      # possible side effects inside its context.
+      # Defines an example group that establishes a specific context, like
+      # _empty array_ versus _array with elements_.
       #
       # @example
       #   require "r_spec/clone"
@@ -183,7 +178,7 @@ module RSpec
       # @param block [Proc] The block to define the specs.
       def self.context(_description, &block)
         desc = ::Class.new(self)
-        ::Aw.fork! { desc.instance_eval(&block) }
+        fork! { desc.instance_eval(&block) }
       end
 
       # Defines a concrete test case.
@@ -225,16 +220,8 @@ module RSpec
       # @raise (see ExpectationTarget::Base#result)
       # @return (see ExpectationTarget::Base#result)
       def self.it(_name = nil, &block)
-        raise ::ArgumentError, "Missing example block" unless block
-
         example = ::Class.new(self) { include ExpectationHelper::It }.new
-        example.instance_eval(&block)
-      rescue ::SystemExit
-        Console.source(*block.source_location)
-
-        exit false
-      ensure
-        example&.send(AFTER_METHOD)
+        fork! { run(example, &block) }
       end
 
       # Use the {.its} method to define a single spec that specifies the actual
@@ -283,8 +270,6 @@ module RSpec
       # @raise (see ExpectationTarget::Base#result)
       # @return (see ExpectationTarget::Base#result)
       def self.its(attribute, *args, **kwargs, &block)
-        raise ::ArgumentError, "Missing example block" unless block
-
         example = ::Class.new(self) do
           include ExpectationHelper::Its
 
@@ -293,19 +278,13 @@ module RSpec
           end
         end.new
 
-        example.instance_eval(&block)
-      rescue ::SystemExit
-        Console.source(*block.source_location)
-
-        exit false
-      ensure
-        example&.send(AFTER_METHOD)
+        fork! { run(example, &block) }
       end
 
       # Defines a pending test case.
       #
-      # `&block` is never evaluated. It can be used to describe behaviour that is
-      # not yet implemented.
+      # `&block` is never evaluated. It can be used to describe behaviour that
+      # is not yet implemented.
       #
       # @example
       #   require "r_spec/clone"
@@ -331,6 +310,27 @@ module RSpec
         Console.passed_spec Error::PendingExpectation.result(message)
       end
 
+      # Creates a subprocess and runs the block inside.
+      def self.fork!(&block)
+        pid = fork(&block)
+        thread = ::Process.detach(pid)
+        exitstatus = thread.join.value.exitstatus
+        exit false unless exitstatus.zero?
+      end
+
+      # Execution of specifications.
+      def self.run(example, &block)
+        example.instance_eval(&block)
+      rescue ::SystemExit
+        Console.source(*block.source_location)
+
+        exit false
+      ensure
+        example&.send(AFTER_METHOD)
+      end
+
+      private_class_method :fork!, :run
+
       private
 
       def described_class

metadata

@@ -1,29 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: r_spec-clone
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - Cyril Kato
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-27 00:00:00.000000000 Z
+date: 2021-06-30 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: aw
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.1.12
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.1.12
 - !ruby/object:Gem::Dependency
   name: expresenter
   requirement: !ruby/object:Gem::Requirement
@@ -217,7 +203,7 @@ files:
 - lib/r_spec/clone/expectation_target/base.rb
 - lib/r_spec/clone/expectation_target/block.rb
 - lib/r_spec/clone/expectation_target/value.rb
-homepage: https://clone.r-spec.dev/
+homepage: https://r-spec.dev/
 licenses:
 - MIT
 metadata: