18827312341

Committed 27 Oct 2025 01:50AM UTC coverage: 65.106% (-15.2%) from 80.279%

Build # 18827312341

Build Type

Pull #22806

github

Committed by

web-flow

Commit Message

Merge 082bdd4c2 into 170094e99

Pull Request Pull Request #22806: Updated Javascript dependencies and re-locked

Run Details

3 of 3 new or added lines in 3 files covered. (100.0%)

8118 existing lines in 291 files now uncovered.

48695 of 74793 relevant lines covered (65.11%)

1.81 hits per line

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

93.33

/src/python/pants/util/docutil.py

# Copyright 2020 Pants project contributors (see CONTRIBUTORS.md).
# Licensed under the Apache License, Version 2.0 (see LICENSE).


from __future__ import annotations

import shutil

from pants.engine.internals.native_engine import py_bin_name
from pants.version import MAJOR_MINOR, PANTS_SEMVER


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


_VERSIONED_PREFIXES = ("docs/", "reference/")


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

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

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

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


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


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

    Can be configured with the pants_bin_name option.
    """
    return py_bin_name()

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	5✔
6
7	import shutil	5✔
8
9	from pants.engine.internals.native_engine import py_bin_name	5✔
10	from pants.version import MAJOR_MINOR, PANTS_SEMVER	5✔
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:	5✔
UNCOV 16	return shutil.get_terminal_size(fallback=(fallback, 24)).columns - padding	×
17
18
19	_VERSIONED_PREFIXES = ("docs/", "reference/")	5✔
20
21
22	def doc_url(path: str) -> str:	5✔
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)	5✔
34	version_info = f"{MAJOR_MINOR}/" if versioned else ""	5✔
35	return f"https://www.pantsbuild.org/{version_info}{path}"	5✔
36
37
38	def git_url(fp: str) -> str:	5✔
39	"""Link to code in pantsbuild/pants."""
40	return f"https://github.com/pantsbuild/pants/blob/release_{PANTS_SEMVER}/{fp}"	5✔
41
42
43	def bin_name() -> str:	5✔
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()	5✔

pantsbuild / pants / 18827312341

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

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