smartest 0.3.1.alpha5 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a5579f607ea23d2a51683b610acb2a75fdfeb4594e65a2489a8388c0561044f8
-  data.tar.gz: 4fb60cd6e38a79cbb5617a5f536abe773224cf86bb6bb1147c09ecd001aabce6
+  metadata.gz: 1273e17fbc84bb22a5bf53b0176c5616ed8404e1ea6273720b6153f73c04b355
+  data.tar.gz: ddf2e93333e975b5d55ccd9a59125577cf2feaa415c7addcf1ebbc2c7bb25d43
 SHA512:
-  metadata.gz: b5177080f4e761cc48b2fc5a67a97121e4dc4897f9a5bef1a7ea70525d4e9f14f41cfddce6d234a910789d3a71dc34c1681eda2ba448c2566086632ba0d1a289
-  data.tar.gz: aa8ddd2fbbdf3f3ce71e5c7c62161b358da6a90339171d6a416c64f548a90677e859eb4ed67dee3d68eb558b43dd9bfda8a1a9a589804430b7d9ede0aa60837c
+  metadata.gz: 473ca3e954cb75238335dbd360c76d76c31076dbb0a17582480114ed49c7679c5326b47b6c175c9e52474b94b26c79b2774acbc62d35ec5885a6b2ac48b54107
+  data.tar.gz: 1b9541cccd90b5c70c2df6b99d723fb69a6ca3d965b989520f2b95b74c83ed0b066568e80d15621578f0aa7a5c025ada6c7f10ffc82b0311452191afd8dabf30

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,6 +37,32 @@ 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
 
 Add this line to your application's Gemfile:
@@ -776,22 +813,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/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.alpha5"
+  VERSION = "0.3.2"
 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.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.alpha5
+  version: 0.3.2
 platform: ruby
 authors:
 - Yusuke Iwaki
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-29 00:00:00.000000000 Z
+date: 2026-05-03 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:
@@ -92,12 +94,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 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: []