pantsbuild / pants / 19050398641
80%

DEFAULT BRANCH: main
Ran
Jobs 12
Files 1716
Run time 5min
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst
coverage: 80.3% (-0.003%) from 80.303%
19050398641

push

github

web-flow 
A new "pants next-gen" command-line parser. (#22808)

This supports the command/subcommand paradigm, rather than
the "list of goals" paradigm of the existing cli parser.

This is experimental, not wired up to anything yet, and intended to
support a hypothetical "next-generation Pants" (pants_ng for short).

It is not intended to replicate all current Pants CLI nuances, but is a
much simpler design based on our experience with the complexities
of the current CLI parser.

In particular,  this new CLI parser does not need to know in advance 
about any registered goals and options. The old parser needed this
to tell the difference between specs and goals, and this added a
lot of complexity for little gain. This was also ambiguous, since
introduction of a new goal could change the meaning of an existing
invocation.

This parser instead *requires* specs to contain a filepath separator,
anything else is a flag or a command or a subcommand, and those
are easily distinguished by syntax alone. A spec path in the root dir
can be prefixed with `./` to meet this requirement.

This parser supports multiple cmd/subcommand pairs, each with 
flags, by separating them with a standalone `+` character. This,
again, removes ambiguity.

This parser supports only long flags (prefixed by `--`). We currently
support a handful of short flags (such as `-l`), but those cause
ambiguity since we also use a single dash prefix for negating
specs.

See https://github.com/pantsbuild/pants/discussions/22692 for context.

77992 of 97126 relevant lines covered (80.3%)

3.35 hits per line

Uncovered Existing Lines

Lines Coverage ∆ File
1
34.97
 -0.16% src/python/pants/engine/internals/graph.py
2
87.69
 -3.08% src/python/pants/pantsd/lock_test.py
Jobs
ID Job ID Ran Files Coverage
1 test_python_linux_x86_64_7/10 - 19050398641.1 1183
42.71
 GitHub Action Run
2 test_python_linux_x86_64_3/10 - 19050398641.2 1176
45.66
 GitHub Action Run
3 test_python_linux_arm64 - 19050398641.3 1161
43.22
 GitHub Action Run
4 test_python_linux_x86_64_2/10 - 19050398641.4 1179
46.94
 GitHub Action Run
5 test_python_linux_x86_64_0/10 - 19050398641.5 1197
45.54
 GitHub Action Run
6 test_python_linux_x86_64_8/10 - 19050398641.6 1179
45.46
 GitHub Action Run
7 test_python_linux_x86_64_4/10 - 19050398641.7 1209
49.95
 GitHub Action Run
8 test_python_linux_x86_64_9/10 - 19050398641.8 1184
45.1
 GitHub Action Run
9 test_python_linux_x86_64_6/10 - 19050398641.9 1173
40.77
 GitHub Action Run
10 test_python_linux_x86_64_5/10 - 19050398641.10 1193
48.17
 GitHub Action Run
11 test_python_macos14_arm64 - 19050398641.11 1161
43.23
 GitHub Action Run
12 test_python_linux_x86_64_1/10 - 19050398641.12 1176
40.24
 GitHub Action Run
Source Files on build 19050398641