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

81.97

/src/python/pants/help/help_tools.py

# Copyright 2021 Pants project contributors (see CONTRIBUTORS.md).
# Licensed under the Apache License, Version 2.0 (see LICENSE).
from __future__ import annotations

from collections.abc import Generator, Iterable
from dataclasses import dataclass
from functools import partial
from itertools import chain
from textwrap import wrap
from typing import cast

from pants.help.help_info_extracter import AllHelpInfo, OptionScopeHelpInfo
from pants.help.maybe_color import MaybeColor
from pants.util.docutil import terminal_width


@dataclass(frozen=True)
class ToolHelpInfo:
    name: str
    description: str
    version: str
    url_template: str | None

    @classmethod
    def from_option_scope_help_info(cls, oshi: OptionScopeHelpInfo) -> ToolHelpInfo | None:
        version, url_template = cls._get_tool_info(oshi)
        if not version:
            return None
        return cls(
            name=oshi.scope,
            description=oshi.description,
            version=version,
            url_template=url_template,
        )

    @classmethod
    def iter(cls, all_help_info: AllHelpInfo) -> Generator[ToolHelpInfo, None, None]:
        for oshi in all_help_info.non_deprecated_option_scope_help_infos():
            tool_info = cls.from_option_scope_help_info(oshi)
            if tool_info:
                yield tool_info

    @staticmethod
    def print_all(tool_help_infos: Iterable[ToolHelpInfo], color: MaybeColor) -> None:
        this = tuple(tool_help_infos)
        longest_name = max(len(tool.name) for tool in this)
        width = terminal_width()

        for tool in this:
            tool.print(color, description_padding=longest_name + 2, width=width)

    def print(self, color: MaybeColor, description_padding: int, width: int) -> None:
        _wrap = partial(wrap, width=width)
        _max_padding = partial(
            min, int(width / 4)
        )  # Do not use more than 25% of the width on padding.

        def _indent(indent: int) -> str:
            return " " * cast(int, _max_padding(indent))

        lines = _wrap(
            f"{self.name.ljust(description_padding)}{self.description}",
            subsequent_indent=_indent(description_padding),
        )
        lines[0] = lines[0].replace(self.name, color.maybe_cyan(self.name), 1)
        version = _wrap(
            f"Version: {self.version}",
            initial_indent=_indent(description_padding),
            subsequent_indent=_indent(description_padding),
        )
        if not self.url_template:
            url_template = []
        else:
            url_template = _wrap(
                f"URL template: {self.url_template}",
                initial_indent=_indent(description_padding),
                subsequent_indent=_indent(description_padding),
            )
        print("\n".join(lines))
        print(color.maybe_magenta("\n".join([*version, *url_template, ""])))

    @classmethod
    def _get_tool_info(cls, oshi: OptionScopeHelpInfo) -> tuple[str | None, str | None]:
        return (
            cls._get_option_value(oshi, "version"),
            cls._get_option_value(oshi, "url_template"),
        )

    @staticmethod
    def _get_option_value(oshi: OptionScopeHelpInfo, config_key: str) -> str | None:
        for ohi in chain(oshi.basic, oshi.advanced):
            if ohi.config_key == config_key and ohi.typ is str:
                rank = ohi.value_history and ohi.value_history.final_value
                if rank:
                    info = f" ({rank.details})" if rank.details else ""
                    return f"{rank.value}{info}"
                return cast(str, ohi.default)
        return None

