19015773527

Committed 02 Nov 2025 05:33PM UTC coverage: 17.872% (-62.4%) from 80.3%

Build # 19015773527

Build Type

Pull #22816

github

Committed by

web-flow

Commit Message

Merge a12d75757 into 6c024e162

Pull Request Pull Request #22816: Update Pants internal Python to 3.14

Run Details

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

28452 existing lines in 683 files now uncovered.

9831 of 55007 relevant lines covered (17.87%)

0.18 hits per line

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

61.7

/src/python/pants/base/build_root.py

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

import os
from collections.abc import Iterator
from contextlib import contextmanager
from pathlib import Path

from pants.util.meta import SingletonMetaclass


class BuildRoot(metaclass=SingletonMetaclass):
    """Represents the global workspace build root.

    By default, a Pants workspace is defined by a root directory where one of multiple sentinel
    files resides, such as `pants.toml` or `BUILD_ROOT`. This path can also be manipulated through
    this interface for re-location of the build root in tests.
    """

    sentinel_files = ["pants.toml", "pants", "BUILDROOT", "BUILD_ROOT"]

    class NotFoundError(Exception):
        """Raised when unable to find the current workspace build root."""

    def find_buildroot(self) -> str:
        buildroot = Path.cwd().resolve()
        while not any((buildroot / sentinel).is_file() for sentinel in self.sentinel_files):
            if buildroot != buildroot.parent:
                buildroot = buildroot.parent
            else:
                raise self.NotFoundError(
                    "No build root detected. Pants detects the build root by looking for at least one file "
                    f"from {self.sentinel_files} in the cwd and its ancestors. If you have none of these "
                    f"files, you can create an empty file in your build root."
                )
        return str(buildroot)

    def __init__(self) -> None:
        self._root_dir: str | None = None

    @property
    def pathlib_path(self) -> Path:
        return Path(self.path)

    @property
    def path(self) -> str:
        """Returns the build root for the current workspace."""
        if self._root_dir is None:
            # Do not remove/change this env var without coordinating with `pantsbuild/scie-pants` as
            # it is being used when bootstrapping Pants.
            override_buildroot = os.environ.get("PANTS_BUILDROOT_OVERRIDE", None)
            if override_buildroot:
                self._root_dir = override_buildroot
            else:
                self._root_dir = os.path.realpath(self.find_buildroot())
        return self._root_dir

    @path.setter
    def path(self, root_dir: str) -> None:
        """Manually establishes the build root for the current workspace."""
        path = os.path.realpath(root_dir)
        if not os.path.exists(path):
            raise ValueError(f"Build root does not exist: {root_dir}")
        self._root_dir = path

    def reset(self) -> None:
        """Clears the last calculated build root for the current workspace."""
        self._root_dir = None

    def __str__(self) -> str:
        return f"BuildRoot({self._root_dir})"

    @contextmanager
    def temporary(self, path: str) -> Iterator[None]:
        """Establishes a temporary build root, restoring the prior build root on exit."""
        if path is None:
            raise ValueError("Can only temporarily establish a build root given a path.")
        prior = self._root_dir
        self._root_dir = path
        try:
            yield
        finally:
            self._root_dir = prior

1	# Copyright 2014 Pants project contributors (see CONTRIBUTORS.md).
2	# Licensed under the Apache License, Version 2.0 (see LICENSE).
3
4	import os	1✔
5	from collections.abc import Iterator	1✔
6	from contextlib import contextmanager	1✔
7	from pathlib import Path	1✔
8
9	from pants.util.meta import SingletonMetaclass	1✔
10
11
12	class BuildRoot(metaclass=SingletonMetaclass):	1✔
13	"""Represents the global workspace build root.
14
15	By default, a Pants workspace is defined by a root directory where one of multiple sentinel
16	files resides, such as `pants.toml` or `BUILD_ROOT`. This path can also be manipulated through
17	this interface for re-location of the build root in tests.
18	"""
19
20	sentinel_files = ["pants.toml", "pants", "BUILDROOT", "BUILD_ROOT"]	1✔
21
22	class NotFoundError(Exception):	1✔
23	"""Raised when unable to find the current workspace build root."""
24
25	def find_buildroot(self) -> str:	1✔
26	buildroot = Path.cwd().resolve()	1✔
27	while not any((buildroot / sentinel).is_file() for sentinel in self.sentinel_files):	1✔
UNCOV 28	if buildroot != buildroot.parent:	×
UNCOV 29	buildroot = buildroot.parent	×
30	else:
UNCOV 31	raise self.NotFoundError(	×
32	"No build root detected. Pants detects the build root by looking for at least one file "
33	f"from {self.sentinel_files} in the cwd and its ancestors. If you have none of these "
34	f"files, you can create an empty file in your build root."
35	)
36	return str(buildroot)	1✔
37
38	def __init__(self) -> None:	1✔
39	self._root_dir: str \| None = None	1✔
40
41	@property	1✔
42	def pathlib_path(self) -> Path:	1✔
43	return Path(self.path)	×
44
45	@property	1✔
46	def path(self) -> str:	1✔
47	"""Returns the build root for the current workspace."""
48	if self._root_dir is None:	1✔
49	# Do not remove/change this env var without coordinating with `pantsbuild/scie-pants` as
50	# it is being used when bootstrapping Pants.
51	override_buildroot = os.environ.get("PANTS_BUILDROOT_OVERRIDE", None)	1✔
52	if override_buildroot:	1✔
UNCOV 53	self._root_dir = override_buildroot	×
54	else:
55	self._root_dir = os.path.realpath(self.find_buildroot())	1✔
56	return self._root_dir	1✔
57
58	@path.setter	1✔
59	def path(self, root_dir: str) -> None:	1✔
60	"""Manually establishes the build root for the current workspace."""
UNCOV 61	path = os.path.realpath(root_dir)	×
UNCOV 62	if not os.path.exists(path):	×
63	raise ValueError(f"Build root does not exist: {root_dir}")	×
UNCOV 64	self._root_dir = path	×
65
66	def reset(self) -> None:	1✔
67	"""Clears the last calculated build root for the current workspace."""
UNCOV 68	self._root_dir = None	×
69
70	def __str__(self) -> str:	1✔
71	return f"BuildRoot({self._root_dir})"	×
72
73	@contextmanager	1✔
74	def temporary(self, path: str) -> Iterator[None]:	1✔
75	"""Establishes a temporary build root, restoring the prior build root on exit."""
UNCOV 76	if path is None:	×
77	raise ValueError("Can only temporarily establish a build root given a path.")	×
UNCOV 78	prior = self._root_dir	×
UNCOV 79	self._root_dir = path	×
UNCOV 80	try:	×
UNCOV 81	yield	×
82	finally:
UNCOV 83	self._root_dir = prior	×

pantsbuild / pants / 19015773527

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