smartest 0.3.1 → 0.3.3.alpha1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 262d446f5f8c460bf71fcd4c0d4a7b59d964905926327d8a2612a08befe68d8f
-  data.tar.gz: 250eb3bf7bca45dc67dbe8ad77a16306274976db7b555c0951060fc6d1950875
+  metadata.gz: 8e7e25cbb3432e62d6264a3308b1b8f01406ed44362f742356b31aa31629926a
+  data.tar.gz: cbb07c4ae5e9532836d505543f1af85ea222fd013d65b3fa79d0de0228fac1e6
 SHA512:
-  metadata.gz: 16aaa0eb4e01fdc26f0f9d9baa49510096bd4d1f131a975951f717da1c3f81c4d847c3d85ee7912ca0811fdb5348ad933cd4483ecf29772c953e356104bcf08b
-  data.tar.gz: 7a827e6bb95e8a7263806884bcb9150e1f8eaee02b066e702333ea141ed2e1a345d081d94250785e4d2100b444a078d2d5d35caf0ab514913d04e5f43a16fe2b
+  metadata.gz: 5d8cc3fde5695e83649858389212a849ded911ff350689747a62a53ae4c0ce7da5c800e8d6866fb46b04756d0f890efaa3107e9e0bed642092cf2f42aa01bb63
+  data.tar.gz: dbd5c2b3fab3d0ab182c78d2ee8f60dbb71efe61e0779646bea2194d1e2710bc3baf6c307b046500dcb293446bcd49a1a1c119c09df22703a9805f83992b7780

data/README.md

@@ -1,20 +1,31 @@
-# Smartest
+# Smartest introduces Pytest-style fixtures for Ruby
 
-Smartest is a small Ruby test runner with a keyword-fixture-first design.
+Smartest is a small Ruby test runner that brings pytest-style fixture
+injection, explicit fixture dependencies, and fixture cleanup to Ruby tests.
 
-It lets you write tests like this:
+Tests request fixtures with Ruby keyword arguments. Fixtures define their own
+dependencies the same way:
 
 ```ruby
-test("factorial") do
-  expect(1 * 2 * 3).to eq(6)
+class WebFixture < Smartest::Fixture
+  fixture :server do
+    server = TestServer.start
+    cleanup { server.stop }
+    server
+  end
+
+  fixture :client do |server:|
+    Client.new(base_url: server.url)
+  end
 end
-```
 
-and fixture-driven tests like this:
+around_suite do |suite|
+  use_fixture WebFixture
+  suite.run
+end
 
-```ruby
-test("GET /me") do |logged_in_client:|
-  response = logged_in_client.get("/me")
+test("GET /health") do |client:|
+  response = client.get("/health")
 
   expect(response.status).to eq(200)
 end
@@ -26,8 +37,36 @@ Smartest is designed around three ideas:
 2. Fixture dependencies should be explicit.
 3. Teardown should be written only when it is needed.
 
+## Why Smartest?
+
+Ruby already has excellent testing tools, but Smartest focuses on a specific
+idea: tests should explicitly declare their dependencies.
+
+RSpec `let` is useful when examples need lazy helper methods. Minitest `setup`
+is simple for xUnit-style setup. Rails fixtures and FactoryBot are great for
+test data. Smartest is aimed at tests where setup resources, dependency graphs,
+and cleanup should be visible in the test signature and fixture definitions.
+
+```ruby
+test("GET /me") do |logged_in_client:|
+  response = logged_in_client.get("/me")
+
+  expect(response.status).to eq(200)
+end
+```
+
+| Tool | Style | Difference from Smartest |
+| --- | --- | --- |
+| RSpec `let` | Lazy helper method | Tests pull dependencies from inside the example. |
+| Minitest `setup` | xUnit setup method | Dependencies often become implicit instance state. |
+| Rails fixtures | Database records | Not resource setup or fixture dependency injection. |
+| FactoryBot | Test data factories | Not fixture lifecycle management. |
+| Smartest | Keyword fixture injection | Tests declare dependencies explicitly. |
+
 ## Installation
 
+Smartest requires Ruby 2.7 or newer.
+
 Add this line to your application's Gemfile:
 
 ```ruby
