smartest 0.6.2.alpha2 → 0.6.2.alpha3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f0718af27aa3da16e50c8172fab0145ec41de84435c1f662af9f404ad81d2ed1
-  data.tar.gz: 861107ab2de4d07fa3b47c5a09ab39648b253567f17557ddb036c1bca1df7fc1
+  metadata.gz: 1443bebc805a4e69172dfca1294ad15f8cf79d7285c6496c63002280dddbf79e
+  data.tar.gz: 1b6277394636d37045d71dbaa566f820411d21b0fed517e257981278f4ad9f4d
 SHA512:
-  metadata.gz: 6b8e1a64faff9721e48a787841bff898c3b2a52fccc70808b4f298b22ecfe2473ae0d43a066c19267cecd8e640e8266ae81aa79a1097e72f070ab0aec2b0bde3
-  data.tar.gz: 3d3330b9b3087ae3c8d32775a4bfd0b082f1f0f42954bac03a00ab44b54930d999a4b787fcd768ce507dcea708d6f42878cee805165bb7026f28b19ed18dcba6
+  metadata.gz: 9b65c8950634a64d22072ed9ee926a45e1cd5250735f946b7f8a8d554ffad93bca933ca6ea692225c1c9521fffb01aa9163ff175c5391f444ab172cb0bfc5dc9
+  data.tar.gz: 5a3d0758ad87ccfb17c54234fb0b21c97b86a33dc87b7e1492660d9b97bb22ad2bf53a8b51890264c0bb0dacb3e0d2dbbeebfbd3817c06ae6e42054386afb4cc

data/README.md

@@ -331,12 +331,11 @@ end
 
 This makes fixture usage explicit and avoids relying on positional argument order.
 
-Smartest also ships RBS signatures for the public DSL, including `test`,
+Smartest also ships RBS signatures for the public DSL, including
 `around_suite`, `around_test`, `fixture`, `suite_fixture`, `on_teardown`,
-`expect`, and hook registration methods such as `use_fixture`. The signatures
-model `Smartest::DSL` as prepended into `Kernel`, matching how
-`smartest/autorun` installs the top-level DSL over Ruby's built-in
-`Kernel#test` file-test helper.
+`expect`, and hook registration methods such as `use_fixture`. The `test`
+method is intentionally not defined in RBS because it conflicts with Ruby's
+built-in `Kernel#test` file-test helper in some editors.
 
 ## Skipping and pending tests
 

data/lib/smartest/dsl.rb

@@ -2,23 +2,7 @@
 
 module Smartest
   # Top-level Smartest test definition DSL.
-  #
-  # Smartest installs this module into Kernel when `smartest/autorun` is
-  # required. The module intentionally overrides Ruby's built-in `Kernel#test`
-  # file-test helper while Smartest tests are being loaded.
   module DSL
-    # Define a named Smartest test.
-    #
-    # Test fixtures are requested with required keyword block parameters:
-    #
-    #   test("opens the home page") do |page:|
-    #     page.goto("/")
-    #   end
-    #
-    # @param name [String, Symbol] human-readable test name
-    # @param metadata [Hash] optional metadata kept with the test case
-    # @yield test body; required keyword parameters request fixtures
-    # @return [void]
     def test(name, **metadata, &block)
       location = caller_locations(1, 1).first
 
@@ -65,24 +49,6 @@ module Smartest
 end
 
 module Kernel
-  # @!method test(name, **metadata, &block)
-  #   Define a named Smartest test.
-  #
-  #   Fixture values are requested with required keyword block parameters:
-  #
-  #     test("opens the home page") do |page:|
-  #       page.goto("/")
-  #     end
-  #
-  #   Smartest installs this method by prepending `Smartest::DSL` into Kernel,
-  #   so it overrides Ruby's built-in `Kernel#test` file-test helper while
-  #   Smartest tests are being loaded.
-  #
-  #   @param name [String, Symbol] human-readable test name
-  #   @param metadata [Hash] optional metadata kept with the test case
-  #   @yield test body; required keyword parameters request fixtures
-  #   @return [void]
-  #
   # @!method around_suite(&block)
   #   Register a hook that wraps the whole suite.
   #

data/lib/smartest/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Smartest
-  VERSION = "0.6.2.alpha2"
+  VERSION = "0.6.2.alpha3"
 end

data/sig/smartest.rbs

@@ -14,10 +14,6 @@ module Smartest
   module DSL
     private
 
-    # Define a named test. Fixture values are requested from the block with
-    # required keyword arguments, for example `do |page:|`.
-    def test: (String | Symbol, **untyped) { (*untyped, **untyped) -> untyped } -> void
-
     # Wrap the whole suite. The block receives a run target and must call
     # `suite.run` exactly once.
     def around_suite: () { (SuiteRun) -> untyped } -> void
@@ -147,5 +143,13 @@ module Smartest
 end
 
 module Kernel
-  prepend Smartest::DSL
+  private
+
+  # Register a suite hook. The block receives a run target and must call
+  # `suite.run` exactly once.
+  def around_suite: () { (Smartest::SuiteRun) -> untyped } -> void
+
+  # Register a test hook for tests declared after this hook in the same file.
+  # The block receives a run target and must call `test.run` exactly once.
+  def around_test: () { (Smartest::TestRun) -> untyped } -> void
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: smartest
 version: !ruby/object:Gem::Version
-  version: 0.6.2.alpha2
+  version: 0.6.2.alpha3
 platform: ruby
 authors:
 - Yusuke Iwaki