#20885 `peek` documentation example output is outdated/incomplete Issue created by huonw Describe the bug We have docs around the peek goal that include some example output: https://www.pantsbuild.org/2.20/docs/using-pants/project-introspection#peek---programmatically-inspect-a-target This hasn't been updated for various changes (very easy to forget). For instance, running

PANTS_VERSION=2.20.1 pants peek helloworld/greet:tests

in https://github.com/pantsbuild/example-python gives:

[
  {
    "address": "helloworld/greet:tests",
    "target_type": "python_tests",
    "dependencies": [
      "helloworld/greet/greeting_test.py:tests"
    ],
    "description": null,
    "overrides": null,
    "skip_black": false,
    "skip_docformatter": false,
    "skip_flake8": false,
    "skip_isort": false,
    "skip_mypy": false,
    "sources": [
      "helloworld/greet/greeting_test.py"
    ],
    "sources_fingerprint": "2158e096d5ab63e537d88067b50a0274b83f6373143faf854d4a9adf5d01cf78",
    "sources_raw": [
      "test_*.py",
      "*_test.py",
      "tests.py"
    ],
    "tags": null
  }
]

This has various differences: •

sources

is now the actual file paths •

source_fingerprint

is a hash of the above •

sources_raw

is new In 2.21, Running on a single file path has various new fields too, like

goals

. Pants version 2.20, 2.21 OS macOS Additional info N/A pantsbuild/pants