@@ -776,22 +815,24 @@ end
 
 The dependency declaration and usage are in one place.
 
-## Status
+## Current scope
 
-Smartest is currently a design-stage test runner.
-
-The intended MVP includes:
+Smartest currently focuses on a small runner API:
 
 - top-level `test`
 - class-based fixtures
 - keyword-argument fixture injection
 - fixture dependencies through keyword arguments
 - fixture cleanup
+- suite-scoped fixtures through `suite_fixture`
 - suite hooks with `around_suite`
 - test hooks with `around_test`
 - skipped and pending tests through `skip` and `pending`
-- `expect(...).to eq(...)`
+- expectation matchers through `expect`
 - console reporter
 - CLI runner
 - circular fixture dependency detection
 - duplicate fixture detection
+
+Nested `describe` blocks, watch mode, parallel execution, and file-scoped
+fixtures are not part of the current MVP.

data/exe/smartest

@@ -43,7 +43,7 @@ begin
   end
 
   Smartest.disable_autorun!
-  Kernel.prepend Smartest::DSL
+  Smartest.install_dsl!
   test_load_path = File.expand_path("smartest", Dir.pwd)
   $LOAD_PATH.unshift(test_load_path) if Dir.exist?(test_load_path) && !$LOAD_PATH.include?(test_load_path)
 

data/lib/smartest/autorun.rb

@@ -3,6 +3,6 @@
 require "English"
 require_relative "../smartest"
 
-Kernel.prepend Smartest::DSL
+Smartest.install_dsl!
 
 Smartest.register_autorun!

data/lib/smartest/init_browser_generator.rb

@@ -70,7 +70,7 @@ module Smartest
 
         page.locator("a[href='/gems/smartest']").click
         expect(page).to have_url("https://rubygems.org/gems/smartest")
-        expect(page.locator(".versions")).to have_text("0.3.0.alpha1")
+        expect(page.locator("h1")).to have_text("smartest")
       end
     RUBY
 

data/lib/smartest/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Smartest
-  VERSION = "0.3.1"
+  VERSION = "0.3.3.alpha1"
 end

data/lib/smartest.rb

@@ -57,11 +57,26 @@ module Smartest
       end
     end
 
+    def install_dsl!
+      if kernel_prepend_effective?
+        Kernel.prepend DSL
+      else
+        Object.include DSL
+      end
+    end
+
     def fatal_exception?(error)
       error.is_a?(SystemExit) ||
         error.is_a?(Interrupt) ||
         error.is_a?(SignalException) ||
         error.is_a?(NoMemoryError)
     end
+
+    private
+
+    def kernel_prepend_effective?
+      # Ruby 2.7 does not support Kernel.prepend for defining top-level method.
+      Gem::Version.new(RUBY_VERSION) >= Gem::Version.new("3.0")
+    end
   end
 end

data/smartest/smartest_test.rb

