• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

pantsbuild / pants / 22898465085

10 Mar 2026 10:37AM UTC coverage: 92.932%. Remained the same
22898465085

Pull #23032

github

web-flow
Merge 4bf2e958f into 2804a4673
Pull Request #23032: Bugfix: Add support for pull option in podman

87 of 93 new or added lines in 4 files covered. (93.55%)

2 existing lines in 2 files now uncovered.

91041 of 97965 relevant lines covered (92.93%)

4.06 hits per line

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

96.15
/src/python/pants/backend/tools/preamble/subsystem.py
1
# Copyright 2022 Pants project contributors (see CONTRIBUTORS.md).
2
# Licensed under the Apache License, Version 2.0 (see LICENSE).
3
from __future__ import annotations
1✔
4

5
from collections.abc import Sequence
1✔
6

7
from pants.option.option_types import DictOption, SkipOption
1✔
8
from pants.option.subsystem import Subsystem
1✔
9
from pants.source.filespec import FilespecMatcher
1✔
10
from pants.util.strutil import help_text, softwrap
1✔
11

12

13
class PreambleSubsystem(Subsystem):
1✔
14
    options_scope = "preamble"
1✔
15
    name = "preamble"
1✔
16
    help = help_text(
1✔
17
        """
18
        Formats files with a preamble, with the preamble looked up based on path.
19

20
        This is useful for things such as copyright headers or shebang lines.
21

22
        Pants substitutes the following identifiers (following Python's `string.Template` substitutions):
23
        - $year: The current year (only used when actually writing the year to the file).
24
        """
25
    )
26

27
    skip = SkipOption("fmt")
1✔
28

29
    _template_by_globs = DictOption[str](
1✔
30
        help=softwrap(
31
            """
32
            Which preamble template to use based on the path globs (relative to the build root).
33

34
            Example:
35

36
                {
37
                    '*.rs': '// Copyright (c) $year\\n// Line 2\\n'
38
                    '*.py:!__init__.py': '# Copyright (c) $year\\n# Line 2\\n',
39
                }
40

41
            It might be helpful to load this config from a JSON or YAML file. To do that, set
42
            `[preamble].config = '@path/to/config.yaml'`, for example.
43
            """
44
        ),
45
        fromfile=True,
46
    )
47

48
    @property
1✔
49
    def template_by_globs(self) -> dict[tuple[str, ...], str]:
1✔
50
        return {tuple(key.split(":")): value for key, value in self._template_by_globs.items()}
1✔
51

52
    def get_template_by_path(self, filepaths: Sequence[str]) -> dict[str, str]:
1✔
53
        """Returns a mapping from path to (most-relevant) template."""
54
        filepaths_to_test = set(filepaths)
1✔
55
        template_by_path = {}
1✔
56
        for globs, template in self.template_by_globs.items():
1✔
57
            if not filepaths_to_test:
1✔
UNCOV
58
                break
×
59

60
            matched_filepaths = FilespecMatcher(
1✔
61
                includes=[
62
                    (glob[2:] if glob.startswith(r"\\!") else glob)
63
                    for glob in globs
64
                    if not glob.startswith("!")
65
                ],
66
                excludes=[glob[1:] for glob in globs if glob.startswith("!")],
67
            ).matches(tuple(filepaths_to_test))
68
            filepaths_to_test -= set(matched_filepaths)
1✔
69
            for filepath in matched_filepaths:
1✔
70
                template_by_path[filepath] = template
1✔
71

72
        return template_by_path
1✔
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc