deps_rocker.docker_cli

Helpers for running Docker builds via the docker CLI.

Attributes

OutputCallback

Functions

_prepare_env(→ MutableMapping[str, str])

Return an env mapping with BuildKit guaranteed to be enabled.

_build_cli_command(→ list[str])

Construct a docker build command.

_stream_process_output(→ None)

Forward process output to the optional callback.

run_docker_cli(→ Optional[str])

Execute the docker CLI command and return the resulting image identifier if available.

docker_build_with_cli(→ Optional[str])

High level helper used by the rocker patch to build with the docker CLI.

Module Contents

deps_rocker.docker_cli.OutputCallback
deps_rocker.docker_cli._prepare_env(env: MutableMapping[str, str] | None = None) MutableMapping[str, str]

Return an env mapping with BuildKit guaranteed to be enabled.

deps_rocker.docker_cli._build_cli_command(*, path: str, tag: str | None, rm: bool, nocache: bool, pull: bool, dockerfile: str | None, buildargs: Dict[str, Any] | None) list[str]

Construct a docker build command.

deps_rocker.docker_cli._stream_process_output(process: subprocess.Popen[str], output_callback: OutputCallback) None

Forward process output to the optional callback.

deps_rocker.docker_cli.run_docker_cli(*, command: Sequence[str], env: Mapping[str, str], output_callback: OutputCallback = None) str | None

Execute the docker CLI command and return the resulting image identifier if available.

deps_rocker.docker_cli.docker_build_with_cli(*, path: str, tag: str | None, rm: bool, nocache: bool, pull: bool, dockerfile: str | None, buildargs: Dict[str, Any] | None, output_callback: OutputCallback, env: MutableMapping[str, str] | None = None) str | None

High level helper used by the rocker patch to build with the docker CLI.