@@ -2024,8 +2024,11 @@ test("cli browser init generator creates Playwright scaffold and installation co
     status = generator.run
 
     expect(status).to eq(0)
-    expect(File.read(File.join(dir, "smartest/example_browser_test.rb"))).to include("finds the smartest gem on RubyGems")
-    expect(File.read(File.join(dir, "smartest/example_browser_test.rb"))).to include('expect(page).to have_url("https://rubygems.org/gems/smartest")')
+    example_browser_test = File.read(File.join(dir, "smartest/example_browser_test.rb"))
+    expect(example_browser_test).to include("finds the smartest gem on RubyGems")
+    expect(example_browser_test).to include('expect(page).to have_url("https://rubygems.org/gems/smartest")')
+    expect(example_browser_test).to include('expect(page.locator("h1")).to have_text("smartest")')
+    expect(example_browser_test).not_to include("0.3.0.alpha1")
     expect(File.read(File.join(dir, "smartest/fixtures/playwright_fixture.rb"))).to include("class PlaywrightFixture < Smartest::Fixture")
     expect(File.read(File.join(dir, "smartest/fixtures/playwright_fixture.rb"))).to include('require "playwright"')
     expect(File.read(File.join(dir, "smartest/fixtures/playwright_fixture.rb"))).to include('playwright_cli_executable_path: "./node_modules/.bin/playwright"')

data/smartest.gemspec

@@ -7,19 +7,20 @@ Gem::Specification.new do |spec|
   spec.version = Smartest::VERSION
   spec.authors = ["Yusuke Iwaki"]
 
-  spec.summary = "A small Ruby test runner with keyword-first fixtures."
-  spec.description = "Smartest is a small Ruby test runner focused on readable top-level tests, explicit keyword-argument fixture dependencies, and optional fixture cleanup."
-  spec.homepage = "https://github.com/YusukeIwaki/smartest"
+  spec.summary = "Pytest-style fixtures for Ruby."
+  spec.description = "Smartest is a Ruby test runner with pytest-style fixture injection. Tests request fixtures using keyword arguments, fixtures can depend on other fixtures, and cleanup is registered only when needed."
+  spec.homepage = "https://smartest-rb.vercel.app"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.1"
+  spec.required_ruby_version = ">= 2.7"
 
   spec.metadata = {
     "allowed_push_host" => "https://rubygems.org",
     "bug_tracker_uri" => "https://github.com/YusukeIwaki/smartest/issues",
-    "documentation_uri" => "https://smartest-rb.vercel.app/",
+    "changelog_uri" => "https://github.com/YusukeIwaki/smartest/blob/main/CHANGELOG.md",
+    "documentation_uri" => "https://smartest-rb.vercel.app/docs/fixtures",
     "homepage_uri" => spec.homepage,
     "rubygems_mfa_required" => "true",
-    "source_code_uri" => "https://github.com/YusukeIwaki/smartest/tree/main"
+    "source_code_uri" => "https://github.com/YusukeIwaki/smartest"
   }
 
   spec.files = Dir.chdir(__dir__) do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smartest
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.3.alpha1
 platform: ruby
 authors:
 - Yusuke Iwaki
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-29 00:00:00.000000000 Z
+date: 2026-05-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -24,8 +24,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
-description: Smartest is a small Ruby test runner focused on readable top-level tests,
-  explicit keyword-argument fixture dependencies, and optional fixture cleanup.
+description: Smartest is a Ruby test runner with pytest-style fixture injection. Tests
+  request fixtures using keyword arguments, fixtures can depend on other fixtures,
+  and cleanup is registered only when needed.
 email:
 executables:
 - smartest
@@ -71,16 +72,17 @@ files:
 - lib/smartest/version.rb
 - smartest.gemspec
 - smartest/smartest_test.rb
-homepage: https://github.com/YusukeIwaki/smartest
+homepage: https://smartest-rb.vercel.app
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
   bug_tracker_uri: https://github.com/YusukeIwaki/smartest/issues
-  documentation_uri: https://smartest-rb.vercel.app/
-  homepage_uri: https://github.com/YusukeIwaki/smartest
+  changelog_uri: https://github.com/YusukeIwaki/smartest/blob/main/CHANGELOG.md
+  documentation_uri: https://smartest-rb.vercel.app/docs/fixtures
+  homepage_uri: https://smartest-rb.vercel.app
   rubygems_mfa_required: 'true'
-  source_code_uri: https://github.com/YusukeIwaki/smartest/tree/main
+  source_code_uri: https://github.com/YusukeIwaki/smartest
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -89,15 +91,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
-summary: A small Ruby test runner with keyword-first fixtures.
+summary: Pytest-style fixtures for Ruby.
 test_files: []