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

94.29

/src/python/pants/build_graph/address.py

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

from __future__ import annotations

import dataclasses
from collections.abc import Iterable
from dataclasses import dataclass

from pants.base.exceptions import MappingError
from pants.engine.engine_aware import EngineAwareParameter
from pants.engine.internals.native_engine import (  # noqa: F401
    BANNED_CHARS_IN_GENERATED_NAME as BANNED_CHARS_IN_GENERATED_NAME,
)
from pants.engine.internals.native_engine import (  # noqa: F401
    BANNED_CHARS_IN_PARAMETERS as BANNED_CHARS_IN_PARAMETERS,
)
from pants.engine.internals.native_engine import (  # noqa: F401
    BANNED_CHARS_IN_TARGET_NAME as BANNED_CHARS_IN_TARGET_NAME,
)
from pants.engine.internals.native_engine import Address as Address  # noqa: F401
from pants.engine.internals.native_engine import AddressInput as AddressInput  # noqa: F401
from pants.engine.internals.native_engine import (  # noqa: F401
    AddressParseException as AddressParseException,
)
from pants.engine.internals.native_engine import (  # noqa: F401
    InvalidAddressError as InvalidAddressError,
)
from pants.engine.internals.native_engine import (  # noqa: F401
    InvalidParametersError as InvalidParametersError,
)
from pants.engine.internals.native_engine import (  # noqa: F401
    InvalidSpecPathError as InvalidSpecPathError,
)
from pants.engine.internals.native_engine import (  # noqa: F401
    InvalidTargetNameError as InvalidTargetNameError,
)
from pants.engine.internals.native_engine import (  # noqa: F401
    UnsupportedWildcardError as UnsupportedWildcardError,
)
from pants.util.strutil import bullet_list, softwrap


@dataclass(frozen=True)
class BuildFileAddressRequest(EngineAwareParameter):
    """A request to find the BUILD file path for an address."""

    address: Address
    description_of_origin: str = dataclasses.field(hash=False, compare=False)

    def debug_hint(self) -> str:
        return self.address.spec


@dataclass(frozen=True)
class BuildFileAddress:
    """An address, along with the relative file path of its BUILD file."""

    address: Address
    rel_path: str


class ResolveError(MappingError):
    """Indicates an error resolving targets."""

    @classmethod
    def did_you_mean(
        cls,
        bad_address: Address,
        *,
        description_of_origin: str,
        known_names: Iterable[str],
        namespace: str,
    ) -> ResolveError:
        return cls(
            softwrap(
                f"""
                The address {bad_address} from {description_of_origin} does not exist.

                The target name ':{bad_address.target_name}' is not defined in the directory
                {namespace}. Did you mean one of these target names?\n
                """
                + bullet_list(f":{name}" for name in known_names)
            )
        )


@dataclass(frozen=True)
class MaybeAddress:
    """A target address, or an error if it could not be created.

    Note that this does not validate the address's target actually exists. It only validates that
    the address is well-formed and that its spec_path exists.

    Reminder: you may need to catch errors when creating the input `AddressInput` if the address is
    not well-formed.
    """

    val: Address | ResolveError

1	# Copyright 2014 Pants project contributors (see CONTRIBUTORS.md).
2	# Licensed under the Apache License, Version 2.0 (see LICENSE).
3
4	from __future__ import annotations	1✔
5
6	import dataclasses	1✔
7	from collections.abc import Iterable	1✔
8	from dataclasses import dataclass	1✔
9
10	from pants.base.exceptions import MappingError	1✔
11	from pants.engine.engine_aware import EngineAwareParameter	1✔
12	from pants.engine.internals.native_engine import ( # noqa: F401	1✔
13	BANNED_CHARS_IN_GENERATED_NAME as BANNED_CHARS_IN_GENERATED_NAME,
14	)
15	from pants.engine.internals.native_engine import ( # noqa: F401	1✔
16	BANNED_CHARS_IN_PARAMETERS as BANNED_CHARS_IN_PARAMETERS,
17	)
18	from pants.engine.internals.native_engine import ( # noqa: F401	1✔
19	BANNED_CHARS_IN_TARGET_NAME as BANNED_CHARS_IN_TARGET_NAME,
20	)
21	from pants.engine.internals.native_engine import Address as Address # noqa: F401	1✔
22	from pants.engine.internals.native_engine import AddressInput as AddressInput # noqa: F401	1✔
23	from pants.engine.internals.native_engine import ( # noqa: F401	1✔
24	AddressParseException as AddressParseException,
25	)
26	from pants.engine.internals.native_engine import ( # noqa: F401	1✔
27	InvalidAddressError as InvalidAddressError,
28	)
29	from pants.engine.internals.native_engine import ( # noqa: F401	1✔
30	InvalidParametersError as InvalidParametersError,
31	)
32	from pants.engine.internals.native_engine import ( # noqa: F401	1✔
33	InvalidSpecPathError as InvalidSpecPathError,
34	)
35	from pants.engine.internals.native_engine import ( # noqa: F401	1✔
36	InvalidTargetNameError as InvalidTargetNameError,
37	)
38	from pants.engine.internals.native_engine import ( # noqa: F401	1✔
39	UnsupportedWildcardError as UnsupportedWildcardError,
40	)
41	from pants.util.strutil import bullet_list, softwrap	1✔
42
43
44	@dataclass(frozen=True)	1✔
45	class BuildFileAddressRequest(EngineAwareParameter):	1✔
46	"""A request to find the BUILD file path for an address."""
47
48	address: Address	1✔
49	description_of_origin: str = dataclasses.field(hash=False, compare=False)	1✔
50
51	def debug_hint(self) -> str:	1✔
52	return self.address.spec	×
53
54
55	@dataclass(frozen=True)	1✔
56	class BuildFileAddress:	1✔
57	"""An address, along with the relative file path of its BUILD file."""
58
59	address: Address	1✔
60	rel_path: str	1✔
61
62
63	class ResolveError(MappingError):	1✔
64	"""Indicates an error resolving targets."""
65
66	@classmethod	1✔
67	def did_you_mean(	1✔
68	cls,
69	bad_address: Address,
70	*,
71	description_of_origin: str,
72	known_names: Iterable[str],
73	namespace: str,
74	) -> ResolveError:
UNCOV 75	return cls(	×
76	softwrap(
77	f"""
78	The address {bad_address} from {description_of_origin} does not exist.
79
80	The target name ':{bad_address.target_name}' is not defined in the directory
81	{namespace}. Did you mean one of these target names?\n
82	"""
83	+ bullet_list(f":{name}" for name in known_names)
84	)
85	)
86
87
88	@dataclass(frozen=True)	1✔
89	class MaybeAddress:	1✔
90	"""A target address, or an error if it could not be created.
91
92	Note that this does not validate the address's target actually exists. It only validates that
93	the address is well-formed and that its spec_path exists.
94
95	Reminder: you may need to catch errors when creating the input `AddressInput` if the address is
96	not well-formed.
97	"""
98
99	val: Address \| ResolveError	1✔

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