• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

pantsbuild / pants / 22285099215

22 Feb 2026 08:52PM UTC coverage: 75.854% (-17.1%) from 92.936%
22285099215

Pull #23121

github

web-flow
Merge c7299df9c into ba8359840
Pull Request #23121: fix issue with optional fields in dependency validator

28 of 29 new or added lines in 2 files covered. (96.55%)

11174 existing lines in 400 files now uncovered.

53694 of 70786 relevant lines covered (75.85%)

1.88 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

93.33
/src/python/pants/util/docutil.py
1
# Copyright 2020 Pants project contributors (see CONTRIBUTORS.md).
2
# Licensed under the Apache License, Version 2.0 (see LICENSE).
3

4

5
from __future__ import annotations
4✔
6

7
import shutil
4✔
8

9
from pants.engine.internals.native_engine import py_bin_name
4✔
10
from pants.version import MAJOR_MINOR, PANTS_SEMVER
4✔
11

12

13
# NB: This is not memoized because that would cause Pants to not pick up terminal resizing when
14
# using pantsd.
15
def terminal_width(*, fallback: int = 96, padding: int = 2) -> int:
4✔
UNCOV
16
    return shutil.get_terminal_size(fallback=(fallback, 24)).columns - padding
×
17

18

19
_VERSIONED_PREFIXES = ("docs/", "reference/")
4✔
20

21

22
def doc_url(path: str) -> str:
4✔
23
    """Return a URL to the specified `path` on the Pants website.
24

25
    The path should be the part of the URL after the domain, ignoring the version, e.g.:
26

27
    - to link to https://www.pantsbuild.org/community/getting-help, pass `"/community/getting-help"`
28

29
    - to link to the current version of
30
      https://www.pantsbuild.org/2.19/docs/python/overview/enabling-python-support, pass
31
      `"docs/python/overview/enabling-python-support"`
32
    """
33
    versioned = any(path.startswith(prefix) for prefix in _VERSIONED_PREFIXES)
4✔
34
    version_info = f"{MAJOR_MINOR}/" if versioned else ""
4✔
35
    return f"https://www.pantsbuild.org/{version_info}{path}"
4✔
36

37

38
def git_url(fp: str) -> str:
4✔
39
    """Link to code in pantsbuild/pants."""
40
    return f"https://github.com/pantsbuild/pants/blob/release_{PANTS_SEMVER}/{fp}"
4✔
41

42

43
def bin_name() -> str:
4✔
44
    """Return the Pants binary name, e.g. 'pants'.
45

46
    Can be configured with the pants_bin_name option.
47
    """
48
    return py_bin_name()
4✔
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc