r_spec 1.0.0.beta10 → 1.0.0.beta11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba07a04820e5602fb73f32e7b265ef6cc755a54c396a7c9419fc97c8125d2fb1
-  data.tar.gz: 2330fe89b377b2f0cf13aaf6d325bf0b4f1c1fff5a409b8feba2f24f39e040a2
+  metadata.gz: 8c7957c4316cd89f58118ce544d50f3b5f401962648415b535c97da57ae4b7db
+  data.tar.gz: a1e8ec62ac5d695203917c85674a1d9b5dccbf1993c4fb55569fdd9d9401220b
 SHA512:
-  metadata.gz: 76a062afb51273f181f86db0fd85eb342fe6404f832e6facba450607f32f6b8555057ffa9918379ae30a8a63548c0911378348318ddba64be5bf94a14ecad8c1
-  data.tar.gz: 0d90f7fd0f0b94f40d28d4cb4c6dfcf82047830067881b0a8fef8108eb8cf4704b1542589023d91aed0f3814bbc10a5b7652269ac67ab7477a8a1c2231dc3383
+  metadata.gz: 51375c2f10d7cc11e71041c538940956e94721ae8f6e72af2bbb770d0b73041f6845b0100e9ebec2f7ec5d178fef388d5a5ece60e41076d7ff659d1d035afabd
+  data.tar.gz: 512ec78cc25d9ec8e0b5661c9a14b1fae3ae73714d8dc21e291721277ee6741035f5ccf130e190d661e8b19caf5d356d603a9951b40ad74b7fbdd20f7f9e6fec

data/README.md

@@ -7,8 +7,9 @@ A minimalist __[RSpec](https://github.com/rspec/rspec) clone__ with all the esse
 ## Status
 
 [![Gem Version](https://badge.fury.io/rb/r_spec.svg)](https://badge.fury.io/rb/r_spec)
-[![CI](https://github.com/cyril/r_spec.rb/workflows/ci/badge.svg?branch=main)](https://github.com/cyril/r_spec.rb/actions?query=workflow%3Aci+branch%3Amain)
 [![Documentation](https://img.shields.io/:yard-docs-38c800.svg)](https://rubydoc.info/gems/r_spec/frames)
+[![CI](https://github.com/cyril/r_spec.rb/workflows/CI/badge.svg?branch=main)](https://github.com/cyril/r_spec.rb/actions?query=workflow%3Aci+branch%3Amain)
+[![RuboCop](https://github.com/cyril/r_spec.rb/workflows/RuboCop/badge.svg?branch=main)](https://github.com/cyril/r_spec.rb/actions?query=workflow%3Arubocop+branch%3Amain)
 
 ## Project goals
 
@@ -29,6 +30,7 @@ A minimalist __[RSpec](https://github.com/rspec/rspec) clone__ with all the esse
 * 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_ to prevent side effects.
 
 ## Important ⚠️
 
@@ -47,7 +49,7 @@ Following [RubyGems naming conventions](https://guides.rubygems.org/name-your-ge
 Add this line to your application's Gemfile:
 
 ```ruby
-gem "r_spec", ">= 1.0.0.beta10"
+gem "r_spec", ">= 1.0.0.beta11"
 ```
 
 And then execute:
@@ -101,7 +103,8 @@ 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.
-It has a different name, but behaves exactly like `describe`.
+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.
 
 `describe` and `context` take an optional description as argument and a block containing the individual specs or nested groupings.
 
@@ -220,12 +223,7 @@ task default: :test
 
 Benchmark against [100 executions of a file containing one expectation](https://github.com/cyril/r_spec.rb/blob/main/benchmark/) (lower is better).
 
-| Framework   | Seconds to complete |
-|-------------|---------------------|
-| `r_spec`    | 13.0                |
-| `rspec`     | 32.2                |
-| `minitest`  | 17.5                |
-| `test-unit` | 20.5                |
+![Runtime](https://r-spec.dev/benchmark-runtime.png)
 
 ## Test suite
 
@@ -233,8 +231,10 @@ __RSpec clone__'s specifications are self-described here: [spec/](https://github
 
 ## Contact
 
-* Home page: https://r-spec.dev
-* Source code: https://github.com/cyril/r_spec.rb
+* Home page: [https://r-spec.dev/](https://r-spec.dev/)
+* Cheatsheet: [https://r-spec.dev/cheatsheet.html](https://r-spec.dev/cheatsheet.html)
+* Source code: [https://github.com/cyril/r_spec.rb](https://github.com/cyril/r_spec.rb)
+* API Doc: [https://rubydoc.info/gems/r_spec](https://rubydoc.info/gems/r_spec)
 * Twitter: [https://twitter.com/cyri\_](https://twitter.com/cyri\_)
 
 ## Special thanks ❤️

data/lib/r_spec.rb

@@ -65,7 +65,46 @@ require_relative File.join("r_spec", "dsl")
 #
 # @api public
 module RSpec
-  # Specs are built with this method.
+  # 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"
+  #
+  #   RSpec.context "when divided by zero" do
+  #     subject { 42 / 0 }
+  #
+  #     it { is_expected.to raise_exception ZeroDivisionError }
+  #   end
+  #
+  #   # Output to the console
+  #   #   Success: divided by 0.
+  #
+  # @param description [String] A description that usually begins with "when",
+  #   "with" or "without".
+  # @param block [Proc] The block to define the specs.
+  #
+  # @api public
+  def self.context(description, &block)
+    Dsl.context(description, &block)
+  end
+
+  # Defines an example group that describes a unit to be tested.
+  #
+  # @example
+  #   require "r_spec"
+  #
+  #   RSpec.describe String do
+  #     describe "+" do
+  #       it("concats") { expect("foo" + "bar").to eq "foobar" }
+  #     end
+  #   end
+  #
+  #   # Output to the console
+  #   #   Success: expected to eq "foobar".
   #
   # @param const [Module, String] A module to include in block context.
   # @param block [Proc] The block to define the specs.

data/lib/r_spec/dsl.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "aw"
+
 require_relative "console"
 require_relative "error"
 require_relative "expectation_helper"
@@ -155,7 +157,8 @@ module RSpec
     # Defines an example group that establishes a specific context, like _empty
     # array_ versus _array with elements_.
     #
-    # It is functionally equivalent to {.describe}.
+    # Unlike {.describe}, the block is evaluated in isolation in order to scope
+    # possible side effects inside its context.
     #
     # @example
     #   require "r_spec"
@@ -179,7 +182,7 @@ module RSpec
     # @param block [Proc] The block to define the specs.
     def self.context(_description = nil, &block)
       desc = ::Class.new(self)
-      desc.instance_eval(&block)
+      ::Aw.fork! { desc.instance_eval(&block) }
     end
 
     # Defines a concrete test case.

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: r_spec
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta10
+  version: 1.0.0.beta11
 platform: ruby
 authors:
 - Cyril Kato
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-21 00:00:00.000000000 Z
+date: 2021-06-23 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