.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "TOX" "1" "Feb 27, 2023" "4.4" "Python"
.SH NAME
tox \- automation project
.SH SYNOPSIS
.sp
\fBtox\fP [\fIsubcommand\fP] [\fIoptions\fP] [\fIargs\fP ...]
.SH DESCRIPTION
.sp
tox is a generic virtual environment management and test command line tool you can use for:
.INDENT 0.0
.IP \(bu 2
checking your package builds and installs correctly under different environments (such as different Python
implementations, versions or installation dependencies),
.IP \(bu 2
running your tests in each of the environments with the test tool of choice,
.IP \(bu 2
acting as a frontend to continuous integration servers, greatly reducing boilerplate and merging CI and
shell\-based testing.
.UNINDENT
.SH OVERVIEW
.sp
tox has several subcommands, each with their own options. Below you can find an
exhaustive list of options for each of those subcommands.
.sp
Each tox subcommand has a 1 (or 2) letter shortcut form too. For example, \fItox
run\fP can also be written as \fItox r\fP or \fItox config\fP can be shortened to \fItox
c\fP\&.
.SH OPTIONS
.SS tox entry point
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
tox [\-h] [\-\-colored {yes,no}] [\-v | \-q] [\-\-exit\-and\-dump\-after seconds] [\-c file]
    [\-\-workdir dir] [\-\-root dir] [\-\-runner {virtualenv}] [\-\-version]
    [\-\-no\-provision [REQ_JSON]] [\-\-no\-recreate\-provision] [\-r] [\-x OVERRIDE]
    {run,r,run\-parallel,p,depends,de,list,l,devenv,d,config,c,quickstart,q,exec,e,legacy,le}
    ...
.ft P
.fi
.UNINDENT
.UNINDENT
.SS tox options
.INDENT 0.0
.IP \(bu 2
\fI\%\-h\fP, \fI\%\-\-help\fP \- show this help message and exit
.IP \(bu 2
\fI\%\-\-colored\fP \fBCOLORED\fP \- should output be enriched with colors, default is yes unless TERM=dumb or NO_COLOR is defined.
.IP \(bu 2
\fI\%\-\-exit\-and\-dump\-after\fP \fBSECONDS\fP \- dump tox threads after n seconds and exit the app \- useful to debug when tox hangs, 0 means disabled (default: \fB0\fP)
.IP \(bu 2
\fI\%\-c\fP \fBFILE\fP, \fI\%\-\-conf\fP \fBFILE\fP \- configuration file/folder for tox (if not specified will discover one) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-workdir\fP \fBDIR\fP \- tox working directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-root\fP \fBDIR\fP \- project root directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-runner\fP \fBDEFAULT_RUNNER\fP \- the tox run engine to use when not explicitly stated in tox env configuration (default: \fBvirtualenv\fP)
.IP \(bu 2
\fI\%\-\-version\fP \- show program\(aqs and plugins version number and exit
.IP \(bu 2
\fI\%\-\-no\-provision\fP \fBREQ_JSON\fP \- do not perform provision, but fail and if a path was provided write provision metadata as JSON to it (default: \fBFalse\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-provision\fP \- if recreate is set do not recreate provision tox environment
.IP \(bu 2
\fI\%\-r\fP, \fI\%\-\-recreate\fP \- recreate the tox environments
.IP \(bu 2
\fI\%\-x\fP \fBOVERRIDE\fP, \fI\%\-\-override\fP \fBOVERRIDE\fP \- configuration override(s) (default: \fB[]\fP)
.UNINDENT
.SS tox verbosity
.sp
every \-v increases, every \-q decreases verbosity level, default WARNING, map 0=CRITICAL|1=ERROR|2=WARNING|3=INFO|4=DEBUG|5=NOTSET
.INDENT 0.0
.IP \(bu 2
\fI\%\-v\fP, \fI\%\-\-verbose\fP \- increase verbosity (default: \fB2\fP)
.IP \(bu 2
\fI\%\-q\fP, \fI\%\-\-quiet\fP \- decrease verbosity (default: \fB0\fP)
.UNINDENT
.SS tox run (r)
.sp
run environments
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
tox run [\-h] [\-\-colored {yes,no}] [\-\-exit\-and\-dump\-after seconds] [\-c file] [\-\-workdir dir]
        [\-\-root dir] [\-\-runner {virtualenv}] [\-v | \-q] [\-e ENV | \-m label [label ...] | \-f
        factor [factor ...] | \-\-skip\-env re] [\-\-result\-json path] [\-s [v]] [\-n] [\-b]
        [\-\-installpkg INSTALL_PKG] [\-\-develop] [\-\-hashseed SEED] [\-\-discover path [path ...]]
        [\-\-no\-recreate\-pkg] [\-\-skip\-pkg\-install] [\-\-version] [\-\-no\-provision [REQ_JSON]]
        [\-\-no\-recreate\-provision] [\-r] [\-x OVERRIDE]
.ft P
.fi
.UNINDENT
.UNINDENT
.SS tox run options
.INDENT 0.0
.IP \(bu 2
\fI\%\-h\fP, \fI\%\-\-help\fP \- show this help message and exit
.IP \(bu 2
\fI\%\-\-colored\fP \fBCOLORED\fP \- should output be enriched with colors, default is yes unless TERM=dumb or NO_COLOR is defined.
.IP \(bu 2
\fI\%\-\-exit\-and\-dump\-after\fP \fBSECONDS\fP \- dump tox threads after n seconds and exit the app \- useful to debug when tox hangs, 0 means disabled (default: \fB0\fP)
.IP \(bu 2
\fI\%\-c\fP \fBFILE\fP, \fI\%\-\-conf\fP \fBFILE\fP \- configuration file/folder for tox (if not specified will discover one) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-workdir\fP \fBDIR\fP \- tox working directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-root\fP \fBDIR\fP \- project root directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-runner\fP \fBDEFAULT_RUNNER\fP \- the tox run engine to use when not explicitly stated in tox env configuration (default: \fBvirtualenv\fP)
.IP \(bu 2
\fI\%\-\-result\-json\fP \fBPATH\fP \- write a JSON file with detailed information about all commands and results involved (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-s\fP \fBV\fP, \fI\%\-\-skip\-missing\-interpreters\fP \fBV\fP \- don\(aqt fail tests for missing interpreters: \fB{config,true,false}\fP choice (default: \fBconfig\fP)
.IP \(bu 2
\fI\%\-n\fP, \fI\%\-\-notest\fP \- do not run the test commands
.IP \(bu 2
\fI\%\-b\fP, \fI\%\-\-pkg\-only\fP, \fI\%\-\-sdistonly\fP \- only perform the packaging activity
.IP \(bu 2
\fI\%\-\-installpkg\fP \fBINSTALL_PKG\fP \- use specified package for installation into venv, instead of packaging the project (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-develop\fP \- install package in development mode
.IP \(bu 2
\fI\%\-\-hashseed\fP \fBSEED\fP \- set PYTHONHASHSEED to SEED before running commands. Defaults to a random integer in the range [1, 4294967295] ([1, 1024] on Windows). Passing \fB\(aqnoset\(aq\fP suppresses this behavior. (default: \fB742673852\fP)
.IP \(bu 2
\fI\%\-\-discover\fP \fBPATH\fP \- for Python discovery first try the Python executables under these paths (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-pkg\fP \- if recreate is set do not recreate packaging tox environment(s)
.IP \(bu 2
\fI\%\-\-skip\-pkg\-install\fP \- skip package installation for this run
.IP \(bu 2
\fI\%\-\-version\fP \- show program\(aqs and plugins version number and exit
.IP \(bu 2
\fI\%\-\-no\-provision\fP \fBREQ_JSON\fP \- do not perform provision, but fail and if a path was provided write provision metadata as JSON to it (default: \fBFalse\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-provision\fP \- if recreate is set do not recreate provision tox environment
.IP \(bu 2
\fI\%\-r\fP, \fI\%\-\-recreate\fP \- recreate the tox environments
.IP \(bu 2
\fI\%\-x\fP \fBOVERRIDE\fP, \fI\%\-\-override\fP \fBOVERRIDE\fP \- configuration override(s) (default: \fB[]\fP)
.UNINDENT
.SS tox run verbosity
.INDENT 0.0
.IP \(bu 2
\fI\%\-v\fP, \fI\%\-\-verbose\fP \- increase verbosity (default: \fB2\fP)
.IP \(bu 2
\fI\%\-q\fP, \fI\%\-\-quiet\fP \- decrease verbosity (default: \fB0\fP)
.UNINDENT
.SS tox run select target environment(s)
.INDENT 0.0
.IP \(bu 2
\fI\%\-e\fP \fBENV\fP \- enumerate (ALL \-> all environments, not set \-> use <env_list> from config) (default: \fB<env_list>\fP)
.IP \(bu 2
\fI\%\-m\fP \fBLABEL\fP \- labels to evaluate (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-f\fP \fBFACTOR\fP \- factors to evaluate (passing multiple factors means \fB\(aqAND\(aq\fP, passing this option multiple times means \fB\(aqOR\(aq\fP) (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-skip\-env\fP \fBRE\fP \- exclude all environments selected that match this regular expression (default: \fB\fP)
.UNINDENT
.SS tox run\-parallel (p)
.sp
run environments in parallel
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
tox run\-parallel [\-h] [\-\-colored {yes,no}] [\-\-exit\-and\-dump\-after seconds] [\-c file]
                 [\-\-workdir dir] [\-\-root dir] [\-\-runner {virtualenv}] [\-v | \-q]
                 [\-e ENV | \-m label [label ...] | \-f factor [factor ...] | \-\-skip\-env re]
                 [\-\-result\-json path] [\-s [v]] [\-n] [\-b] [\-\-installpkg INSTALL_PKG]
                 [\-\-develop] [\-\-hashseed SEED] [\-\-discover path [path ...]]
                 [\-\-no\-recreate\-pkg] [\-\-skip\-pkg\-install] [\-p VAL] [\-o]
                 [\-\-parallel\-no\-spinner] [\-\-version] [\-\-no\-provision [REQ_JSON]]
                 [\-\-no\-recreate\-provision] [\-r] [\-x OVERRIDE]
.ft P
.fi
.UNINDENT
.UNINDENT
.SS tox run\-parallel options
.INDENT 0.0
.IP \(bu 2
\fI\%\-h\fP, \fI\%\-\-help\fP \- show this help message and exit
.IP \(bu 2
\fI\%\-\-colored\fP \fBCOLORED\fP \- should output be enriched with colors, default is yes unless TERM=dumb or NO_COLOR is defined.
.IP \(bu 2
\fI\%\-\-exit\-and\-dump\-after\fP \fBSECONDS\fP \- dump tox threads after n seconds and exit the app \- useful to debug when tox hangs, 0 means disabled (default: \fB0\fP)
.IP \(bu 2
\fI\%\-c\fP \fBFILE\fP, \fI\%\-\-conf\fP \fBFILE\fP \- configuration file/folder for tox (if not specified will discover one) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-workdir\fP \fBDIR\fP \- tox working directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-root\fP \fBDIR\fP \- project root directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-runner\fP \fBDEFAULT_RUNNER\fP \- the tox run engine to use when not explicitly stated in tox env configuration (default: \fBvirtualenv\fP)
.IP \(bu 2
\fI\%\-\-result\-json\fP \fBPATH\fP \- write a JSON file with detailed information about all commands and results involved (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-s\fP \fBV\fP, \fI\%\-\-skip\-missing\-interpreters\fP \fBV\fP \- don\(aqt fail tests for missing interpreters: \fB{config,true,false}\fP choice (default: \fBconfig\fP)
.IP \(bu 2
\fI\%\-n\fP, \fI\%\-\-notest\fP \- do not run the test commands
.IP \(bu 2
\fI\%\-b\fP, \fI\%\-\-pkg\-only\fP, \fI\%\-\-sdistonly\fP \- only perform the packaging activity
.IP \(bu 2
\fI\%\-\-installpkg\fP \fBINSTALL_PKG\fP \- use specified package for installation into venv, instead of packaging the project (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-develop\fP \- install package in development mode
.IP \(bu 2
\fI\%\-\-hashseed\fP \fBSEED\fP \- set PYTHONHASHSEED to SEED before running commands. Defaults to a random integer in the range [1, 4294967295] ([1, 1024] on Windows). Passing \fB\(aqnoset\(aq\fP suppresses this behavior. (default: \fB1309436421\fP)
.IP \(bu 2
\fI\%\-\-discover\fP \fBPATH\fP \- for Python discovery first try the Python executables under these paths (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-pkg\fP \- if recreate is set do not recreate packaging tox environment(s)
.IP \(bu 2
\fI\%\-\-skip\-pkg\-install\fP \- skip package installation for this run
.IP \(bu 2
\fI\%\-p\fP \fBVAL\fP, \fI\%\-\-parallel\fP \fBVAL\fP \- run tox environments in parallel, the argument controls limit: all, auto \- cpu count, some positive number, zero is turn off (default: \fB4\fP)
.IP \(bu 2
\fI\%\-o\fP, \fI\%\-\-parallel\-live\fP \- connect to stdout while running environments
.IP \(bu 2
\fI\%\-\-parallel\-no\-spinner\fP \- do not show the spinner
.IP \(bu 2
\fI\%\-\-version\fP \- show program\(aqs and plugins version number and exit
.IP \(bu 2
\fI\%\-\-no\-provision\fP \fBREQ_JSON\fP \- do not perform provision, but fail and if a path was provided write provision metadata as JSON to it (default: \fBFalse\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-provision\fP \- if recreate is set do not recreate provision tox environment
.IP \(bu 2
\fI\%\-r\fP, \fI\%\-\-recreate\fP \- recreate the tox environments
.IP \(bu 2
\fI\%\-x\fP \fBOVERRIDE\fP, \fI\%\-\-override\fP \fBOVERRIDE\fP \- configuration override(s) (default: \fB[]\fP)
.UNINDENT
.SS tox run\-parallel verbosity
.INDENT 0.0
.IP \(bu 2
\fI\%\-v\fP, \fI\%\-\-verbose\fP \- increase verbosity (default: \fB2\fP)
.IP \(bu 2
\fI\%\-q\fP, \fI\%\-\-quiet\fP \- decrease verbosity (default: \fB0\fP)
.UNINDENT
.SS tox run\-parallel select target environment(s)
.INDENT 0.0
.IP \(bu 2
\fI\%\-e\fP \fBENV\fP \- enumerate (ALL \-> all environments, not set \-> use <env_list> from config) (default: \fB<env_list>\fP)
.IP \(bu 2
\fI\%\-m\fP \fBLABEL\fP \- labels to evaluate (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-f\fP \fBFACTOR\fP \- factors to evaluate (passing multiple factors means \fB\(aqAND\(aq\fP, passing this option multiple times means \fB\(aqOR\(aq\fP) (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-skip\-env\fP \fBRE\fP \- exclude all environments selected that match this regular expression (default: \fB\fP)
.UNINDENT
.SS tox depends (de)
.sp
visualize tox environment dependencies
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
tox depends [\-h] [\-\-colored {yes,no}] [\-\-exit\-and\-dump\-after seconds] [\-c file]
            [\-\-workdir dir] [\-\-root dir] [\-\-runner {virtualenv}] [\-v | \-q]
            [\-\-discover path [path ...]] [\-\-version] [\-\-no\-provision [REQ_JSON]]
            [\-\-no\-recreate\-provision] [\-r] [\-x OVERRIDE]
.ft P
.fi
.UNINDENT
.UNINDENT
.SS tox depends options
.INDENT 0.0
.IP \(bu 2
\fI\%\-h\fP, \fI\%\-\-help\fP \- show this help message and exit
.IP \(bu 2
\fI\%\-\-colored\fP \fBCOLORED\fP \- should output be enriched with colors, default is yes unless TERM=dumb or NO_COLOR is defined.
.IP \(bu 2
\fI\%\-\-exit\-and\-dump\-after\fP \fBSECONDS\fP \- dump tox threads after n seconds and exit the app \- useful to debug when tox hangs, 0 means disabled (default: \fB0\fP)
.IP \(bu 2
\fI\%\-c\fP \fBFILE\fP, \fI\%\-\-conf\fP \fBFILE\fP \- configuration file/folder for tox (if not specified will discover one) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-workdir\fP \fBDIR\fP \- tox working directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-root\fP \fBDIR\fP \- project root directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-runner\fP \fBDEFAULT_RUNNER\fP \- the tox run engine to use when not explicitly stated in tox env configuration (default: \fBvirtualenv\fP)
.IP \(bu 2
\fI\%\-\-discover\fP \fBPATH\fP \- for Python discovery first try the Python executables under these paths (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-version\fP \- show program\(aqs and plugins version number and exit
.IP \(bu 2
\fI\%\-\-no\-provision\fP \fBREQ_JSON\fP \- do not perform provision, but fail and if a path was provided write provision metadata as JSON to it (default: \fBFalse\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-provision\fP \- if recreate is set do not recreate provision tox environment
.IP \(bu 2
\fI\%\-r\fP, \fI\%\-\-recreate\fP \- recreate the tox environments
.IP \(bu 2
\fI\%\-x\fP \fBOVERRIDE\fP, \fI\%\-\-override\fP \fBOVERRIDE\fP \- configuration override(s) (default: \fB[]\fP)
.UNINDENT
.SS tox depends verbosity
.INDENT 0.0
.IP \(bu 2
\fI\%\-v\fP, \fI\%\-\-verbose\fP \- increase verbosity (default: \fB2\fP)
.IP \(bu 2
\fI\%\-q\fP, \fI\%\-\-quiet\fP \- decrease verbosity (default: \fB0\fP)
.UNINDENT
.SS tox list (l)
.sp
list environments
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
tox list [\-h] [\-\-colored {yes,no}] [\-\-exit\-and\-dump\-after seconds] [\-c file] [\-\-workdir dir]
         [\-\-root dir] [\-\-runner {virtualenv}] [\-v | \-q] [\-\-no\-desc] [\-m label [label ...] |
         \-f factor [factor ...] | \-\-skip\-env re | \-d] [\-\-version] [\-\-no\-provision [REQ_JSON]]
         [\-\-no\-recreate\-provision] [\-r] [\-x OVERRIDE]
.ft P
.fi
.UNINDENT
.UNINDENT
.SS tox list options
.INDENT 0.0
.IP \(bu 2
\fI\%\-h\fP, \fI\%\-\-help\fP \- show this help message and exit
.IP \(bu 2
\fI\%\-\-colored\fP \fBCOLORED\fP \- should output be enriched with colors, default is yes unless TERM=dumb or NO_COLOR is defined.
.IP \(bu 2
\fI\%\-\-exit\-and\-dump\-after\fP \fBSECONDS\fP \- dump tox threads after n seconds and exit the app \- useful to debug when tox hangs, 0 means disabled (default: \fB0\fP)
.IP \(bu 2
\fI\%\-c\fP \fBFILE\fP, \fI\%\-\-conf\fP \fBFILE\fP \- configuration file/folder for tox (if not specified will discover one) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-workdir\fP \fBDIR\fP \- tox working directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-root\fP \fBDIR\fP \- project root directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-runner\fP \fBDEFAULT_RUNNER\fP \- the tox run engine to use when not explicitly stated in tox env configuration (default: \fBvirtualenv\fP)
.IP \(bu 2
\fI\%\-\-no\-desc\fP \- do not show description
.IP \(bu 2
\fI\%\-\-version\fP \- show program\(aqs and plugins version number and exit
.IP \(bu 2
\fI\%\-\-no\-provision\fP \fBREQ_JSON\fP \- do not perform provision, but fail and if a path was provided write provision metadata as JSON to it (default: \fBFalse\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-provision\fP \- if recreate is set do not recreate provision tox environment
.IP \(bu 2
\fI\%\-r\fP, \fI\%\-\-recreate\fP \- recreate the tox environments
.IP \(bu 2
\fI\%\-x\fP \fBOVERRIDE\fP, \fI\%\-\-override\fP \fBOVERRIDE\fP \- configuration override(s) (default: \fB[]\fP)
.UNINDENT
.SS tox list verbosity
.INDENT 0.0
.IP \(bu 2
\fI\%\-v\fP, \fI\%\-\-verbose\fP \- increase verbosity (default: \fB2\fP)
.IP \(bu 2
\fI\%\-q\fP, \fI\%\-\-quiet\fP \- decrease verbosity (default: \fB0\fP)
.UNINDENT
.SS tox list select target environment(s)
.INDENT 0.0
.IP \(bu 2
\fI\%\-m\fP \fBLABEL\fP \- labels to evaluate (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-f\fP \fBFACTOR\fP \- factors to evaluate (passing multiple factors means \fB\(aqAND\(aq\fP, passing this option multiple times means \fB\(aqOR\(aq\fP) (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-skip\-env\fP \fBRE\fP \- exclude all environments selected that match this regular expression (default: \fB\fP)
.IP \(bu 2
\fI\%\-d\fP \- list just default envs
.UNINDENT
.SS tox devenv (d)
.sp
sets up a development environment at ENVDIR based on the tox configuration specified
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
tox devenv [\-h] [\-\-colored {yes,no}] [\-\-exit\-and\-dump\-after seconds] [\-c file]
           [\-\-workdir dir] [\-\-root dir] [\-\-runner {virtualenv}] [\-v | \-q] [\-e ENV]
           [\-\-skip\-env re] [\-\-result\-json path] [\-\-hashseed SEED]
           [\-\-discover path [path ...]] [\-\-no\-recreate\-pkg] [\-\-version]
           [\-\-no\-provision [REQ_JSON]] [\-\-no\-recreate\-provision] [\-r] [\-x OVERRIDE]
           [path]
.ft P
.fi
.UNINDENT
.UNINDENT
.SS tox devenv positional arguments
.INDENT 0.0
.IP \(bu 2
\fI\%path\fP (default: \fBvenv\fP)
.UNINDENT
.SS tox devenv options
.INDENT 0.0
.IP \(bu 2
\fI\%\-h\fP, \fI\%\-\-help\fP \- show this help message and exit
.IP \(bu 2
\fI\%\-\-colored\fP \fBCOLORED\fP \- should output be enriched with colors, default is yes unless TERM=dumb or NO_COLOR is defined.
.IP \(bu 2
\fI\%\-\-exit\-and\-dump\-after\fP \fBSECONDS\fP \- dump tox threads after n seconds and exit the app \- useful to debug when tox hangs, 0 means disabled (default: \fB0\fP)
.IP \(bu 2
\fI\%\-c\fP \fBFILE\fP, \fI\%\-\-conf\fP \fBFILE\fP \- configuration file/folder for tox (if not specified will discover one) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-workdir\fP \fBDIR\fP \- tox working directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-root\fP \fBDIR\fP \- project root directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-runner\fP \fBDEFAULT_RUNNER\fP \- the tox run engine to use when not explicitly stated in tox env configuration (default: \fBvirtualenv\fP)
.IP \(bu 2
\fI\%\-e\fP \fBENV\fP \- environment to run (default: \fBpy\fP)
.IP \(bu 2
\fI\%\-\-skip\-env\fP \fBRE\fP \- exclude all environments selected that match this regular expression (default: \fB\fP)
.IP \(bu 2
\fI\%\-\-result\-json\fP \fBPATH\fP \- write a JSON file with detailed information about all commands and results involved (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-hashseed\fP \fBSEED\fP \- set PYTHONHASHSEED to SEED before running commands. Defaults to a random integer in the range [1, 4294967295] ([1, 1024] on Windows). Passing \fB\(aqnoset\(aq\fP suppresses this behavior. (default: \fB1051162557\fP)
.IP \(bu 2
\fI\%\-\-discover\fP \fBPATH\fP \- for Python discovery first try the Python executables under these paths (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-pkg\fP \- if recreate is set do not recreate packaging tox environment(s)
.IP \(bu 2
\fI\%\-\-version\fP \- show program\(aqs and plugins version number and exit
.IP \(bu 2
\fI\%\-\-no\-provision\fP \fBREQ_JSON\fP \- do not perform provision, but fail and if a path was provided write provision metadata as JSON to it (default: \fBFalse\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-provision\fP \- if recreate is set do not recreate provision tox environment
.IP \(bu 2
\fI\%\-r\fP, \fI\%\-\-recreate\fP \- recreate the tox environments
.IP \(bu 2
\fI\%\-x\fP \fBOVERRIDE\fP, \fI\%\-\-override\fP \fBOVERRIDE\fP \- configuration override(s) (default: \fB[]\fP)
.UNINDENT
.SS tox devenv verbosity
.INDENT 0.0
.IP \(bu 2
\fI\%\-v\fP, \fI\%\-\-verbose\fP \- increase verbosity (default: \fB2\fP)
.IP \(bu 2
\fI\%\-q\fP, \fI\%\-\-quiet\fP \- decrease verbosity (default: \fB0\fP)
.UNINDENT
.SS tox config (c)
.sp
show tox configuration
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
tox config [\-h] [\-\-colored {yes,no}] [\-\-exit\-and\-dump\-after seconds] [\-c file]
           [\-\-workdir dir] [\-\-root dir] [\-\-runner {virtualenv}] [\-v | \-q] [\-k key [key ...]]
           [\-\-core] [\-e ENV | \-m label [label ...] | \-f factor [factor ...] | \-\-skip\-env re]
           [\-s [v]] [\-\-develop] [\-\-hashseed SEED] [\-\-discover path [path ...]]
           [\-\-no\-recreate\-pkg] [\-\-version] [\-\-no\-provision [REQ_JSON]]
           [\-\-no\-recreate\-provision] [\-r] [\-x OVERRIDE]
.ft P
.fi
.UNINDENT
.UNINDENT
.SS tox config options
.INDENT 0.0
.IP \(bu 2
\fI\%\-h\fP, \fI\%\-\-help\fP \- show this help message and exit
.IP \(bu 2
\fI\%\-\-colored\fP \fBCOLORED\fP \- should output be enriched with colors, default is yes unless TERM=dumb or NO_COLOR is defined.
.IP \(bu 2
\fI\%\-\-exit\-and\-dump\-after\fP \fBSECONDS\fP \- dump tox threads after n seconds and exit the app \- useful to debug when tox hangs, 0 means disabled (default: \fB0\fP)
.IP \(bu 2
\fI\%\-c\fP \fBFILE\fP, \fI\%\-\-conf\fP \fBFILE\fP \- configuration file/folder for tox (if not specified will discover one) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-workdir\fP \fBDIR\fP \- tox working directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-root\fP \fBDIR\fP \- project root directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-runner\fP \fBDEFAULT_RUNNER\fP \- the tox run engine to use when not explicitly stated in tox env configuration (default: \fBvirtualenv\fP)
.IP \(bu 2
\fI\%\-k\fP \fBKEY\fP \- list just configuration keys specified (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-core\fP \- show core options (by default is hidden unless \-e ALL is passed)
.IP \(bu 2
\fI\%\-s\fP \fBV\fP, \fI\%\-\-skip\-missing\-interpreters\fP \fBV\fP \- don\(aqt fail tests for missing interpreters: \fB{config,true,false}\fP choice (default: \fBconfig\fP)
.IP \(bu 2
\fI\%\-\-develop\fP \- install package in development mode
.IP \(bu 2
\fI\%\-\-hashseed\fP \fBSEED\fP \- set PYTHONHASHSEED to SEED before running commands. Defaults to a random integer in the range [1, 4294967295] ([1, 1024] on Windows). Passing \fB\(aqnoset\(aq\fP suppresses this behavior. (default: \fB157798605\fP)
.IP \(bu 2
\fI\%\-\-discover\fP \fBPATH\fP \- for Python discovery first try the Python executables under these paths (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-pkg\fP \- if recreate is set do not recreate packaging tox environment(s)
.IP \(bu 2
\fI\%\-\-version\fP \- show program\(aqs and plugins version number and exit
.IP \(bu 2
\fI\%\-\-no\-provision\fP \fBREQ_JSON\fP \- do not perform provision, but fail and if a path was provided write provision metadata as JSON to it (default: \fBFalse\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-provision\fP \- if recreate is set do not recreate provision tox environment
.IP \(bu 2
\fI\%\-r\fP, \fI\%\-\-recreate\fP \- recreate the tox environments
.IP \(bu 2
\fI\%\-x\fP \fBOVERRIDE\fP, \fI\%\-\-override\fP \fBOVERRIDE\fP \- configuration override(s) (default: \fB[]\fP)
.UNINDENT
.SS tox config verbosity
.INDENT 0.0
.IP \(bu 2
\fI\%\-v\fP, \fI\%\-\-verbose\fP \- increase verbosity (default: \fB2\fP)
.IP \(bu 2
\fI\%\-q\fP, \fI\%\-\-quiet\fP \- decrease verbosity (default: \fB0\fP)
.UNINDENT
.SS tox config select target environment(s)
.INDENT 0.0
.IP \(bu 2
\fI\%\-e\fP \fBENV\fP \- enumerate (ALL \-> all environments, not set \-> use <env_list> from config) (default: \fB<env_list>\fP)
.IP \(bu 2
\fI\%\-m\fP \fBLABEL\fP \- labels to evaluate (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-f\fP \fBFACTOR\fP \- factors to evaluate (passing multiple factors means \fB\(aqAND\(aq\fP, passing this option multiple times means \fB\(aqOR\(aq\fP) (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-skip\-env\fP \fBRE\fP \- exclude all environments selected that match this regular expression (default: \fB\fP)
.UNINDENT
.SS tox quickstart (q)
.sp
Command line script to quickly create a tox config file for a Python project
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
tox quickstart [\-h] [\-\-colored {yes,no}] [\-\-exit\-and\-dump\-after seconds] [\-c file]
               [\-\-workdir dir] [\-\-root dir] [\-\-runner {virtualenv}] [\-v | \-q] [\-\-version]
               [\-\-no\-provision [REQ_JSON]] [\-\-no\-recreate\-provision] [\-r] [\-x OVERRIDE]
               root
.ft P
.fi
.UNINDENT
.UNINDENT
.SS tox quickstart positional arguments
.INDENT 0.0
.IP \(bu 2
\fI\%root\fP \- folder to create the tox.ini file (default: \fB{cwd}\fP)
.UNINDENT
.SS tox quickstart options
.INDENT 0.0
.IP \(bu 2
\fI\%\-h\fP, \fI\%\-\-help\fP \- show this help message and exit
.IP \(bu 2
\fI\%\-\-colored\fP \fBCOLORED\fP \- should output be enriched with colors, default is yes unless TERM=dumb or NO_COLOR is defined.
.IP \(bu 2
\fI\%\-\-exit\-and\-dump\-after\fP \fBSECONDS\fP \- dump tox threads after n seconds and exit the app \- useful to debug when tox hangs, 0 means disabled (default: \fB0\fP)
.IP \(bu 2
\fI\%\-c\fP \fBFILE\fP, \fI\%\-\-conf\fP \fBFILE\fP \- configuration file/folder for tox (if not specified will discover one) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-workdir\fP \fBDIR\fP \- tox working directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-root\fP \fBDIR\fP \- project root directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-runner\fP \fBDEFAULT_RUNNER\fP \- the tox run engine to use when not explicitly stated in tox env configuration (default: \fBvirtualenv\fP)
.IP \(bu 2
\fI\%\-\-version\fP \- show program\(aqs and plugins version number and exit
.IP \(bu 2
\fI\%\-\-no\-provision\fP \fBREQ_JSON\fP \- do not perform provision, but fail and if a path was provided write provision metadata as JSON to it (default: \fBFalse\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-provision\fP \- if recreate is set do not recreate provision tox environment
.IP \(bu 2
\fI\%\-r\fP, \fI\%\-\-recreate\fP \- recreate the tox environments
.IP \(bu 2
\fI\%\-x\fP \fBOVERRIDE\fP, \fI\%\-\-override\fP \fBOVERRIDE\fP \- configuration override(s) (default: \fB[]\fP)
.UNINDENT
.SS tox quickstart verbosity
.INDENT 0.0
.IP \(bu 2
\fI\%\-v\fP, \fI\%\-\-verbose\fP \- increase verbosity (default: \fB2\fP)
.IP \(bu 2
\fI\%\-q\fP, \fI\%\-\-quiet\fP \- decrease verbosity (default: \fB0\fP)
.UNINDENT
.SS tox exec (e)
.sp
execute an arbitrary command within a tox environment
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
tox exec [\-h] [\-\-colored {yes,no}] [\-\-exit\-and\-dump\-after seconds] [\-c file] [\-\-workdir dir]
         [\-\-root dir] [\-\-runner {virtualenv}] [\-v | \-q] [\-e ENV] [\-\-skip\-env re]
         [\-\-result\-json path] [\-s [v]] [\-n] [\-b] [\-\-installpkg INSTALL_PKG] [\-\-develop]
         [\-\-hashseed SEED] [\-\-discover path [path ...]] [\-\-no\-recreate\-pkg]
         [\-\-skip\-pkg\-install] [\-\-version] [\-\-no\-provision [REQ_JSON]]
         [\-\-no\-recreate\-provision] [\-r] [\-x OVERRIDE]
.ft P
.fi
.UNINDENT
.UNINDENT
.SS tox exec options
.INDENT 0.0
.IP \(bu 2
\fI\%\-h\fP, \fI\%\-\-help\fP \- show this help message and exit
.IP \(bu 2
\fI\%\-\-colored\fP \fBCOLORED\fP \- should output be enriched with colors, default is yes unless TERM=dumb or NO_COLOR is defined.
.IP \(bu 2
\fI\%\-\-exit\-and\-dump\-after\fP \fBSECONDS\fP \- dump tox threads after n seconds and exit the app \- useful to debug when tox hangs, 0 means disabled (default: \fB0\fP)
.IP \(bu 2
\fI\%\-c\fP \fBFILE\fP, \fI\%\-\-conf\fP \fBFILE\fP \- configuration file/folder for tox (if not specified will discover one) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-workdir\fP \fBDIR\fP \- tox working directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-root\fP \fBDIR\fP \- project root directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-runner\fP \fBDEFAULT_RUNNER\fP \- the tox run engine to use when not explicitly stated in tox env configuration (default: \fBvirtualenv\fP)
.IP \(bu 2
\fI\%\-e\fP \fBENV\fP \- environment to run (default: \fBpy\fP)
.IP \(bu 2
\fI\%\-\-skip\-env\fP \fBRE\fP \- exclude all environments selected that match this regular expression (default: \fB\fP)
.IP \(bu 2
\fI\%\-\-result\-json\fP \fBPATH\fP \- write a JSON file with detailed information about all commands and results involved (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-s\fP \fBV\fP, \fI\%\-\-skip\-missing\-interpreters\fP \fBV\fP \- don\(aqt fail tests for missing interpreters: \fB{config,true,false}\fP choice (default: \fBconfig\fP)
.IP \(bu 2
\fI\%\-n\fP, \fI\%\-\-notest\fP \- do not run the test commands
.IP \(bu 2
\fI\%\-b\fP, \fI\%\-\-pkg\-only\fP, \fI\%\-\-sdistonly\fP \- only perform the packaging activity
.IP \(bu 2
\fI\%\-\-installpkg\fP \fBINSTALL_PKG\fP \- use specified package for installation into venv, instead of packaging the project (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-develop\fP \- install package in development mode
.IP \(bu 2
\fI\%\-\-hashseed\fP \fBSEED\fP \- set PYTHONHASHSEED to SEED before running commands. Defaults to a random integer in the range [1, 4294967295] ([1, 1024] on Windows). Passing \fB\(aqnoset\(aq\fP suppresses this behavior. (default: \fB4245435543\fP)
.IP \(bu 2
\fI\%\-\-discover\fP \fBPATH\fP \- for Python discovery first try the Python executables under these paths (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-pkg\fP \- if recreate is set do not recreate packaging tox environment(s)
.IP \(bu 2
\fI\%\-\-skip\-pkg\-install\fP \- skip package installation for this run
.IP \(bu 2
\fI\%\-\-version\fP \- show program\(aqs and plugins version number and exit
.IP \(bu 2
\fI\%\-\-no\-provision\fP \fBREQ_JSON\fP \- do not perform provision, but fail and if a path was provided write provision metadata as JSON to it (default: \fBFalse\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-provision\fP \- if recreate is set do not recreate provision tox environment
.IP \(bu 2
\fI\%\-r\fP, \fI\%\-\-recreate\fP \- recreate the tox environments
.IP \(bu 2
\fI\%\-x\fP \fBOVERRIDE\fP, \fI\%\-\-override\fP \fBOVERRIDE\fP \- configuration override(s) (default: \fB[]\fP)
.UNINDENT
.SS tox exec verbosity
.INDENT 0.0
.IP \(bu 2
\fI\%\-v\fP, \fI\%\-\-verbose\fP \- increase verbosity (default: \fB2\fP)
.IP \(bu 2
\fI\%\-q\fP, \fI\%\-\-quiet\fP \- decrease verbosity (default: \fB0\fP)
.UNINDENT
.SS tox legacy (le)
.sp
legacy entry\-point command
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
tox legacy [\-h] [\-\-colored {yes,no}] [\-\-exit\-and\-dump\-after seconds] [\-c file]
           [\-\-workdir dir] [\-\-root dir] [\-\-runner {virtualenv}] [\-\-version] [\-v | \-q]
           [\-\-help\-ini] [\-\-showconfig] [\-a] [\-l] [\-\-devenv ENVDIR]
           [\-e ENV | \-m label [label ...] | \-f factor [factor ...] | \-\-skip\-env re]
           [\-\-result\-json path] [\-s [v]] [\-n] [\-b] [\-\-installpkg INSTALL_PKG] [\-\-develop]
           [\-\-hashseed SEED] [\-\-discover path [path ...]] [\-\-no\-recreate\-pkg]
           [\-\-skip\-pkg\-install] [\-p [VAL]] [\-o] [\-\-parallel\-no\-spinner] [\-\-pre]
           [\-\-force\-dep req] [\-\-sitepackages] [\-\-alwayscopy] [\-\-no\-provision [REQ_JSON]]
           [\-\-no\-recreate\-provision] [\-r] [\-x OVERRIDE]
.ft P
.fi
.UNINDENT
.UNINDENT
.SS tox legacy options
.INDENT 0.0
.IP \(bu 2
\fI\%\-h\fP, \fI\%\-\-help\fP \- show this help message and exit
.IP \(bu 2
\fI\%\-\-colored\fP \fBCOLORED\fP \- should output be enriched with colors, default is yes unless TERM=dumb or NO_COLOR is defined.
.IP \(bu 2
\fI\%\-\-exit\-and\-dump\-after\fP \fBSECONDS\fP \- dump tox threads after n seconds and exit the app \- useful to debug when tox hangs, 0 means disabled (default: \fB0\fP)
.IP \(bu 2
\fI\%\-c\fP \fBFILE\fP, \fI\%\-\-conf\fP \fBFILE\fP \- configuration file/folder for tox (if not specified will discover one) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-workdir\fP \fBDIR\fP \- tox working directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-root\fP \fBDIR\fP \- project root directory (if not specified will be the folder of the config file) (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-runner\fP \fBDEFAULT_RUNNER\fP \- the tox run engine to use when not explicitly stated in tox env configuration (default: \fBvirtualenv\fP)
.IP \(bu 2
\fI\%\-\-version\fP \- show program\(aqs and plugins version number and exit
.IP \(bu 2
\fI\%\-\-help\-ini\fP, \fI\%\-\-hi\fP \- show live configuration
.IP \(bu 2
\fI\%\-\-showconfig\fP \- show live configuration (by default all env, with \-l only default targets, specific via TOXENV/\-e)
.IP \(bu 2
\fI\%\-a\fP, \fI\%\-\-listenvs\-all\fP \- show list of all defined environments (with description if verbose)
.IP \(bu 2
\fI\%\-l\fP, \fI\%\-\-listenvs\fP \- show list of test environments (with description if verbose)
.IP \(bu 2
\fI\%\-\-devenv\fP \fBENVDIR\fP \- sets up a development environment at ENVDIR based on the env\(aqs tox configuration specified by\(ga\-e\(ga (\-e defaults to py)
.IP \(bu 2
\fI\%\-\-result\-json\fP \fBPATH\fP \- write a JSON file with detailed information about all commands and results involved (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-s\fP \fBV\fP, \fI\%\-\-skip\-missing\-interpreters\fP \fBV\fP \- don\(aqt fail tests for missing interpreters: \fB{config,true,false}\fP choice (default: \fBconfig\fP)
.IP \(bu 2
\fI\%\-n\fP, \fI\%\-\-notest\fP \- do not run the test commands
.IP \(bu 2
\fI\%\-b\fP, \fI\%\-\-pkg\-only\fP, \fI\%\-\-sdistonly\fP \- only perform the packaging activity
.IP \(bu 2
\fI\%\-\-installpkg\fP \fBINSTALL_PKG\fP \- use specified package for installation into venv, instead of packaging the project (default: \fBNone\fP)
.IP \(bu 2
\fI\%\-\-develop\fP \- install package in development mode
.IP \(bu 2
\fI\%\-\-hashseed\fP \fBSEED\fP \- set PYTHONHASHSEED to SEED before running commands. Defaults to a random integer in the range [1, 4294967295] ([1, 1024] on Windows). Passing \fB\(aqnoset\(aq\fP suppresses this behavior. (default: \fB787248758\fP)
.IP \(bu 2
\fI\%\-\-discover\fP \fBPATH\fP \- for Python discovery first try the Python executables under these paths (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-pkg\fP \- if recreate is set do not recreate packaging tox environment(s)
.IP \(bu 2
\fI\%\-\-skip\-pkg\-install\fP \- skip package installation for this run
.IP \(bu 2
\fI\%\-p\fP \fBVAL\fP, \fI\%\-\-parallel\fP \fBVAL\fP \- run tox environments in parallel, the argument controls limit: all, auto \- cpu count, some positive number, zero is turn off (default: \fB0\fP)
.IP \(bu 2
\fI\%\-o\fP, \fI\%\-\-parallel\-live\fP \- connect to stdout while running environments
.IP \(bu 2
\fI\%\-\-parallel\-no\-spinner\fP \- do not show the spinner
.IP \(bu 2
\fI\%\-\-pre\fP \- deprecated use PIP_PRE in set_env instead \- install pre\-releases and development versions ofdependencies; this will set PIP_PRE=1 environment variable
.IP \(bu 2
\fI\%\-\-force\-dep\fP \fBREQ\fP \- Forces a certain version of one of the dependencies when configuring the virtual environment. REQ Examples \fB\(aqpytest<6.1\(aq\fP or \fB\(aqdjango>=2.2\(aq\fP\&. (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-sitepackages\fP \- deprecated use VIRTUALENV_SYSTEM_SITE_PACKAGES=1, override sitepackages setting to True in all envs
.IP \(bu 2
\fI\%\-\-alwayscopy\fP \- deprecated use VIRTUALENV_ALWAYS_COPY=1, override always copy setting to True in all envs
.IP \(bu 2
\fI\%\-\-no\-provision\fP \fBREQ_JSON\fP \- do not perform provision, but fail and if a path was provided write provision metadata as JSON to it (default: \fBFalse\fP)
.IP \(bu 2
\fI\%\-\-no\-recreate\-provision\fP \- if recreate is set do not recreate provision tox environment
.IP \(bu 2
\fI\%\-r\fP, \fI\%\-\-recreate\fP \- recreate the tox environments
.IP \(bu 2
\fI\%\-x\fP \fBOVERRIDE\fP, \fI\%\-\-override\fP \fBOVERRIDE\fP \- configuration override(s) (default: \fB[]\fP)
.UNINDENT
.SS tox legacy verbosity
.INDENT 0.0
.IP \(bu 2
\fI\%\-v\fP, \fI\%\-\-verbose\fP \- increase verbosity (default: \fB2\fP)
.IP \(bu 2
\fI\%\-q\fP, \fI\%\-\-quiet\fP \- decrease verbosity (default: \fB0\fP)
.UNINDENT
.SS tox legacy select target environment(s)
.INDENT 0.0
.IP \(bu 2
\fI\%\-e\fP \fBENV\fP \- enumerate (ALL \-> all environments, not set \-> use <env_list> from config) (default: \fB<env_list>\fP)
.IP \(bu 2
\fI\%\-m\fP \fBLABEL\fP \- labels to evaluate (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-f\fP \fBFACTOR\fP \- factors to evaluate (passing multiple factors means \fB\(aqAND\(aq\fP, passing this option multiple times means \fB\(aqOR\(aq\fP) (default: \fB[]\fP)
.IP \(bu 2
\fI\%\-\-skip\-env\fP \fBRE\fP \- exclude all environments selected that match this regular expression (default: \fB\fP)
.UNINDENT
.SH ENVIRONMENT VARIABLES
.sp
TOXENV
.INDENT 0.0
.INDENT 3.5
comma separated list of environments (overridable by \(aq\-e\(aq)
.UNINDENT
.UNINDENT
.SH COPYRIGHT
2010-2023, tox-dev
.\" Generated by docutils manpage writer.
.