feat(*): add --name option to single out individual test(s)

busted/modules/cli.lua

@@ -129,6 +129,7 @@ return function(options)
   cli:option('-t, --tags=TAGS', 'only run tests with these #tags', {}, processList)
   cli:option('--exclude-tags=TAGS', 'do not run tests with these #tags, takes precedence over --tags', {}, processList)
   cli:option('--filter=PATTERN', 'only run test names matching the Lua pattern', {}, processMultiOption)
+  cli:option('--name=NAME', 'run test with the given full name', {}, processMultiOption)
   cli:option('--filter-out=PATTERN', 'do not run test names matching the Lua pattern, takes precedence over --filter', {}, processMultiOption)
   cli:option('--exclude-names-file=FILE', 'do not run the tests with names listed in the given file, takes precedence over --filter', nil, processOption)
   cli:option('--log-success=FILE', 'append the name of each successful test to the given file', nil, processOption)

busted/modules/filter_loader.lua

@@ -62,6 +62,15 @@ return function()
       return nil, true
     end
 
+    local name = function(name)
+      for _, candidate in pairs(options.name) do
+        if string.find(candidate, getFullName(name), 1, true) then
+          return nil, true
+        end
+      end
+      return nil, (#options.name == 0)
+    end
+
     local filterNames = function(name)
       for _, filter in pairs(options.filter) do
         if getFullName(name):find(filter) ~= nil then
@@ -139,8 +148,9 @@ return function()
 
     -- The following filters are applied in reverse order
     applyFilter({ 'it', 'pending' }            , 'filter'          , filterNames           )
+    applyFilter({ 'describe', 'it', 'pending' }, 'name'            , name                  )
     applyFilter({ 'describe', 'it', 'pending' }, 'filterOut'       , filterOutNames        )
-    applyFilter({ 'describe', 'it', 'pending' }, 'excludeNamesFile', excludeNamesFile)
+    applyFilter({ 'describe', 'it', 'pending' }, 'excludeNamesFile', excludeNamesFile      )
     applyFilter({ 'it', 'pending' }            , 'tags'            , filterTags            )
     applyFilter({ 'describe', 'it', 'pending' }, 'excludeTags'     , filterExcludeTags     )
   end

busted/runner.lua

@@ -181,6 +181,7 @@ return function(options)
     tags = cliArgs.tags,
     excludeTags = cliArgs['exclude-tags'],
     filter = cliArgs.filter,
+    name = cliArgs.name,
     filterOut = cliArgs['filter-out'],
     excludeNamesFile = cliArgs['exclude-names-file'],
     list = cliArgs.list,

completions/bash/busted.bash

@@ -136,7 +136,7 @@ _busted() {
       # no completion available
       return 0
       ;;
-    --filter|--filter-out)
+    --filter|--filter-out|--name)
       # no completion available
       return 0
       ;;
@@ -179,6 +179,7 @@ _busted() {
       --lua=
       --ignore-lua
       --filter= --filter-out=
+      --name=
       --exclude-names-file=
       --repeat=
       --seed=

completions/zsh/_busted

@@ -57,6 +57,7 @@ _busted_args=(
 "--filter=[Only run test names matching the Lua pattern]: :"
 "--filter-out=[Do not run test names matching the Lua pattern, takes precedence over --filter]: :"
 "--exclude-names-file=[Do not run the tests with names listed in the given file, takes precedence over --filter]:files:_files"
+"--name=[Run test with the given full name]:files:_files"
 "--log-success=[Append the name of each successful test to the given file]:file:_files"
 "-e[Execute Lua statement]: :"
 "(-v --verbose --no-verbose)"{-v,--verbose}"[Verbose output of errors]"

spec/cl_spec.lua

@@ -145,12 +145,12 @@ describe('Tests the busted command-line options', function()
 
   it('tests running with --log-success and --exclude-names-file specified', function ()
     local logfile = os.tmpname()
-    local success, errcnt, out, err = executeBusted('--pattern=_filter.lua$ --log-success=' .. logfile .. ' --exclude-names-file=' .. logfile)
+    local success, errcnt, out = executeBusted('--pattern=_filter.lua$ --log-success=' .. logfile .. ' --exclude-names-file=' .. logfile)
     assert.is_false(success)
     assert.equals(8, errcnt)
     assert.equals(2, count_successes(out))
     -- re-run tests with previously successful tests skipped
-    success, errcnt, out, err = executeBusted('--pattern=_filter.lua$ --log-success=' .. logfile .. ' --exclude-names-file=' .. logfile)
+    success, errcnt, out = executeBusted('--pattern=_filter.lua$ --log-success=' .. logfile .. ' --exclude-names-file=' .. logfile)
     assert.is_false(success)
     assert.equals(8, errcnt)
     assert.equals(0, count_successes(out))