OS Manuals

/usr/bin/tox-3.12

tox installed for python3.12

From py3.12-tox 4.67.13-r0 (os), captured 2026-11-07 by running tox-3.12 --help (exit 0). permalink

ROOT: No loadable tox.ini or setup.cfg or pyproject.toml or tox.toml found, assuming empty tox.ini at /tmp
usage: tox [-h] [--colored {yes,no}] [--stderr-color {BLACK,BLUE,CYAN,GREEN,LIGHTBLACK_EX,LIGHTBLUE_EX,LIGHTCYAN_EX,LIGHTGREEN_EX,LIGHTMAGENTA_EX,LIGHTRED_EX,LIGHTWHITE_EX,LIGHTYELLOW_EX,MAGENTA,RED,RESET,WHITE,YELLOW}] [-v | -q]
           [--exit-and-dump-after seconds] [-c file] [--workdir dir] [--root dir] [--runner {virtualenv,virtualenv-pep-723}] [--version] [--no-provision [REQ_JSON]] [--no-recreate-provision] [-r] [-x OVERRIDE]
           {run,r,run-parallel,p,depends,de,man,list,l,devenv,d,schema,config,c,quickstart,q,exec,e,legacy,le} ...

create and set up environments to run command(s) in them

options:
  -h, --help                  show this help message and exit
  --colored {yes,no}          should output be enriched with colors, default is yes unless TERM=dumb or NO_COLOR is defined. (default: no)
  --stderr-color {BLACK,BLUE,CYAN,GREEN,LIGHTBLACK_EX,LIGHTBLUE_EX,LIGHTCYAN_EX,LIGHTGREEN_EX,LIGHTMAGENTA_EX,LIGHTRED_EX,LIGHTWHITE_EX,LIGHTYELLOW_EX,MAGENTA,RED,RESET,WHITE,YELLOW}
                              color for stderr output, use RESET for terminal defaults. (default: RED)
  --exit-and-dump-after seconds
                              dump tox threads after n seconds and exit the app - useful to debug when tox hangs, 0 means disabled (default: 0)
  -c file, --conf file        configuration file/folder for tox (if not specified will discover one) (default: None)
  --workdir dir               tox working directory (if not specified will be the folder of the config file) (default: None)
  --root dir                  project root directory (if not specified will be the folder of the config file) (default: None)
  --runner {virtualenv,virtualenv-pep-723}
                              the tox run engine to use when not explicitly stated in tox env configuration (default: virtualenv)
  --version                   show program's and plugins version number and exit
  --no-provision [REQ_JSON]   do not perform provision, but fail and if a path was provided write provision metadata as JSON to it (default: False)
  --no-recreate-provision     if recreate is set do not recreate provision tox environment (default: False)
  -r, --recreate              recreate the tox environments (default: False)
  -x OVERRIDE, --override OVERRIDE
                              configuration override(s), e.g., -x testenv:pypy3.ignore_errors=True (default: [])

verbosity:
  every -v increases, every -q decreases verbosity level, default WARNING, map 0=CRITICAL|1=ERROR|2=WARNING|3=INFO|4=DEBUG|5=NOTSET

  -v, --verbose               increase verbosity (default: 2)
  -q, --quiet                 decrease verbosity (default: 0)

subcommands:
  tox command to execute (by default legacy)

  {run,r,run-parallel,p,depends,de,man,list,l,devenv,d,schema,config,c,quickstart,q,exec,e,legacy,le}
    run (r)                   run environments
    run-parallel (p)          run environments in parallel
    depends (de)              visualize tox environment dependencies
    man                       Set up tox man page for current shell
    list (l)                  list environments
    devenv (d)                sets up a development environment at ENVDIR based on the tox configuration specified
    schema                    Generate schema for tox configuration
    config (c)                show tox configuration
    quickstart (q)            Command line script to quickly create a tox config file for a Python project
    exec (e)                  execute an arbitrary command within a tox environment
    legacy (le)               legacy entry-point command

config file '/tmp/.config/tox/config.ini' missing (change via env var TOX_USER_CONFIG_FILE)
Options (14)
OptionDescriptionSource
-h, --helpshow this help message and exithelp
--colored yesshould output be enriched with colors, default is yes unless TERM=dumb or NO_COLOR is defined.help
--stderr-color BLACKcolor for stderr output, use RESET for terminal defaults.help
--exit-and-dump-after secondsdump tox threads after n seconds and exit the app - useful to debug when tox hangs, 0 means disabled (default: 0)help
-c, --conf fileconfiguration file/folder for tox (if not specified will discover one) (default: None)help
--workdir dirtox working directory (if not specified will be the folder of the config file) (default: None)help
--root dirproject root directory (if not specified will be the folder of the config file) (default: None)help
--runner virtualenvthe tox run engine to use when not explicitly stated in tox env configuration (default: virtualenv)help
--versionshow program's and plugins version number and exithelp
--no-provision REQ_JSONdo not perform provision, but fail and if a path was provided write provision metadata as JSON to it (default: False)help
--no-recreate-provisionif recreate is set do not recreate provision tox environment (default: False)help
-r, --recreaterecreate the tox environments (default: False)help
-v, --verboseincrease verbosity (default: 2)help
-q, --quietdecrease verbosity (default: 0)help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.