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

pantsbuild / pants / 20333307239

18 Dec 2025 10:07AM UTC coverage: 75.452% (-4.8%) from 80.295%
20333307239

Pull #22949

github

web-flow
Merge b07232683 into 407284c67
Pull Request #22949: Add experimental uv resolver for Python lockfiles

51 of 96 new or added lines in 5 files covered. (53.13%)

2857 existing lines in 120 files now uncovered.

66315 of 87890 relevant lines covered (75.45%)

2.78 hits per line

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

98.15
/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
8✔
5

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

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

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

15

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

19

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

27

28
class DockerRegistryAddressCollisionError(DockerRegistryError):
8✔
29
    def __init__(self, first, second):
8✔
30
        message = softwrap(
1✔
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

37
        super().__init__(message)
1✔
38

39

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

50
    @classmethod
8✔
51
    def from_dict(cls, alias: str, d: dict[str, Any]) -> DockerRegistryOptions:
8✔
52
        return cls(
1✔
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:
8✔
65
        if self.address in registries:
1✔
66
            collision = registries[self.address]
1✔
67
            raise DockerRegistryAddressCollisionError(collision, self)
1✔
68
        registries[self.address] = self
1✔
69
        if self.alias:
1✔
70
            registries[f"@{self.alias}"] = self
1✔
71

72

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

78
    @classmethod
8✔
79
    def from_dict(cls, d: dict[str, Any]) -> DockerRegistries:
8✔
80
        registries: dict[str, DockerRegistryOptions] = {}
1✔
81
        for alias, options in d.items():
1✔
82
            DockerRegistryOptions.from_dict(alias, options).register(registries)
1✔
83
        return cls(
1✔
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]:
8✔
91
        for alias_or_address in aliases_or_addresses:
1✔
92
            if alias_or_address in self.registries:
1✔
93
                # Get configured registry by "@alias" or "address".
94
                yield self.registries[alias_or_address]
1✔
95
            elif alias_or_address.startswith("@"):
1✔
96
                raise DockerRegistryOptionsNotFoundError(
1✔
97
                    f"There is no Docker registry configured with alias: {alias_or_address[1:]}."
98
                )
99
            elif alias_or_address == ALL_DEFAULT_REGISTRIES:
1✔
UNCOV
100
                yield from self.default
×
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

© 2025 Coveralls, Inc