1	# Copyright 2021 Pants project contributors (see CONTRIBUTORS.md).
2	# Licensed under the Apache License, Version 2.0 (see LICENSE).
3	from __future__ import annotations	12✔
4
5	from collections.abc import Generator, Iterable	12✔
6	from dataclasses import dataclass	12✔
7	from functools import partial	12✔
8	from itertools import chain	12✔
9	from textwrap import wrap	12✔
10	from typing import cast	12✔
11
12	from pants.help.help_info_extracter import AllHelpInfo, OptionScopeHelpInfo	12✔
13	from pants.help.maybe_color import MaybeColor	12✔
14	from pants.util.docutil import terminal_width	12✔
15
16
17	@dataclass(frozen=True)	12✔
18	class ToolHelpInfo:	12✔
19	name: str	12✔
20	description: str	12✔
21	version: str	12✔
22	url_template: str \| None	12✔
23
24	@classmethod	12✔
25	def from_option_scope_help_info(cls, oshi: OptionScopeHelpInfo) -> ToolHelpInfo \| None:	12✔
UNCOV 26	version, url_template = cls._get_tool_info(oshi)	1✔
UNCOV 27	if not version:	1✔
UNCOV 28	return None	1✔
UNCOV 29	return cls(	1✔
30	name=oshi.scope,
31	description=oshi.description,
32	version=version,
33	url_template=url_template,
34	)
35
36	@classmethod	12✔
37	def iter(cls, all_help_info: AllHelpInfo) -> Generator[ToolHelpInfo, None, None]:	12✔
38	for oshi in all_help_info.non_deprecated_option_scope_help_infos():	×
39	tool_info = cls.from_option_scope_help_info(oshi)	×
40	if tool_info:	×
41	yield tool_info	×
42
43	@staticmethod	12✔
44	def print_all(tool_help_infos: Iterable[ToolHelpInfo], color: MaybeColor) -> None:	12✔
45	this = tuple(tool_help_infos)	×
46	longest_name = max(len(tool.name) for tool in this)	×
47	width = terminal_width()	×
48
49	for tool in this:	×
50	tool.print(color, description_padding=longest_name + 2, width=width)	×
51
52	def print(self, color: MaybeColor, description_padding: int, width: int) -> None:	12✔
UNCOV 53	_wrap = partial(wrap, width=width)	1✔
UNCOV 54	_max_padding = partial(	1✔
55	min, int(width / 4)
56	) # Do not use more than 25% of the width on padding.
57
UNCOV 58	def _indent(indent: int) -> str:	1✔
UNCOV 59	return " " * cast(int, _max_padding(indent))	1✔
60
UNCOV 61	lines = _wrap(	1✔
62	f"{self.name.ljust(description_padding)}{self.description}",
63	subsequent_indent=_indent(description_padding),
64	)
UNCOV 65	lines[0] = lines[0].replace(self.name, color.maybe_cyan(self.name), 1)	1✔
UNCOV 66	version = _wrap(	1✔
67	f"Version: {self.version}",
68	initial_indent=_indent(description_padding),
69	subsequent_indent=_indent(description_padding),
70	)
UNCOV 71	if not self.url_template:	1✔
72	url_template = []	×
73	else:
UNCOV 74	url_template = _wrap(	1✔
75	f"URL template: {self.url_template}",
76	initial_indent=_indent(description_padding),
77	subsequent_indent=_indent(description_padding),
78	)
UNCOV 79	print("\n".join(lines))	1✔
UNCOV 80	print(color.maybe_magenta("\n".join([version, url_template, ""])))	1✔
81
82	@classmethod	12✔
83	def _get_tool_info(cls, oshi: OptionScopeHelpInfo) -> tuple[str \| None, str \| None]:	12✔
UNCOV 84	return (	1✔
85	cls._get_option_value(oshi, "version"),
86	cls._get_option_value(oshi, "url_template"),
87	)
88
89	@staticmethod	12✔
90	def _get_option_value(oshi: OptionScopeHelpInfo, config_key: str) -> str \| None:	12✔
UNCOV 91	for ohi in chain(oshi.basic, oshi.advanced):	1✔
UNCOV 92	if ohi.config_key == config_key and ohi.typ is str:	1✔
UNCOV 93	rank = ohi.value_history and ohi.value_history.final_value	1✔
UNCOV 94	if rank:	1✔
UNCOV 95	info = f" ({rank.details})" if rank.details else ""	1✔
UNCOV 96	return f"{rank.value}{info}"	1✔
97	return cast(str, ohi.default)	×
UNCOV 98	return None	1✔

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