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

pantsbuild / pants / 19381742489

15 Nov 2025 12:52AM UTC coverage: 49.706% (-30.6%) from 80.29%
19381742489

Pull #22890

github

web-flow
Merge d961abf79 into 42e1ebd41
Pull Request #22890: Updated all python subsystem constraints to 3.14

4 of 5 new or added lines in 5 files covered. (80.0%)

14659 existing lines in 485 files now uncovered.

31583 of 63540 relevant lines covered (49.71%)

0.79 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
2✔
6

7
import shutil
2✔
8

9
from pants.engine.internals.native_engine import py_bin_name
2✔
10
from pants.version import MAJOR_MINOR, PANTS_SEMVER
2✔
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:
2✔
UNCOV
16
    return shutil.get_terminal_size(fallback=(fallback, 24)).columns - padding
×
17

18

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

21

22
def doc_url(path: str) -> str:
2✔
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)
2✔
34
    version_info = f"{MAJOR_MINOR}/" if versioned else ""
2✔
35
    return f"https://www.pantsbuild.org/{version_info}{path}"
2✔
36

37

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

42

43
def bin_name() -> str:
2✔
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()
2✔
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

© 2025 Coveralls, Inc