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

pantsbuild / pants / 21038851336

15 Jan 2026 04:37PM UTC coverage: 78.666% (-1.6%) from 80.269%
21038851336

push

github

web-flow
update to Pex 2.81.0 (#23018)

Release Notes:
 * https://github.com/pex-tool/pex/releases/tag/v2.80.0
 * https://github.com/pex-tool/pex/releases/tag/v2.81.0

3 of 3 new or added lines in 1 file covered. (100.0%)

1077 existing lines in 52 files now uncovered.

75010 of 95353 relevant lines covered (78.67%)

3.17 hits per line

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

88.89
/src/python/pants/backend/docker/registries.py
1
# Copyright 2021 Pants project contributors (see CONTRIBUTORS.md).
2
# Licensed under the Apache License, Version 2.0 (see LICENSE).
3

4
from __future__ import annotations
10✔
5

6
from collections.abc import Iterator
10✔
7
from dataclasses import dataclass
10✔
8
from typing import Any
10✔
9

10
from pants.util.frozendict import FrozenDict
10✔
11
from pants.util.strutil import softwrap
10✔
12

13
ALL_DEFAULT_REGISTRIES = "<all default registries>"
10✔
14

15

16
class DockerRegistryError(ValueError):
10✔
17
    pass
10✔
18

19

20
class DockerRegistryOptionsNotFoundError(DockerRegistryError):
10✔
21
    def __init__(self, message):
10✔
UNCOV
22
        super().__init__(
×
23
            f"{message}\n\n"
24
            "Use the [docker].registries configuration option to define custom registries."
25
        )
26

27

28
class DockerRegistryAddressCollisionError(DockerRegistryError):
10✔
29
    def __init__(self, first, second):
10✔
UNCOV
30
        message = softwrap(
×
31
            f"""
32
            Duplicated docker registry address for aliases: {first.alias}, {second.alias}.
33
            Each registry `address` in `[docker].registries` must be unique.
34
            """
35
        )
36

UNCOV
37
        super().__init__(message)
×
38

39

40
@dataclass(frozen=True)
10✔
41
class DockerRegistryOptions:
10✔
42
    address: str
10✔
43
    alias: str = ""
10✔
44
    default: bool = False
10✔
45
    skip_push: bool = False
10✔
46
    extra_image_tags: tuple[str, ...] = ()
10✔
47
    repository: str | None = None
10✔
48
    use_local_alias: bool = False
10✔
49

50
    @classmethod
10✔
51
    def from_dict(cls, alias: str, d: dict[str, Any]) -> DockerRegistryOptions:
10✔
52
        return cls(
2✔
53
            alias=alias,
54
            address=d["address"],
55
            default=d.get("default", alias == "default"),
56
            skip_push=d.get("skip_push", DockerRegistryOptions.skip_push),
57
            extra_image_tags=tuple(
58
                d.get("extra_image_tags", DockerRegistryOptions.extra_image_tags)
59
            ),
60
            repository=d.get("repository"),
61
            use_local_alias=d.get("use_local_alias", False),
62
        )
63

64
    def register(self, registries: dict[str, DockerRegistryOptions]) -> None:
10✔
65
        if self.address in registries:
2✔
UNCOV
66
            collision = registries[self.address]
×
UNCOV
67
            raise DockerRegistryAddressCollisionError(collision, self)
×
68
        registries[self.address] = self
2✔
69
        if self.alias:
2✔
70
            registries[f"@{self.alias}"] = self
2✔
71

72

73
@dataclass(frozen=True)
10✔
74
class DockerRegistries:
10✔
75
    default: tuple[DockerRegistryOptions, ...]
10✔
76
    registries: FrozenDict[str, DockerRegistryOptions]
10✔
77

78
    @classmethod
10✔
79
    def from_dict(cls, d: dict[str, Any]) -> DockerRegistries:
10✔
80
        registries: dict[str, DockerRegistryOptions] = {}
2✔
81
        for alias, options in d.items():
2✔
82
            DockerRegistryOptions.from_dict(alias, options).register(registries)
2✔
83
        return cls(
2✔
84
            default=tuple(
85
                sorted({r for r in registries.values() if r.default}, key=lambda r: r.address)
86
            ),
87
            registries=FrozenDict(registries),
88
        )
89

90
    def get(self, *aliases_or_addresses: str) -> Iterator[DockerRegistryOptions]:
10✔
91
        for alias_or_address in aliases_or_addresses:
2✔
92
            if alias_or_address in self.registries:
2✔
93
                # Get configured registry by "@alias" or "address".
94
                yield self.registries[alias_or_address]
2✔
95
            elif alias_or_address.startswith("@"):
2✔
UNCOV
96
                raise DockerRegistryOptionsNotFoundError(
×
97
                    f"There is no Docker registry configured with alias: {alias_or_address[1:]}."
98
                )
99
            elif alias_or_address == ALL_DEFAULT_REGISTRIES:
2✔
100
                yield from self.default
2✔
101
            else:
102
                # Assume an explicit address from the BUILD file.
103
                yield DockerRegistryOptions(address=alias_or_address)
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