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

pantsbuild / pants / 23173035367

17 Mar 2026 12:47AM UTC coverage: 91.371% (-1.6%) from 92.933%
23173035367

push

github

web-flow
update helm (and friends) to a recent 3.x seies (#23143)

v4 is a major breaking change, so holding off on that. (There was also
just a 3.20, but 3.19 has this reassuring series of bug fixes and was
also quite recent.)

2 of 2 new or added lines in 2 files covered. (100.0%)

1263 existing lines in 73 files now uncovered.

86196 of 94336 relevant lines covered (91.37%)

3.87 hits per line

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

94.29
/src/python/pants/engine/intrinsics.py
1
# Copyright 2024 Pants project contributors (see CONTRIBUTORS.md).
2
# Licensed under the Apache License, Version 2.0 (see LICENSE).
3

4
from __future__ import annotations
11✔
5

6
import dataclasses
11✔
7
import logging
11✔
8

9
from pants.engine.environment import EnvironmentName
11✔
10
from pants.engine.fs import (
11✔
11
    AddPrefix,
12
    CreateDigest,
13
    Digest,
14
    DigestContents,
15
    DigestEntries,
16
    DigestSubset,
17
    MergeDigests,
18
    NativeDownloadFile,
19
    PathGlobs,
20
    PathMetadataRequest,
21
    PathMetadataResult,
22
    Paths,
23
    RemovePrefix,
24
    Snapshot,
25
)
26
from pants.engine.internals import native_engine
11✔
27
from pants.engine.internals.docker import DockerResolveImageRequest, DockerResolveImageResult
11✔
28
from pants.engine.internals.native_dep_inference import (
11✔
29
    NativeDockerfileInfos,
30
    NativeJavascriptFilesDependencies,
31
    NativePythonFilesDependencies,
32
)
33
from pants.engine.internals.native_engine import NativeDependenciesRequest, task_side_effected
11✔
34
from pants.engine.internals.session import RunId, SessionValues
11✔
35
from pants.engine.process import (
11✔
36
    FallibleProcessResult,
37
    InteractiveProcess,
38
    InteractiveProcessResult,
39
    Process,
40
    ProcessExecutionEnvironment,
41
    ProcessResultWithRetries,
42
    ProcessWithRetries,
43
)
44
from pants.engine.rules import _uncacheable_rule, collect_rules, implicitly, rule
11✔
45
from pants.util.docutil import git_url
11✔
46
from pants.util.frozendict import FrozenDict
11✔
47

48

49
@rule
11✔
50
async def create_digest(
11✔
51
    create_digest: CreateDigest,
52
) -> Digest:
53
    return await native_engine.create_digest(create_digest)
11✔
54

55

56
@rule
11✔
57
async def path_globs_to_digest(
11✔
58
    path_globs: PathGlobs,
59
) -> Digest:
60
    return await native_engine.path_globs_to_digest(path_globs)
11✔
61

62

63
@rule
11✔
64
async def path_globs_to_paths(
11✔
65
    path_globs: PathGlobs,
66
) -> Paths:
67
    return await native_engine.path_globs_to_paths(path_globs)
11✔
68

69

70
@rule
11✔
71
async def download_file(
11✔
72
    native_download_file: NativeDownloadFile,
73
) -> Digest:
74
    return await native_engine.download_file(native_download_file)
11✔
75

76

77
@rule
11✔
78
async def digest_to_snapshot(digest: Digest) -> Snapshot:
11✔
79
    return await native_engine.digest_to_snapshot(digest)
11✔
80

81

82
@rule
11✔
83
async def get_digest_contents(digest: Digest) -> DigestContents:
11✔
84
    return await native_engine.get_digest_contents(digest)
11✔
85

86

87
@rule
11✔
88
async def get_digest_entries(digest: Digest) -> DigestEntries:
11✔
89
    return await native_engine.get_digest_entries(digest)
11✔
90

91

92
@rule
11✔
93
async def merge_digests(merge_digests: MergeDigests) -> Digest:
11✔
94
    return await native_engine.merge_digests(merge_digests)
11✔
95

96

97
@rule
11✔
98
async def remove_prefix(remove_prefix: RemovePrefix) -> Digest:
11✔
99
    return await native_engine.remove_prefix(remove_prefix)
11✔
100

101

102
@rule
11✔
103
async def add_prefix(add_prefix: AddPrefix) -> Digest:
11✔
104
    return await native_engine.add_prefix(add_prefix)
11✔
105

106

107
@rule
11✔
108
async def execute_process(
11✔
109
    process: Process, process_execution_environment: ProcessExecutionEnvironment
110
) -> FallibleProcessResult:
111
    return await native_engine.execute_process(process, process_execution_environment)
11✔
112

113

114
@rule
11✔
115
async def execute_process_with_retry(req: ProcessWithRetries) -> ProcessResultWithRetries:
11✔
116
    results: list[FallibleProcessResult] = []
9✔
117
    for attempt in range(0, req.attempts):
9✔
118
        proc = dataclasses.replace(req.proc, attempt=attempt)
9✔
119
        result = await execute_process(proc, **implicitly())
9✔
120
        results.append(result)
9✔
121
        if result.exit_code == 0:
9✔
122
            break
9✔
123
    return ProcessResultWithRetries(tuple(results))
9✔
124

125

126
@rule
11✔
127
async def digest_subset_to_digest(digest_subset: DigestSubset) -> Digest:
11✔
128
    return await native_engine.digest_subset_to_digest(digest_subset)
11✔
129

130

131
@rule
11✔
132
async def session_values() -> SessionValues:
11✔
133
    return await native_engine.session_values()
11✔
134

135

136
@rule
11✔
137
async def run_id() -> RunId:
11✔
138
    return await native_engine.run_id()
1✔
139

140

141
__SQUELCH_WARNING = "__squelch_warning"
11✔
142

143

144
# NB: Call one of the helpers below, instead of calling this rule directly,
145
#  to ensure correct application of restartable logic.
146
@_uncacheable_rule
11✔
147
async def _interactive_process(
11✔
148
    process: InteractiveProcess, process_execution_environment: ProcessExecutionEnvironment
149
) -> InteractiveProcessResult:
150
    # This is a crafty way for a caller to signal into this function without a dedicated arg
151
    # (which would confound the solver).  Note that we go via __dict__ instead of using
152
    # setattr/delattr, because those error for frozen dataclasses.
153
    if __SQUELCH_WARNING in process.__dict__:
5✔
154
        del process.__dict__[__SQUELCH_WARNING]
5✔
155
    else:
156
        logging.warning(
×
157
            "A plugin is calling `await _interactive_process(...)` directly. This will cause "
158
            "restarting logic not to be applied. Use `await run_interactive_process(process)` "
159
            "or `await run_interactive_process_in_environment(process, environment_name)` instead. "
160
            f"See {git_url('src/python/pants/engine/intrinsics.py')} for more details."
161
        )
162
    return await native_engine.interactive_process(process, process_execution_environment)
5✔
163

164

165
async def run_interactive_process(process: InteractiveProcess) -> InteractiveProcessResult:
11✔
166
    # NB: We must call task_side_effected() in this helper, rather than in a nested @rule call,
167
    #  so that the Task for the @rule that calls this helper is the one marked as non-restartable.
168
    if not process.restartable:
6✔
169
        task_side_effected()
6✔
170

171
    process.__dict__[__SQUELCH_WARNING] = True
6✔
172
    ret: InteractiveProcessResult = await _interactive_process(process, **implicitly())
6✔
173
    return ret
6✔
174

175

176
async def run_interactive_process_in_environment(
11✔
177
    process: InteractiveProcess, environment_name: EnvironmentName
178
) -> InteractiveProcessResult:
179
    # NB: We must call task_side_effected() in this helper, rather than in a nested @rule call,
180
    #  so that the Task for the @rule that calls this helper is the one marked as non-restartable.
UNCOV
181
    if not process.restartable:
×
UNCOV
182
        task_side_effected()
×
183

UNCOV
184
    process.__dict__[__SQUELCH_WARNING] = True
×
UNCOV
185
    ret: InteractiveProcessResult = await _interactive_process(
×
186
        process, **implicitly({environment_name: EnvironmentName})
187
    )
UNCOV
188
    return ret
×
189

190

191
@rule
11✔
192
async def docker_resolve_image(request: DockerResolveImageRequest) -> DockerResolveImageResult:
11✔
193
    return await native_engine.docker_resolve_image(request)
2✔
194

195

196
@rule
11✔
197
async def parse_dockerfile_info(
11✔
198
    deps_request: NativeDependenciesRequest,
199
) -> NativeDockerfileInfos:
200
    path_infos_pairs = await native_engine.parse_dockerfile_info(deps_request)
7✔
201
    return NativeDockerfileInfos(FrozenDict(path_infos_pairs))
7✔
202

203

204
@rule
11✔
205
async def parse_python_deps(
11✔
206
    deps_request: NativeDependenciesRequest,
207
) -> NativePythonFilesDependencies:
208
    path_deps_pairs = await native_engine.parse_python_deps(deps_request)
10✔
209
    return NativePythonFilesDependencies(FrozenDict(path_deps_pairs))
10✔
210

211

212
@rule
11✔
213
async def parse_javascript_deps(
11✔
214
    deps_request: NativeDependenciesRequest,
215
) -> NativeJavascriptFilesDependencies:
216
    path_deps_pairs = await native_engine.parse_javascript_deps(deps_request)
4✔
217
    return NativeJavascriptFilesDependencies(FrozenDict(path_deps_pairs))
4✔
218

219

220
@rule
11✔
221
async def path_metadata_request(request: PathMetadataRequest) -> PathMetadataResult:
11✔
222
    return await native_engine.path_metadata_request(request)
11✔
223

224

225
def rules():
11✔
226
    return [
11✔
227
        *collect_rules(),
228
    ]
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