{"id":18697683,"url":"https://github.com/federicoceratto/nim-testrunner","last_synced_at":"2025-11-08T16:30:41.522Z","repository":{"id":144890777,"uuid":"81763210","full_name":"FedericoCeratto/nim-testrunner","owner":"FedericoCeratto","description":"Nim test runner","archived":false,"fork":false,"pushed_at":"2020-03-15T19:19:48.000Z","size":124,"stargazers_count":7,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-25T18:53:08.604Z","etag":null,"topics":["fswatch","functional-testing","nim","nim-lang","nim-language","tdd","test","testing","unit-testing","unittesting"],"latest_commit_sha":null,"homepage":null,"language":"Nim","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FedericoCeratto.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-02-12T22:40:52.000Z","updated_at":"2020-03-15T19:19:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"8ae9827b-4b4a-41ad-b5c5-c149e4c7ca36","html_url":"https://github.com/FedericoCeratto/nim-testrunner","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FedericoCeratto%2Fnim-testrunner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FedericoCeratto%2Fnim-testrunner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FedericoCeratto%2Fnim-testrunner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FedericoCeratto%2Fnim-testrunner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FedericoCeratto","download_url":"https://codeload.github.com/FedericoCeratto/nim-testrunner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239558925,"owners_count":19658929,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fswatch","functional-testing","nim","nim-lang","nim-language","tdd","test","testing","unit-testing","unittesting"],"created_at":"2024-11-07T11:25:18.667Z","updated_at":"2025-11-08T16:30:41.470Z","avatar_url":"https://github.com/FedericoCeratto.png","language":"Nim","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n== Test runner for Nim\n\nimage:https://circleci.com/gh/FedericoCeratto/nim-testrunner.svg?style=svg[\"CircleCI\", link=\"https://circleci.com/gh/FedericoCeratto/nim-testrunner\"]\nimage:https://img.shields.io/badge/status-beta-orange.svg[badge]\nimage:https://img.shields.io/github/tag/FedericoCeratto/nim-testrunner.svg[tags]\nimage:https://img.shields.io/badge/License-GPL%20v3-blue.svg[License]\n\nWelcome to Nim test runner.\nThis tool runs the Nim compiler against a set of source files.\nIt's meant to compile and run unittest files but it can also be used to compile other source files.\n\nIt supports globbing and can run tests automatically when source files are changed.\n\nGenerates reports in JUnit format.\n\nNOTE: File change monitoring and desktop notifications works only on Linux\n\n.Syntax:\n  testurunner ['test filename globbing'...] [-m [:'monitored filename globbing']] [ -- compiler flags]\n  testrunner 'tests/**/*.nim'\n  testrunner -m\n  testrunner -m:'*.nim' -- -p:.\n  testrunner mytest.nim 'tests/*.nim' -m:'**/*.nim' -d -- -d:ssl\n  testrunner (-h | --help)\n\n.Options:\n  -h --help       show help\n  -d --debug      debug mode\n  -m --monitor    without any argument, monitor **/*.nim\n  -m:'\u003cglob\u003e'     monitor globbing. Remember the colon \":\"\n  --basedir \u003cdir\u003e basedir\n  -c --conf       config file path\n  --nocolor       disable color and set NIMTEST_NO_COLOR=1\n  -o --norun      do not run test files, run \"nim c\" only\n  -q --nonotify   do not send desktop notifications (enabled only with -m on Linux)\n  --junit:\u003cfname\u003e write out JUnit summary (default: junit.xml)\n\nProtect globbings with single quotes.\n\nDouble asterisk matches nested subdirectories.\nE.g. `'tests/\\**/*.nim'` will match Nim files under tests/ and any subdirectory.\n\n(you might have to protect the asterisks from your shell using single quotes)\n\nAnything after \"--\" will be used as a compiler option for Nim.\n\nIf no test globs are passed, the following will be used:\n  `test_\\*.nim test/*.nim tests/*.nim`\n\nTestrunner will also parse .testrunner.conf if available, unless\na different config file is specified.\n\n\n=== Install testrunner:\n\n[source,bash]\n----\nnimble install testrunner\n----\n\nInstall fswatch library (OS-dependent) or build with testrunner using -d:nofswatch to disable fswatch support\n\n[source,bash]\n----\n# Debian and derivatives\nsudo apt-get install libfswatch11\n\n# MacPorts\nport install fswatch\n\n# Homebrew\nbrew install fswatch\n----\n\n=== Output examples\n\n.Success\nimage::example_success.gif[Success]\n\n'''\n\n.Failure\nimage::example_fail.gif[Success]\n\n'''\n\nContributions are welcome.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffedericoceratto%2Fnim-testrunner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffedericoceratto%2Fnim-testrunner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffedericoceratto%2Fnim-testrunner/lists"}