smartest 0.1.0.alpha1 → 0.1.0.alpha2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4b99c1edbf3ad101277d9c87de980708ffe37b5665a3b151be6f03803d4837a
-  data.tar.gz: 6c0d645bd34ccedc0df9ef4fdacb9c3b43133bee5a0f6172ab73c5d9b44c05d1
+  metadata.gz: 0bd00e8f67e5e3b8fd9931ade12ab688147fb68858b3bf614b2f6aa103b4849d
+  data.tar.gz: d3d7293dc006d7ddeafb406c66ef2dd6341af47e6f4cb1ed07f09a0f06667741
 SHA512:
-  metadata.gz: 567e14909b4fd63fe70392014d5f41d964e078ac7f16c46ff64071ae6860eb0eabdad3b1c2c409e51b52ce440b487b2531897ceee40f4d6de5dc79a6eb6297a5
-  data.tar.gz: ca377cc64560272f1d75f5527ce10014771bf728500d8489abb6a68a6e285c30c1f587b4a24f47a871ead56033a8fb6b4225dbe60c226c6b1288a1d5cdc509fe
+  metadata.gz: 9cc36fee51acacabb449c0e8973e92530cd0707a434ed1216db9318378b41473a0ce688e63eb02571da90c72e34874983740907eb93086ff9b5e0c9b9b128df6
+  data.tar.gz: 59b6db66b22561660b93608a843313e38569a9eb634286e54539c434052745637773bf1f3e2f86114c5115d1981330471e279cad637577df5e748e26bd186308

data/DEVELOPMENT.md

@@ -613,6 +613,8 @@ A practical approach:
 - `exe/smartest`
 - load files from ARGV
 - default glob `smartest/**/*_test.rb`
+- 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
 - generate a `smartest/test_helper.rb` that loads `smartest/fixtures/**/*.rb`
 - exit code 0 on success, 1 on failure

data/README.md

@@ -88,6 +88,14 @@ You can also pass explicit paths:
 bundle exec smartest smartest/**/*_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:
+
+```bash
+bundle exec smartest smartest/user_test.rb:12
+bundle exec smartest smartest/user_test.rb:3-12
+```
+
 CLI help and version output are available with:
 
 ```bash

data/SMARTEST_DESIGN.md

@@ -794,15 +794,19 @@ CLI flow:
 ```ruby
 require "smartest"
 
-Kernel.include Smartest::DSL
+Smartest.disable_autorun!
+Kernel.prepend Smartest::DSL
 $LOAD_PATH.unshift File.expand_path("smartest", Dir.pwd)
 
-files = ARGV.empty? ? Dir["smartest/**/*_test.rb"] : ARGV
-files.each { |file| require File.expand_path(file) }
+arguments = Smartest::CLIArguments.new(ARGV)
+arguments.files.each { |file| load File.expand_path(file) }
 
-exit Smartest::Runner.new.run
+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/autorun` should use `at_exit`.
 
 ```ruby

data/exe/smartest

@@ -8,6 +8,7 @@ require "smartest"
 usage = <<~USAGE
   Usage:
     smartest [paths...]
+    smartest path/to/test_file.rb:line[-line]
     smartest --init
     smartest --version
     smartest --help
@@ -38,21 +39,13 @@ begin
   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)
 
-  files =
-    if ARGV.empty?
-      Dir["smartest/**/*_test.rb"]
-    else
-      ARGV.flat_map do |pattern|
-        matches = Dir[pattern]
-        matches.empty? ? [pattern] : matches
-      end.uniq
-    end
-
-  files.each do |file|
+  arguments = Smartest::CLIArguments.new(ARGV)
+
+  arguments.files.each do |file|
     load File.expand_path(file)
   end
 
-  exit Smartest::Runner.new.run
+  exit Smartest::Runner.new(tests: arguments.select_tests(Smartest.suite.tests)).run
 rescue Exception => error
   raise if Smartest.fatal_exception?(error)
 

