summaryrefslogtreecommitdiff
path: root/docs/man/tox-stages.1
diff options
context:
space:
mode:
Diffstat (limited to 'docs/man/tox-stages.1')
-rw-r--r--docs/man/tox-stages.113
1 files changed, 13 insertions, 0 deletions
diff --git a/docs/man/tox-stages.1 b/docs/man/tox-stages.1
index 8e05bb7..8b04815 100644
--- a/docs/man/tox-stages.1
+++ b/docs/man/tox-stages.1
@@ -14,6 +14,7 @@
.Op Fl f Ar filename
.Cm run
.Op Fl Fl arg Ar arg... | Fl A Ar arg...
+.Op Fl Fl match\-spec Ar spec | Fl m Ar spec
.Op Fl Fl parallel Ar spec | Fl p Ar spec
.Op Ar stage...
.Sh DESCRIPTION
@@ -83,6 +84,11 @@ subcommand accepts the following options:
Pass an additional command-line argument to each Tox invocation.
This option may be specified more than once, and the arguments will be
passed in the order given.
+.It Fl Fl match\-spec Ar spec | Fl m Ar spec
+Pass an additional specification for Tox environments to satisfy,
+e.g.
+.Dq -m '@check'
+to only run static checkers and not unit tests.
.It Fl Fl parallel Ar spec | Fl p Ar spec
Specify which stages to run in parallel.
The
@@ -136,6 +142,13 @@ parameter:
.Pp
.Dl tox-stages run
.Pp
+Group Tox environments into stages as defined in the
+.Pa pyproject.toml
+file, but then only run the ones marked with the "check" tag that also have
+names containing the string "format":
+.Pp
+.Dl tox-stages run -m '@check and format'
+.Pp
Run a specific set of stages, passing
.Ar -- -k slug
as additional