smartest 0.3.3.alpha4 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75e3f0538afd3f490c37121ae4eee497a4691f35926ff50201e035acb64d2314
-  data.tar.gz: 53fea3bdbbb788167d13c6a7b6c18a9258de42b971c4f2a1f36906176f75813a
+  metadata.gz: 3d2b5aeaf51e6e6878eac74601d634daab2e423cede641216856a79188c28554
+  data.tar.gz: 4f90e558f84062585a0a8b3596c91f9507f9fec09430a86c6782ae7a3ba92bb7
 SHA512:
-  metadata.gz: ba646897bc5994e7caf30fc9b1127a1ad72f2545a4ed8734820c5eeeca3e5e1e7e0302394b38916fbc9d9c153dccfdae96496093dce1f23af172fa74a01cbd75
-  data.tar.gz: 5c12f0c3532da8eb44c3e832d28e479b1f8a54f5797a4c67c61c865bbbedf31e2225fe441c1f433d8de6ce3b2246c374de998d2aae9b2cfa8a7ea63f043ed949
+  metadata.gz: 687150dcb8a16d475d76b9840fecf63b7705fc0b5e123380d6ffe3fe415a77ed89228bdbc098e66db22d67164f4b43412229e47311be15b6ab09643bf00aa43f
+  data.tar.gz: 037f50862bd76bcb86e4511227a8a5f2ce943e37fdce3d823124ff90872efa1a808bb7eee4a2ab9c0985c685baf2db451c304074e6797f88d1c2f370390adea6

data/DEVELOPMENT.md

@@ -648,6 +648,10 @@ A practical approach:
 - `exe/smartest`
 - load files from ARGV
 - default glob `smartest/**/*_test.rb`
+- print scaffold guidance and exit 1 when the default run is requested before
+  `smartest/` exists
+- expand directory path arguments such as `smartest/` to `**/*_test.rb` files
+  under that directory
 - support `path:line` and `path:start-end` filters that run tests whose `test`
   blocks contain or intersect the lines
 - add `smartest/` to the load path before loading tests

data/README.md

@@ -123,12 +123,34 @@ bundle exec smartest
 By default, Smartest loads `smartest/**/*_test.rb`, so a separate `test/`
 directory can remain available for Minitest.
 
+If `smartest/` does not exist yet and no explicit paths are passed, Smartest
+prints scaffold commands instead of attempting a default test run:
+
+```text
+No smartest/ directory found.
+
+To create a Smartest test scaffold:
+  bundle exec smartest --init
+
+For browser tests:
+  bundle exec smartest --init-browser
+
+See all commands:
+  bundle exec smartest --help
+```
+
 You can also pass explicit paths:
 
 ```bash
+bundle exec smartest smartest/suite1/
 bundle exec smartest smartest/**/*_test.rb
+bundle exec smartest smartest/user_test.rb
 ```
 
+A directory path is expanded to `**/*_test.rb` under that directory, so
+`bundle exec smartest smartest/suite1/` is equivalent to
+`bundle exec smartest smartest/suite1/**/*_test.rb`.
+
 To run tests by line number, append `:line` or `:start-end` to the file path.
 Smartest runs tests whose `test` blocks contain or intersect the selected lines:
 
@@ -152,6 +174,18 @@ bundle exec smartest --help
 bundle exec smartest --version
 ```
 
+The help output lists common commands, including default runs, directory runs,
+single-file runs, line-filtered runs, and scaffold generation:
+
+```bash
+bundle exec smartest
+bundle exec smartest smartest/suite1/
+bundle exec smartest smartest/user_test.rb
+bundle exec smartest smartest/user_test.rb:12
+bundle exec smartest --init
+bundle exec smartest --init-browser
+```
+
 Output resembles:
 
 ```text
@@ -639,13 +673,13 @@ end
 Use `simple_stub(Time, :now) { fixed_time }` for singleton methods such as class
 methods.
 
-Use `simple_stub_const("AppConfig::PAYMENT_PROVIDER", "fake") { ... }` for
+Use `with_stub_const("AppConfig::PAYMENT_PROVIDER", "fake") { ... }` for
 constants in test bodies, `around_test`, or `around_suite`. Constant stubs are
 process-global; avoid concurrent tests that stub the same constant.
 
 The method stub helpers call `Smartest::SimpleStub` internally, apply the stub,
 register `cleanup { stub.reset }`, and return the stub object.