data/lib/smartest/cli_arguments.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "set"
+
+module Smartest
+  class CLIArguments
+    attr_reader :files, :line_filters
+
+    def initialize(argv)
+      @files = []
+      @whole_files = Set.new
+      @line_filters = Hash.new { |hash, key| hash[key] = Set.new }
+
+      parse(argv.empty? ? ["smartest/**/*_test.rb"] : argv)
+    end
+
+    def filter_tests?
+      @line_filters.any?
+    end
+
+    def select_tests(tests)
+      return tests unless filter_tests?
+
+      tests.select do |test_case|
+        next false unless test_case.location
+
+        path = File.expand_path(test_case.location.path)
+        @whole_files.include?(path) ||
+          @line_filters.fetch(path, []).any? { |line_filter| test_case.includes_line_range?(line_filter) }
+      end
+    end
+
+    private
+
+    def parse(argv)
+      argv.each do |argument|
+        pattern, line_filter = split_line_filter(argument)
+        matches = Dir[pattern]
+        files = matches.empty? ? [pattern] : matches
+
+        files.each do |file|
+          @files << file
+
+          path = File.expand_path(file)
+          if line_filter
+            @line_filters[path].add(line_filter)
+          else
+            @whole_files.add(path)
+          end
+        end
+      end
+
+      @files.uniq!
+    end
+
+    def split_line_filter(argument)
+      match = argument.match(/\A(.+):(\d+)(?:-(\d+))?\z/)
+      return [argument, nil] unless match
+
+      start_line = match[2].to_i
+      end_line = match[3] ? match[3].to_i : start_line
+
+      [match[1], start_line..end_line]
+    end
+  end
+end

data/lib/smartest/runner.rb

@@ -2,9 +2,10 @@
 
 module Smartest
   class Runner
-    def initialize(suite: Smartest.suite, reporter: Reporter.new)
+    def initialize(suite: Smartest.suite, reporter: Reporter.new, tests: nil)
       @suite = suite
       @reporter = reporter
+      @tests = tests || suite.tests
     end
 
     def run
@@ -12,10 +13,10 @@ module Smartest
       suite_cleanup_errors = []
       @suite_fixture_set = nil
 
-      @reporter.start(@suite.tests.count)
+      @reporter.start(@tests.count)
 
       begin
-        @suite.tests.each do |test_case|
+        @tests.each do |test_case|
           result = run_one(test_case)
           results << result
           @reporter.record(result)

data/lib/smartest/test_case.rb

@@ -14,5 +14,51 @@ module Smartest
       @location = location
       @fixture_names = ParameterExtractor.required_keyword_names(block, usage: :test)
     end
+
+    def includes_line?(line)
+      includes_line_range?(line..line)
+    end
+
+    def includes_line_range?(range)
+      return false unless location
+
+      current_range = line_range
+      current_range.begin <= range.end && range.begin <= current_range.end
+    end
+
+    private
+
+    def line_range
+      location.lineno..end_lineno
+    end
+
+    def end_lineno
+      @end_lineno ||= inferred_end_lineno
+    end
+
+    def inferred_end_lineno
+      code_location = instruction_sequence_metadata[:code_location]
+      return code_location[2] if code_location&.length == 4
+
+      instruction_sequence_line_numbers.max || location.lineno
+    rescue StandardError
+      location.lineno
+    end
+
+    def instruction_sequence_metadata
+      return {} unless defined?(RubyVM::InstructionSequence)
+
+      sequence = RubyVM::InstructionSequence.of(block)
+      metadata = sequence&.to_a&.[](4)
+      metadata.is_a?(Hash) ? metadata : {}
+    end
+
+    def instruction_sequence_line_numbers
+      return [] unless defined?(RubyVM::InstructionSequence)
+
+      sequence = RubyVM::InstructionSequence.of(block)
+      body = sequence&.to_a&.last
+      body.is_a?(Array) ? body.select { |entry| entry.is_a?(Integer) } : []
+    end
   end
 end

data/lib/smartest/version.rb

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

data/lib/smartest.rb

@@ -19,6 +19,7 @@ require_relative "smartest/test_result"
 require_relative "smartest/reporter"
 require_relative "smartest/runner"
 require_relative "smartest/init_generator"
+require_relative "smartest/cli_arguments"
 
 module Smartest
   class << self

data/smartest/smartest_test.rb

