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

pantsbuild / pants / 22740642519

05 Mar 2026 11:00PM UTC coverage: 52.677% (-40.3%) from 92.931%
22740642519

Pull #23157

github

web-flow
Merge 2aa18e6d4 into f0030f5e7
Pull Request #23157: [pants ng] Partition source files by config.

31678 of 60136 relevant lines covered (52.68%)

0.53 hits per line

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

69.05
/src/python/pants/backend/docker/util_rules/docker_build_env.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
1✔
5

6
import logging
1✔
7
from collections.abc import Mapping
1✔
8
from dataclasses import dataclass
1✔
9

10
from pants.backend.docker.subsystems.docker_options import DockerOptions
1✔
11
from pants.backend.docker.util_rules.docker_build_args import (
1✔
12
    DockerBuildArgsRequest,
13
    docker_build_args,
14
)
15
from pants.backend.docker.utils import KeyValueSequenceUtil
1✔
16
from pants.core.util_rules.env_vars import environment_vars_subset
1✔
17
from pants.engine.env_vars import EnvironmentVars, EnvironmentVarsRequest
1✔
18
from pants.engine.rules import collect_rules, implicitly, rule
1✔
19
from pants.engine.target import Target
1✔
20

21
logger = logging.getLogger(__name__)
1✔
22

23

24
class DockerBuildEnvironmentError(ValueError):
1✔
25
    @classmethod
1✔
26
    def from_key_error(cls, e: KeyError) -> DockerBuildEnvironmentError:
1✔
27
        return cls(
×
28
            f"The Docker environment variable {e} is undefined. You may provide a value for "
29
            "this variable either in `[docker].env_vars` or in Pants's own environment."
30
        )
31

32

33
@dataclass(frozen=True)
1✔
34
class DockerBuildEnvironment:
1✔
35
    environment: EnvironmentVars
1✔
36

37
    @classmethod
1✔
38
    def create(
1✔
39
        cls,
40
        env: Mapping[str, str],
41
    ) -> DockerBuildEnvironment:
42
        return cls(EnvironmentVars(env))
×
43

44
    def __getitem__(self, key: str) -> str:
1✔
45
        try:
×
46
            return self.environment[key]
×
47
        except KeyError as e:
×
48
            raise DockerBuildEnvironmentError.from_key_error(e) from e
×
49

50
    def get(self, key: str, default: str | None = None) -> str:
1✔
51
        if default is None:
×
52
            return self[key]
×
53

54
        return self.environment.get(key, default)
×
55

56

57
@dataclass(frozen=True)
1✔
58
class DockerBuildEnvironmentRequest:
1✔
59
    target: Target
1✔
60

61

62
@rule
1✔
63
async def docker_build_environment_vars(
1✔
64
    request: DockerBuildEnvironmentRequest,
65
    docker_options: DockerOptions,
66
    docker_env_aware: DockerOptions.EnvironmentAware,
67
) -> DockerBuildEnvironment:
68
    build_args = await docker_build_args(DockerBuildArgsRequest(request.target), **implicitly())
×
69
    env_vars = KeyValueSequenceUtil.from_strings(
×
70
        *{build_arg for build_arg in build_args if "=" not in build_arg},
71
        *docker_env_aware.env_vars,
72
    )
73
    env = await environment_vars_subset(EnvironmentVarsRequest(tuple(env_vars)), **implicitly())
×
74
    return DockerBuildEnvironment.create(env)
×
75

76

77
def rules():
1✔
78
    return collect_rules()
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