1NOSE2(1) User Commands NOSE2(1)
2
3
4
6 nose2 – The successor to nose, based on unittest2
7
9 nose2 [-s START_DIR] [-t TOP_LEVEL_DIRECTORY] [--config [CONFIG]]
10 [--no-user-config] [--no-plugins] [--plugin PLUGINS] [--exclude-
11 plugin EXCLUDE_PLUGINS] [--verbosity VERBOSITY] [--verbose] [--quiet]
12 [--log-level LOG_LEVEL] [-B] [--coverage PATH] [--coverage-report TYPE]
13 [--coverage-config FILE] [-C] [-D] [-F] [--log-capture] [--pretty-as‐
14 sert] [-h] [testNames ...]
15
17 POSITIONAL ARGUMENTS
18 testNames
19
20 OPTIONAL ARGUMENTS
21 -s START_DIR, --start-dir START_DIR
22 Directory to start discovery (. default)
23
24 -t TOP_LEVEL_DIRECTORY, --top-level-directory TOP_LEVEL_DIRECTORY,
25 --project-directory TOP_LEVEL_DIRECTORY
26 Top level directory of project (defaults to start dir)
27
28 --config [CONFIG], -c [CONFIG]
29 Config files to load, if they exist. (unittest.cfg and
30 nose2.cfg in start directory default)
31
32 --no-user-config
33 Do not load user config files
34
35 --no-plugins
36 Do not load any plugins. Warning: nose2 does not do anything if
37 no plugins are loaded
38
39 --plugin PLUGINS
40 Load this plugin module.
41
42 --exclude-plugin EXCLUDE_PLUGINS
43 Do not load this plugin module
44
45 --verbosity VERBOSITY
46 Set starting verbosity level (int). Applies before -v and -q
47
48 --verbose, -v
49 Print test case names and statuses. Use multiple -v’s for
50 higher verbosity.
51
52 --quiet, -q
53 Reduce verbosity. Multiple -q’s result in lower verbosity.
54
55 --log-level LOG_LEVEL
56 Set logging level for message logged to console.
57
58 -h, --help
59 Show a help message and exit
60
61 PLUGIN ARGUMENTS
62 Command-line arguments added by plugins:
63
64 -B, --output-buffer
65 Enable output buffer
66
67 --coverage PATH
68 Measure coverage for filesystem path (multi-allowed)
69
70 --coverage-report TYPE
71 Generate selected reports, available types: term, term-missing,
72 annotate, html, xml (multi-allowed)
73
74 --coverage-config FILE
75 Config file for coverage, default: .coveragerc
76
77 -C, --with-coverage
78 Turn on coverage reporting
79
80 -D, --debugger
81 Enter pdb on test fail or error
82
83 -F, --fail-fast
84 Stop the test run after the first error or failure
85
86 --log-capture
87 Enable log capture
88
89 --pretty-assert
90 Add pretty output for “assert” statements
91
93 unittest.cfg and nose2.cfg
94 Default config files loaded from the start directory; see --con‐
95 fig/-c, --start-dir/-s, and --no-user-config.
96
97 .coveragerc
98 Default config file for coverage; see --coverage-config.
99
100
101
102 June 2022 NOSE2(1)