NOSE2-3(1)

πŸŽ€ NAME πŸŽ€

okay bestie, this is the manual for nose2-3 β€” yes, that's literally the whole name, iconic minimalism fr fr πŸ’…


✨ DESCRIPTION ✨

so nose2-3 is your test runner and here's how you talk to it, no cap:

usage: nose2 [-s START_DIR] [-t TOP_LEVEL_DIRECTORY] [--config [CONFIG]]
       [--no-user-config] [--no-plugins] [--plugin PLUGINS]
       [--exclude-plugin EXCLUDE_PLUGINS] [--verbosity VERBOSITY]
       [--verbose] [--quiet] [--log-level LOG_LEVEL] [-B] [--coverage
       PATH] [--coverage-report TYPE] [--coverage-config FILE] [-C] [-D]
       [-F] [--pretty-assert] [-h] [testNames ...]

🫢 positional arguments 🫢

  • testNames β€” the names of the tests you wanna run, just tell them straight up πŸ’–

πŸ‘‘ options πŸ‘‘

  • -s, --start-dir START_DIR β€” the directory where discovery kicks off (defaults to '.') 🌸
  • -t, --top-level-directory, --project-directory TOP_LEVEL_DIRECTORY β€” the top level directory of your project (and yeah, it defaults to the start dir) ✨
  • --config, -c [CONFIG] β€” config files to load, if they exist. and if you don't say anything? the default is 'unittest.cfg' and 'nose2.cfg' in the start directory, periodt πŸ’…
  • --no-user-config β€” do NOT load user config files, we're on a strict vibe check 🚫
  • --no-plugins β€” do not load any plugins at all. ⚠️ warning bestie: nose2 does not do anything if no plugins are loaded. like, literally nothing. it's giving empty plate at the function πŸ’€
  • --plugin PLUGINS β€” load this plugin module, yes queen 🧚
  • --exclude-plugin EXCLUDE_PLUGINS β€” do not load this plugin module, we're curating πŸ™ˆ
  • --verbosity VERBOSITY β€” set the starting verbosity level (it's an int). this one applies before -v and -q do their thing πŸ”₯
  • --verbose, -v β€” print test case names and statuses. stack multiple '-v's for higher verbosity, go off ✨
  • --quiet, -q β€” reduce verbosity. multiple '-q's result in lower verbosity, shy girl energy πŸŽ€
  • --log-level LOG_LEVEL β€” set the logging level for messages logged to console πŸ“’
  • -h, --help β€” show this help message and exit, the classic escape hatch πŸ¦‹

πŸ’œ plugin arguments πŸ’œ

command-line arguments added by plugins, the little extras the plugins bring to the group chat:

  • -B, --output-buffer β€” enable output buffer 🫧
  • --coverage PATH β€” measure coverage for a filesystem path (multi-allowed, so bring as many as you want) 🌈
  • --coverage-report TYPE β€” generate selected reports. available types: term, term-missing, annotate, html, xml (also multi-allowed, go wild) πŸ“Š
  • --coverage-config FILE β€” config file for coverage, default: .coveragerc ⭐
  • -C, --with-coverage β€” turn on coverage reporting, we love to see it πŸ‘‘
  • -D, --debugger β€” enter pdb on test fail or error πŸ›
  • -F, --fail-fast β€” stop the test run after the first error or failure, no dragging it out bestie πŸ’€
  • --pretty-assert β€” add pretty output for "assert" statements, gorgeous πŸ’–

and that's the whole thing, slay πŸŽ€ this was nose2-3 version 0.16.0-2, dated August 2026 β€” love her, read her, run her tests, byeee πŸ¦‹πŸ’…

πŸ“¦ where this page comes from