@@ -477,6 +477,91 @@ test("cli loads files and returns failure status") do
   end
 end
 
+test("cli runs tests matching a file line filter") do
+  Dir.mktmpdir do |dir|
+    smartest_dir = File.join(dir, "smartest")
+    FileUtils.mkdir_p(smartest_dir)
+    File.write(File.join(smartest_dir, "test_helper.rb"), <<~RUBY)
+      require "smartest/autorun"
+    RUBY
+
+    test_file = File.join(smartest_dir, "sample_test.rb")
+    File.write(test_file, <<~RUBY)
+      require "test_helper"
+
+      test("line one") do
+        expect(1).to eq(1)
+      end
+
+      test("line two") do
+        expect(2).to eq(2)
+      end
+    RUBY
+    line_number = File.readlines(test_file).find_index { |line| line.include?("expect(2)") } + 1
+
+    stdout, stderr, status = Open3.capture3(
+      { "RUBYLIB" => File.expand_path("../lib", __dir__) },
+      "ruby",
+      File.expand_path("../exe/smartest", __dir__),
+      "smartest/sample_test.rb:#{line_number}",
+      chdir: dir
+    )
+
+    expect(status.success?).to eq(true)
+    expect(stderr).to eq("")
+    expect(stdout).to include("Running 1 test")
+    expect(stdout).not_to include("line one")
+    expect(stdout).to include("line two")
+    expect(stdout).to include("1 test, 1 passed, 0 failed")
+  end
+end
+
+test("cli runs tests intersecting a file line range filter") do
+  Dir.mktmpdir do |dir|
+    smartest_dir = File.join(dir, "smartest")
+    FileUtils.mkdir_p(smartest_dir)
+    File.write(File.join(smartest_dir, "test_helper.rb"), <<~RUBY)
+      require "smartest/autorun"
+    RUBY
+
+    test_file = File.join(smartest_dir, "sample_test.rb")
+    File.write(test_file, <<~RUBY)
+      require "test_helper"
+
+      test("range one") do
+        expect(1).to eq(1)
+      end
+
+      test("range two") do
+        expect(2).to eq(2)
+      end
+
+      test("range three") do
+        expect(3).to eq(3)
+      end
+    RUBY
+    lines = File.readlines(test_file)
+    start_line = lines.find_index { |line| line.include?("expect(1)") } + 1
+    end_line = lines.find_index { |line| line.include?("expect(2)") } + 1
+
+    stdout, stderr, status = Open3.capture3(
+      { "RUBYLIB" => File.expand_path("../lib", __dir__) },
+      "ruby",
+      File.expand_path("../exe/smartest", __dir__),
+      "smartest/sample_test.rb:#{start_line}-#{end_line}",
+      chdir: dir
+    )
+
+    expect(status.success?).to eq(true)
+    expect(stderr).to eq("")
+    expect(stdout).to include("Running 2 tests")
+    expect(stdout).to include("range one")
+    expect(stdout).to include("range two")
+    expect(stdout).not_to include("range three")
+    expect(stdout).to include("2 tests, 2 passed, 0 failed")
+  end
+end
+
 test("cli default suite ignores minitest-style test directory") do
   Dir.mktmpdir do |dir|
     smartest_dir = File.join(dir, "smartest")
@@ -541,6 +626,7 @@ test("cli prints help") do
   expect(stderr).to eq("")
   expect(stdout).to include("Usage:")
   expect(stdout).to include("smartest [paths...]")
+  expect(stdout).to include("smartest path/to/test_file.rb:line[-line]")
   expect(stdout).to include("smartest --init")
   expect(stdout).to include("smartest/**/*_test.rb")
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smartest
 version: !ruby/object:Gem::Version
-  version: 0.1.0.alpha1
+  version: 0.1.0.alpha2
 platform: ruby
 authors:
 - Yusuke Iwaki
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-26 00:00:00.000000000 Z
+date: 2026-04-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -42,6 +42,7 @@ files:
 - exe/smartest
 - lib/smartest.rb
 - lib/smartest/autorun.rb
+- lib/smartest/cli_arguments.rb
 - lib/smartest/dsl.rb
 - lib/smartest/errors.rb
 - lib/smartest/execution_context.rb