rules/python/pex_toolchain.js

Developer reference: this page includes exported implementation details. BUILD authors should prefer the User API reference.

PEX_TOOL

const PEX_TOOL

Undocumented.

pexCacheKey()

pexCacheKey(version)

Undocumented.

pexDownloadUrl()

pexDownloadUrl(version)

Return the pex zipapp download URL for a version.

Returns: string

PexToolchain (implementation class)

class PexToolchain

Implementation class. BUILD files should use pexToolchain().

Undocumented.

pexToolchain()

pexToolchain(version, opts = {})

Declare a pex toolchain version and optionally set it as the default. matching lockfile entry (warns instead of failing).

Returns: object Target handle for this pex toolchain.

installPexToolchain()

installPexToolchain(version, source)

Install a local pex zipapp into the named cache.

Returns: string|null Local path to the cached zipapp.

acquirePexToolchain

const acquirePexToolchain

Acquire a pex toolchain, downloading and caching it if not already installed in the named cache.

Returns: Promise<string> Local path to the toolchain directory (containing pex).

resolvePexToolchainVersion()

resolvePexToolchainVersion(version)

Resolve an explicit or default pex toolchain version.

Returns: string|null

pexRootTool()

pexRootTool()

Return a named-cache-backed tool descriptor mounting PEX's shared PEX_ROOT cache at a stable path, read-write across every sandbox. Not put on PATH (binDirs empty) — pair with pexRootEnv() to point $PEX_ROOT at its mount path.

Returns: object

pexRootEnv()

pexRootEnv()

Return the run() env entries pointing pex at its shared PEX_ROOT tool mount (see pexRootTool). Any run() using this must also include that tool, or the path won't exist in the sandbox. Values are relative to the sandbox root — callers must export them as absolute paths (capturing $(pwd) before any cd) rather than passing them via run()'s own env:, exactly as zigGlobalCacheEnv()'s doc comment in rules/c/zig/index.js explains for ZIG_GLOBAL_CACHE_DIR.

Returns: string[]

defaultPexToolchainVersion()

defaultPexToolchainVersion()

Return the currently configured default pex toolchain version.

Returns: string|null

defaultPexToolchain()

defaultPexToolchain()

Return the currently configured default pex toolchain target handle.

Returns: object|null