Add runner.

Author: fnando

.github/workflows/ruby.yml

@@ -0,0 +1,62 @@
+---
+name: ruby-tests
+
+on:
+  pull_request_target:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+    inputs: {}
+
+jobs:
+  build:
+    name: Tests with Ruby ${{ matrix.ruby }} and ${{ matrix.gemfile }}
+    runs-on: "ubuntu-latest"
+    if: |
+      github.actor == 'dependabot[bot]' && github.event_name == 'pull_request_target' ||
+      github.actor != 'dependabot[bot]'
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ["3.4", "3.3"]
+        gemfile:
+          - Gemfile
+    services:
+      redis:
+        image: redis
+        ports:
+          - 6379:6379
+        options: >-
+          --health-cmd "redis-cli ping" --health-interval 10s --health-timeout
+          5s --health-retries 5
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/cache@v4
+        with:
+          path: vendor/bundle
+          key: >
+            ${{ runner.os }}-${{ matrix.ruby }}-gems-${{
+            hashFiles(matrix.gemfile) }}-${{hashFiles('zee.gemspec')}}
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+
+      - name: Install gem dependencies
+        env:
+          BUNDLE_GEMFILE: ${{ matrix.gemfile }}
+        run: |
+          gem install bundler
+          bundle config set with default:development:test
+          bundle config path vendor/bundle
+          bundle update --jobs 4 --retry 3
+
+      - name: Run Tests
+        env:
+          BUNDLE_GEMFILE: ${{ matrix.gemfile }}
+        run: |
+          bundle exec rake

.rubocop.yml

@@ -3,7 +3,7 @@ inherit_gem:
   rubocop-fnando: .rubocop.yml
 
 AllCops:
-  TargetRubyVersion: 3.2
+  TargetRubyVersion: 3.3
 
 Style/GlobalVars:
   Exclude:

README.md

@@ -32,7 +32,7 @@ methods like the following:
 
 ```ruby
 class SampleTest < Minitest::Test
-  test 'useless test' do
+  test "useless test" do
     assert true
   end
 end
@@ -55,7 +55,45 @@ class SampleTest < Minitest::Test
     DB.disconnect
   end
 
-  test 'useless test' do
+  test "useless test" do
+    assert true
+  end
+end
+```
+
+If you want to skip slow tests, you can use the `slow_test` method, which only
+runs the test when `MT_RUN_SLOW_TESTS` environment variable is set.
+
+```ruby
+# Only run slow tests in CI. You can bypass it locally by using
+# something like `MT_RUN_SLOW_TESTS=1 rake`.
+ENV["MT_RUN_SLOW_TESTS"] ||= ENV["CI"]
+
+class SampleTest < Minitest::Test
+  test "useless test" do
+    slow_test
+    sleep 1
+    assert true
+  end
+end
+```
+
+You can change the default threshold by setting `Minitest::Test.slow_threshold`.
+The default value is `0.1` (100ms).
+
+```ruby
+Minitest::Test.slow_threshold = 0.1
+```
+
+This config can also be changed per class:
+
+```ruby
+class SampleTest < Minitest::Test
+  self.slow_threshold = 0.1
+
+  test "useless test" do
+    slow_test
+    sleep 1
     assert true
   end
 end
@@ -65,14 +103,30 @@ Finally, you can also use `let`.
 
 ```ruby
 class SampleTest < Minitest::Test
-  let(:token) { 'secret' }
+  let(:token) { "secret" }
 
-  test 'set token' do
-    assert_equal 'secret', token
+  test "set token" do
+    assert_equal "secret", token
   end
 end
 ```
 
+## Running tests
+
+`minitest-utils` comes with a runner: `mt`.
+
+```
+
+```
+
+It supports `.minitestignore`, which only matches file names partially. Comments
+starting with `#` are ignored.
+
+```
+# Ignore all tests in test/fixtures
+test/fixtures
+```
+
 ## Screenshots
 
 ![](https://raw.githubusercontent.com/fnando/minitest-utils/main/screenshots/light-failing.png)

exe/mt

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/minitest/utils/cli"
+Minitest::Utils::CLI.loaded_via_bundle_exec = ENV.key?("BUNDLER_VERSION")
+Minitest::Utils::CLI.new(ARGV.dup).start

lib/minitest/utils.rb

@@ -3,12 +3,11 @@
 module Minitest
   module Utils
     require "minitest"
-    require "benchmark"
     require "pathname"
-    require "minitest/utils/version"
-    require "minitest/utils/reporter"
-    require "minitest/utils/extension"
-    require "minitest/utils/test_notifier_reporter"
+    require_relative "utils/version"
+    require_relative "utils/reporter"
+    require_relative "utils/extension"
+    require_relative "utils/test_notifier_reporter"
 
     load_lib = lambda do |path, &block|
       require path
@@ -23,21 +22,21 @@ module Utils
     load_lib.call "capybara"
 
     load_lib.call "webmock" do
-      require "minitest/utils/setup/webmock"
+      require_relative "utils/setup/webmock"
     end
 
     load_lib.call "database_cleaner" do
-      require "minitest/utils/setup/database_cleaner"
+      require_relative "utils/setup/database_cleaner"
     end
 
     load_lib.call "factory_girl" do
-      require "minitest/utils/setup/factory_girl"
+      require_relative "utils/setup/factory_girl"
     end
 
     load_lib.call "factory_bot" do
-      require "minitest/utils/setup/factory_bot"
+      require_relative "utils/setup/factory_bot"
     end
 
-    require "minitest/utils/railtie" if defined?(Rails)
+    require_relative "utils/railtie" if defined?(Rails)
   end
 end