21552830208

Committed 31 Jan 2026 11:40PM UTC coverage: 80.277% (-0.05%) from 80.324%

Build # 21552830208

Build Type

Pull #23062

github

Committed by

web-flow

Commit Message

Merge 808a9786c into 2c4dcf9cf

Pull Request Pull Request #23062: Remove support for Get

Run Details

18 of 25 new or added lines in 4 files covered. (72.0%)

17119 existing lines in 541 files now uncovered.

78278 of 97510 relevant lines covered (80.28%)

3.36 hits per line

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

100.0

/src/python/pants/option/scope.py

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

from dataclasses import dataclass
from typing import Any, cast

from pants.option.option_value_container import OptionValueContainer

GLOBAL_SCOPE = ""
GLOBAL_SCOPE_CONFIG_SECTION = "GLOBAL"


def normalize_scope(scope: str):
    return scope.lower().replace("-", "_")


@dataclass(frozen=True)
class Scope:
    """An options scope."""

    scope: str


@dataclass(frozen=True, order=True)
class ScopeInfo:
    """Information about a scope."""

    scope: str
    subsystem_cls: type[Any] | None = None
    # A ScopeInfo may have a deprecated_scope (from its associated subsystem_cls), which represents
    # a previous/deprecated name for a current/non-deprecated ScopeInfo. It may also be directly
    # deprecated via this `removal_version`, which allows for the deprecation of an entire scope.
    removal_version: str | None = None
    removal_hint: str | None = None

    # Command line goal scope flag.
    is_goal: bool = False

    # Builtin goals, such as `help` and `version` etc.
    is_builtin: bool = False

    # Auxiliary goals, such as the `experimental-bsp` goal.
    is_auxiliary: bool = False

    @property
    def description(self) -> str:
        return cast(str, self._subsystem_cls_attr("help"))

    @property
    def deprecated_scope(self) -> str | None:
        return cast(str | None, self._subsystem_cls_attr("deprecated_options_scope"))

    @property
    def deprecated_scope_removal_version(self) -> str | None:
        return cast(
            str | None,
            self._subsystem_cls_attr("deprecated_options_scope_removal_version"),
        )

    @property
    def scope_aliases(self) -> tuple[str, ...]:
        """BuiltinGoal subsystems may define aliases."""
        return cast(tuple[str, ...], self._subsystem_cls_attr("aliases", ()))

    def _subsystem_cls_attr(self, name: str, default=None):
        return getattr(self.subsystem_cls, name, default) if self.subsystem_cls else default


@dataclass(frozen=True)
class OptionsParsingSettings:
    """Information derived from options bootstrapping used to parse full options."""

    known_scope_infos: tuple[ScopeInfo, ...]
    allow_unknown_options: bool


@dataclass(frozen=True)
class ScopedOptions:
    """A wrapper around options selected for a particular Scope."""

    scope: Scope
    options: OptionValueContainer

1	# Copyright 2015 Pants project contributors (see CONTRIBUTORS.md).
2	# Licensed under the Apache License, Version 2.0 (see LICENSE).
3
4	from dataclasses import dataclass	12✔
5	from typing import Any, cast	12✔
6
7	from pants.option.option_value_container import OptionValueContainer	12✔
8
9	GLOBAL_SCOPE = ""	12✔
10	GLOBAL_SCOPE_CONFIG_SECTION = "GLOBAL"	12✔
11
12
13	def normalize_scope(scope: str):	12✔
14	return scope.lower().replace("-", "_")	12✔
15
16
17	@dataclass(frozen=True)	12✔
18	class Scope:	12✔
19	"""An options scope."""
20
21	scope: str	12✔
22
23
24	@dataclass(frozen=True, order=True)	12✔
25	class ScopeInfo:	12✔
26	"""Information about a scope."""
27
28	scope: str	12✔
29	subsystem_cls: type[Any] \| None = None	12✔
30	# A ScopeInfo may have a deprecated_scope (from its associated subsystem_cls), which represents
31	# a previous/deprecated name for a current/non-deprecated ScopeInfo. It may also be directly
32	# deprecated via this `removal_version`, which allows for the deprecation of an entire scope.
33	removal_version: str \| None = None	12✔
34	removal_hint: str \| None = None	12✔
35
36	# Command line goal scope flag.
37	is_goal: bool = False	12✔
38
39	# Builtin goals, such as `help` and `version` etc.
40	is_builtin: bool = False	12✔
41
42	# Auxiliary goals, such as the `experimental-bsp` goal.
43	is_auxiliary: bool = False	12✔
44
45	@property	12✔
46	def description(self) -> str:	12✔
UNCOV 47	return cast(str, self._subsystem_cls_attr("help"))	3✔
48
49	@property	12✔
50	def deprecated_scope(self) -> str \| None:	12✔
51	return cast(str \| None, self._subsystem_cls_attr("deprecated_options_scope"))	12✔
52
53	@property	12✔
54	def deprecated_scope_removal_version(self) -> str \| None:	12✔
UNCOV 55	return cast(	1✔
56	str \| None,
57	self._subsystem_cls_attr("deprecated_options_scope_removal_version"),
58	)
59
60	@property	12✔
61	def scope_aliases(self) -> tuple[str, ...]:	12✔
62	"""BuiltinGoal subsystems may define aliases."""
63	return cast(tuple[str, ...], self._subsystem_cls_attr("aliases", ()))	12✔
64
65	def _subsystem_cls_attr(self, name: str, default=None):	12✔
66	return getattr(self.subsystem_cls, name, default) if self.subsystem_cls else default	12✔
67
68
69	@dataclass(frozen=True)	12✔
70	class OptionsParsingSettings:	12✔
71	"""Information derived from options bootstrapping used to parse full options."""
72
73	known_scope_infos: tuple[ScopeInfo, ...]	12✔
74	allow_unknown_options: bool	12✔
75
76
77	@dataclass(frozen=True)	12✔
78	class ScopedOptions:	12✔
79	"""A wrapper around options selected for a particular Scope."""
80
81	scope: Scope	12✔
82	options: OptionValueContainer	12✔

pantsbuild / pants / 21552830208

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