Extract test runner executable

Simon Coffey · Simon Coffey · commit 4eaf5140ee10 · 2023-02-06T20:40:15.000Z
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -81,6 +81,18 @@ In order to ensure high quality, all pull requests must meet these requirements:
   * The entire test suite must pass when `bundle exec rake default` is run from the
     project's local working copy.
 
+While working on specific features you can run individual test files or
+a group of tests using `bin/test`:
+
+    # run a single file:
+    $ bin/test tests/units/test_object.rb
+
+    # run multiple files:
+    $ bin/test tests/units/test_object.rb tests/units/test_archive.rb
+
+    # run all unit tests:
+    $ bin/test
+
 ### Continuous integration
   * All tests must pass in the project's [GitHub Continuous Integration build](https://github.com/ruby-git/ruby-git/actions?query=workflow%3ACI)
     before the pull request will be merged.
diff --git a/Rakefile b/Rakefile
@@ -7,18 +7,14 @@ default_tasks = []
 
 desc 'Run Unit Tests'
 task :test do
-  sh 'git config --global user.email "git@example.com"' if `git config user.email`.empty?
-  sh 'git config --global user.name "GitExample"' if `git config user.name`.empty?
+  sh 'bin/test'
 
-  $LOAD_PATH.unshift(File.join(__dir__, 'tests'))
-
-  Dir.glob(File.join(__dir__, 'tests/**/test_*.rb')) do |p|
-    require p
-  end
-
-  # You can run individual test files from the command line with:
+  # You can run individual test files (or multiple files) from the command
+  # line with:
+  #
+  # $ bin/test tests/units/test_archive.rb
   #
-  # $ ruby -Ilib:tests tests/units/test_archive.rb
+  # $ bin/test tests/units/test_archive.rb tests/units/test_object.rb
 end
 default_tasks << :test
 
diff --git a/bin/test b/bin/test
@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+
+`git config --global user.email "git@example.com"` if `git config user.email`.empty?
+`git config --global user.name "GitExample"` if `git config user.name`.empty?
+
+project_root = File.expand_path(File.join(__dir__, '..'))
+
+$LOAD_PATH.unshift(File.join(project_root, 'tests'))
+
+if ARGV.empty?
+  paths = Dir.glob(File.join(project_root, 'tests/**/test_*.rb'))
+else
+  paths = ARGV.map { |p| File.join(project_root, p) }
+end
+
+paths.each { |p| require p }