-`simple_stub_const` records the previous constant value, replaces it, yields to
+`with_stub_const` records the previous constant value, replaces it, yields to
 the block, and restores or removes the constant with `ensure`.
 
 `Smartest::SimpleStub#apply` and `#reset` are idempotent in the current Fiber.

data/SMARTEST_DESIGN.md

@@ -856,7 +856,24 @@ If no paths are given:
 bundle exec smartest
 ```
 
-should default to:
+should default to `smartest/**/*_test.rb` when `smartest/` exists. If the
+directory does not exist, the CLI should print scaffold guidance and exit with
+status `1`:
+
+```text
+No smartest/ directory found.
+
+To create a Smartest test scaffold:
+  bundle exec smartest --init
+
+For browser tests:
+  bundle exec smartest --init-browser
+
+See all commands:
+  bundle exec smartest --help
+```
+
+Default paths:
 
 ```text
 smartest/**/*_test.rb
@@ -877,8 +894,8 @@ arguments.files.each { |file| load File.expand_path(file) }
 exit Smartest::Runner.new(tests: arguments.select_tests(Smartest.suite.tests)).run
 ```
 
-`Smartest::CLIArguments` should support file paths, shell globs, `path:line`,
-and `path:start-end` filters.
+`Smartest::CLIArguments` should support file paths, directory paths, shell
+globs, `path:line`, and `path:start-end` filters.
 
 `smartest/autorun` should use `at_exit`.
 

data/exe/smartest

@@ -7,18 +7,51 @@ require "smartest"
 
 usage = <<~USAGE
   Usage:
-    smartest [--profile N] [paths...]
-    smartest [--profile N] path/to/test_file.rb:line[-line]
-    smartest --init
-    smartest --init-browser
-    smartest --version
-    smartest --help
-
-  When no paths are given, Smartest loads smartest/**/*_test.rb.
-  Smartest prints the 5 slowest tests after the run by default.
-  Use --profile N to choose how many slowest tests are printed.
+    bundle exec smartest [options] [paths...]
+
+  Common commands:
+    bundle exec smartest
+        Run tests under smartest/**/*_test.rb
+
+    bundle exec smartest smartest/suite1/
+        Run test files matching smartest/suite1/**/*_test.rb
+
+    bundle exec smartest smartest/user_test.rb
+        Run one test file
+
+    bundle exec smartest smartest/user_test.rb:12
+        Run tests around line 12
+
+    bundle exec smartest --init
+        Generate a basic Smartest scaffold
+
+    bundle exec smartest --init-browser
+        Generate a Playwright browser-test scaffold
+
+  Options:
+    --profile N
+        Print the N slowest tests. Defaults to 5.
+
+    --version, -v
+        Print the installed Smartest version.
+
+    --help, -h
+        Print this help.
 USAGE
 
+missing_smartest_directory_message = <<~MESSAGE
+  No smartest/ directory found.
+
+  To create a Smartest test scaffold:
+    bundle exec smartest --init
+
+  For browser tests:
+    bundle exec smartest --init-browser
+
+  See all commands:
+    bundle exec smartest --help
+MESSAGE
+
 command = :run
 
 begin
@@ -45,10 +78,16 @@ begin
   Smartest.disable_autorun!
   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)
 
   arguments = Smartest::CLIArguments.new(ARGV)
 
+  if arguments.default_paths? && !Dir.exist?(test_load_path)
+    puts missing_smartest_directory_message
+    exit 1
+  end
+
+  $LOAD_PATH.unshift(test_load_path) if Dir.exist?(test_load_path) && !$LOAD_PATH.include?(test_load_path)
+
   arguments.files.each do |file|
     load File.expand_path(file)
   end

data/lib/smartest/cli_arguments.rb

@@ -5,6 +5,7 @@ require "set"
 module Smartest
   class CLIArguments
     DEFAULT_PROFILE_COUNT = 5
+    DEFAULT_PATHS = ["smartest/**/*_test.rb"].freeze
 
     attr_reader :files, :line_filters, :profile_count
 
@@ -13,15 +14,25 @@ module Smartest
       @whole_files = Set.new
       @line_filters = Hash.new { |hash, key| hash[key] = Set.new }
       @profile_count = DEFAULT_PROFILE_COUNT
+      @default_paths = false
 
       paths = extract_options(argv)
-      parse_paths(paths.empty? ? ["smartest/**/*_test.rb"] : paths)
+      if paths.empty?
+        @default_paths = true
+        paths = DEFAULT_PATHS
+      end
+
+      parse_paths(paths)
     end
 
     def filter_tests?
       @line_filters.any?
     end
 
+    def default_paths?
+      @default_paths
+    end
+
     def select_tests(tests)
       return tests unless filter_tests?
 
@@ -64,8 +75,7 @@ module Smartest
     def parse_paths(paths)
       paths.each do |argument|
         pattern, line_filter = split_line_filter(argument)
-        matches = Dir[pattern]
-        files = matches.empty? ? [pattern] : matches
+        files = expand_path_pattern(pattern)
 
         files.each do |file|
           @files << file
@@ -82,6 +92,19 @@ module Smartest
       @files.uniq!
     end
 
+    def expand_path_pattern(pattern)
+      matches = Dir[pattern]
+      return [pattern] if matches.empty?
+
+      matches.flat_map do |match|
+        if File.directory?(match)
+          Dir[File.join(match, "**", "*_test.rb")]
+        else
+          match
+        end
+      end
+    end
+
     def split_line_filter(argument)
       match = argument.match(/\A(.+):(\d+)(?:-(\d+))?\z/)
       return [argument, nil] unless match

data/lib/smartest/constant_stub_helpers.rb

@@ -4,10 +4,10 @@ module Smartest
   module ConstantStubHelpers
     private
 
-    def simple_stub_const(constant_path, value)
-      raise ArgumentError, "simple_stub_const block is required" unless block_given?
+    def with_stub_const(constant_path, value)
+      raise ArgumentError, "with_stub_const block is required" unless block_given?
 
-      owner, constant_name = resolve_simple_stub_constant(constant_path)
+      owner, constant_name = resolve_with_stub_constant(constant_path)
       original_defined = owner.const_defined?(constant_name, false)
       original_value = owner.const_get(constant_name, false) if original_defined
 
@@ -22,7 +22,7 @@ module Smartest
       end
     end
 
-    def resolve_simple_stub_constant(constant_path)
+    def resolve_with_stub_constant(constant_path)
       unless constant_path.is_a?(String) || constant_path.is_a?(Symbol)
         raise ArgumentError, "constant path must be a String or Symbol"
       end

data/lib/smartest/fixture.rb

@@ -2,7 +2,7 @@
 
 module Smartest
   class Fixture
-    RESERVED_CONTEXT_METHODS = %i[skip pending simple_stub_const].freeze
+    RESERVED_CONTEXT_METHODS = %i[skip pending with_stub_const].freeze
 
     class << self
       def fixture(name, scope: :test, &block)

data/lib/smartest/version.rb

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

data/smartest/simple_stub_test.rb

@@ -158,8 +158,8 @@ test("simple_stub applies and resets singleton methods from fixture cleanup") do
   expect(status).to eq(0)
 end
 
-test("simple_stub_const applies and resets existing constants in test body blocks") do
-  result = simple_stub_const("SimpleStubSelfTestConfig::PROVIDER", :stubbed_provider) do
+test("with_stub_const applies and resets existing constants in test body blocks") do
+  result = with_stub_const("SimpleStubSelfTestConfig::PROVIDER", :stubbed_provider) do
     expect(SimpleStubSelfTestConfig::PROVIDER).to eq(:stubbed_provider)
     :block_result
   end
@@ -168,17 +168,17 @@ test("simple_stub_const applies and resets existing constants in test body block
   expect(SimpleStubSelfTestConfig::PROVIDER).to eq(:original_provider)
 end
 
-test("simple_stub_const removes newly defined constants after test body blocks") do
-  simple_stub_const("SimpleStubSelfTestConfig::MISSING_PROVIDER", :stubbed_missing_provider) do
+test("with_stub_const removes newly defined constants after test body blocks") do
+  with_stub_const("SimpleStubSelfTestConfig::MISSING_PROVIDER", :stubbed_missing_provider) do
     expect(SimpleStubSelfTestConfig::MISSING_PROVIDER).to eq(:stubbed_missing_provider)
   end
 
   expect(SimpleStubSelfTestConfig.const_defined?(:MISSING_PROVIDER, false)).to eq(false)
 end
 
-test("simple_stub_const restores constants when the block raises") do
+test("with_stub_const restores constants when the block raises") do
   error = SimpleStubSelfTest.capture_error(RuntimeError) do
-    simple_stub_const("SimpleStubSelfTestConfig::PROVIDER", :stubbed_provider) do
+    with_stub_const("SimpleStubSelfTestConfig::PROVIDER", :stubbed_provider) do
       expect(SimpleStubSelfTestConfig::PROVIDER).to eq(:stubbed_provider)
       raise "stubbed block failed"
     end
@@ -188,18 +188,18 @@ test("simple_stub_const restores constants when the block raises") do
   expect(SimpleStubSelfTestConfig::PROVIDER).to eq(:original_provider)
 end
 
-test("simple_stub_const requires a block") do
+test("with_stub_const requires a block") do
   error = SimpleStubSelfTest.capture_error(ArgumentError) do
-    simple_stub_const("SimpleStubSelfTestConfig::PROVIDER", :stubbed_provider)
+    with_stub_const("SimpleStubSelfTestConfig::PROVIDER", :stubbed_provider)
   end
 
-  expect(error.message).to eq("simple_stub_const block is required")
+  expect(error.message).to eq("with_stub_const block is required")
 end
 
-test("simple_stub_const wraps around_test hooks") do
+test("with_stub_const wraps around_test hooks") do
   suite = Smartest::Suite.new
   suite.around_test_hooks << proc do |test_run|
-    simple_stub_const("SimpleStubSelfTestConfig::PROVIDER", :around_test_provider) do
+    with_stub_const("SimpleStubSelfTestConfig::PROVIDER", :around_test_provider) do
       test_run.run
     end
   end
@@ -216,10 +216,10 @@ test("simple_stub_const wraps around_test hooks") do
   expect(SimpleStubSelfTestConfig::PROVIDER).to eq(:original_provider)
 end
 
-test("simple_stub_const wraps around_suite hooks") do
+test("with_stub_const wraps around_suite hooks") do
   suite = Smartest::Suite.new
   suite.around_suite_hooks << proc do |suite_run|
-    simple_stub_const("SimpleStubSelfTestConfig::PROVIDER", :around_suite_provider) do
+    with_stub_const("SimpleStubSelfTestConfig::PROVIDER", :around_suite_provider) do
       suite_run.run
     end
   end
@@ -236,10 +236,10 @@ test("simple_stub_const wraps around_suite hooks") do
   expect(SimpleStubSelfTestConfig::PROVIDER).to eq(:original_provider)
 end
 
-test("simple_stub_const is not available inside fixture blocks") do
+test("with_stub_const is not available inside fixture blocks") do
   fixture_class = Class.new(Smartest::Fixture) do
     fixture :bad_constant_stub do
-      simple_stub_const("SimpleStubSelfTestConfig::PROVIDER", :fixture_provider) { :fixture_provider }
+      with_stub_const("SimpleStubSelfTestConfig::PROVIDER", :fixture_provider) { :fixture_provider }
     end
   end
 
@@ -251,7 +251,7 @@ test("simple_stub_const is not available inside fixture blocks") do
 
   expect(status).to eq(1)
   expect(output).to include("NoMethodError")
-  expect(output).to include("simple_stub_const")
+  expect(output).to include("with_stub_const")
   expect(SimpleStubSelfTestConfig::PROVIDER).to eq(:original_provider)
 end
 

data/smartest/smartest_test.rb

@@ -1435,6 +1435,44 @@ test("cli loads files and returns failure status") do
   end
 end
 
+test("cli expands directory paths to tests under that directory") do
+  Dir.mktmpdir do |dir|
+    smartest_dir = File.join(dir, "smartest")
+    FileUtils.mkdir_p(File.join(smartest_dir, "nested"))
+    File.write(File.join(smartest_dir, "test_helper.rb"), <<~RUBY)
+      require "smartest/autorun"
+    RUBY
+    File.write(File.join(smartest_dir, "root_test.rb"), <<~RUBY)
+      require "test_helper"
+
+      test("root directory test") do
+        expect(1).to eq(1)
+      end
+    RUBY
+    File.write(File.join(smartest_dir, "nested", "nested_test.rb"), <<~RUBY)
+      require "test_helper"
+
+      test("nested directory test") do
+        expect(2).to eq(2)
+      end
+    RUBY
+
+    stdout, stderr, status = Open3.capture3(
+      { "RUBYLIB" => File.expand_path("../lib", __dir__) },
+      "ruby",
+      File.expand_path("../exe/smartest", __dir__),
+      "smartest/",
+      chdir: dir
+    )
+
+    expect(status.success?).to eq(true)
+    expect(stderr).to eq("")
+    expect(stdout).to include("root directory test")
+    expect(stdout).to include("nested directory test")
+    expect(stdout).to include("2 tests, 2 passed, 0 failed")
+  end
+end
+
 test("cli loads matcher files registered in test helper") do
   Dir.mktmpdir do |dir|
     smartest_dir = File.join(dir, "smartest")
@@ -1656,14 +1694,61 @@ test("cli prints help") do
   expect(status.success?).to eq(true)
   expect(stderr).to eq("")
   expect(stdout).to include("Usage:")
-  expect(stdout).to include("smartest [--profile N] [paths...]")
-  expect(stdout).to include("smartest [--profile N] path/to/test_file.rb:line[-line]")
-  expect(stdout).to include("smartest --init")
-  expect(stdout).to include("smartest --init-browser")
-  expect(stdout).to include("Use --profile N")
+  expect(stdout).to include("bundle exec smartest [options] [paths...]")
+  expect(stdout).to include("Common commands:")
+  expect(stdout).to include("bundle exec smartest smartest/suite1/")
+  expect(stdout).to include("Run test files matching smartest/suite1/**/*_test.rb")
+  expect(stdout).to include("bundle exec smartest smartest/user_test.rb")
+  expect(stdout).to include("bundle exec smartest smartest/user_test.rb:12")
+  expect(stdout).not_to include("bundle exec smartest smartest/example_browser_test.rb")
+  expect(stdout).not_to include("Run a browser test file")
+  expect(stdout).to include("bundle exec smartest --init")
+  expect(stdout).to include("bundle exec smartest --init-browser")
+  expect(stdout).to include("--profile N")
   expect(stdout).to include("smartest/**/*_test.rb")
 end
 
+test("cli explains how to initialize when default smartest directory is missing") do
+  Dir.mktmpdir do |dir|
+    stdout, stderr, status = Open3.capture3(
+      { "RUBYLIB" => File.expand_path("../lib", __dir__) },
+      "ruby",
+      File.expand_path("../exe/smartest", __dir__),
+      chdir: dir
+    )
+
+    expect(status.success?).to eq(false)
+    expect(stderr).to eq("")
+    expect(stdout).to include("No smartest/ directory found.")
+    expect(stdout).to include("bundle exec smartest --init")
+    expect(stdout).to include("bundle exec smartest --init-browser")
+    expect(stdout).to include("bundle exec smartest --help")
+  end
+end
+
+test("cli still runs explicit paths when default smartest directory is missing") do
+  Dir.mktmpdir do |dir|
+    File.write(File.join(dir, "sample_test.rb"), <<~RUBY)
+      test("explicit path") do
+        expect(1).to eq(1)
+      end
+    RUBY
+
+    stdout, stderr, status = Open3.capture3(
+      { "RUBYLIB" => File.expand_path("../lib", __dir__) },
+      "ruby",
+      File.expand_path("../exe/smartest", __dir__),
+      "sample_test.rb",
+      chdir: dir
+    )
+
+    expect(status.success?).to eq(true)
+    expect(stderr).to eq("")
+    expect(stdout).to include("explicit path")
+    expect(stdout).to include("1 test, 1 passed, 0 failed")
+  end
+end
+
 test("--profile prints the slowest tests with default count of 5") do
   output = StringIO.new
   reporter = Smartest::Reporter.new(output, profile_count: 5)
@@ -1760,7 +1845,9 @@ test("CLIArguments defaults profile count and parses --profile N") do
 
   expect(arguments.profile_count).to eq(5)
   expect(arguments.files).to eq(Dir["smartest/**/*_test.rb"])
+  expect(arguments.default_paths?).to eq(true)
   expect(Smartest::CLIArguments.new(["--profile", "3"]).profile_count).to eq(3)
+  expect(Smartest::CLIArguments.new(["smartest/foo_test.rb"]).default_paths?).to eq(false)
 end
 
 test("CLIArguments leaves unsupported profile forms as paths") do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smartest
 version: !ruby/object:Gem::Version
-  version: 0.3.3.alpha4
+  version: 0.4.0
 platform: ruby
 authors:
 - Yusuke Iwaki
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-04 00:00:00.000000000 Z
+date: 2026-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -97,9 +97,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.7'
 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: