boilercine_tools.sync#

Sync tools.

Module Contents#

Classes#

Lock

Lockfile.

Compiler

Compiler.

Compilation

Compilation.

Functions#

check_compilation

Check compilation, re-lock if incompatible, and return the requirements.

lock

Lock.

get_uv_version

Get version of uv at bin/uv.

get_directs

Get directs.

get_lockfile

Get lockfile path.

compile

Compile dependencies.

get_subs

Get submodules.

get_submodule_info

Get submodule info.

escape

Escape a path, suitable for passing to e.g. run().

Data#

MINIMUM_PYTHON

This project’s default Python version.

REQS

Requirements.

DEV

Other development tools and editable local dependencies.

DEPS

Paths to compile dependencies for.

OVERRIDES

Overrides to satisfy otherwise incompatible combinations.

NODEPS

Path to dependencies which should not have their transitive dependencies compiled.

REQUIREMENTS

Requirements.

NAME_PAT

Regular expression for a legal Python package name.

OP_PAT

Regular expression for valid version separators.

API#

boilercine_tools.sync.MINIMUM_PYTHON#

‘3.11’

This project’s default Python version.

boilercine_tools.sync.REQS#

‘Path(…)’

Requirements.

boilercine_tools.sync.DEV#

None

Other development tools and editable local dependencies.

boilercine_tools.sync.DEPS#

()

Paths to compile dependencies for.

boilercine_tools.sync.OVERRIDES#

None

Overrides to satisfy otherwise incompatible combinations.

boilercine_tools.sync.NODEPS#

None

Path to dependencies which should not have their transitive dependencies compiled.

boilercine_tools.sync.REQUIREMENTS#

None

Requirements.

class boilercine_tools.sync.Lock#

Lockfile.

time: str#

None

uv: str#

None

minimum_python: boilercine_tools.types.PythonVersion#

None

paths: tuple[str, ...]#

None

overrides: str#

None

directs: dict[str, boilercine_tools.types.Dep]#

None

direct_requirements: str#

None

requirements: str#

None

boilercine_tools.sync.check_compilation(
high: bool = False,
) str#

Check compilation, re-lock if incompatible, and return the requirements.

boilercine_tools.sync.lock(
directs: dict[str, boilercine_tools.types.Dep] | None = None,
high: bool = False,
) str#

Lock.

boilercine_tools.sync.get_uv_version() str#

Get version of uv at bin/uv.

class boilercine_tools.sync.Compiler#

Compiler.

uv: str#

‘field(…)’

Version of uv used to compile.

python_version: boilercine_tools.types.PythonVersion#

None

Python version compiled for.

high: bool#

False

Highest dependencies.

no_deps: bool#

False

Without transitive dependencies.

overrides: pathlib.Path#

None

Overrides.

paths: tuple[pathlib.Path, ...]#

None

Paths compiled from, such as requirements.in or pyproject.toml.

get_command() tuple[datetime.datetime, list[str]]#

Command to reproduce compilation requirements.

compile(
time: datetime.datetime = datetime.min,
directs: dict[str, boilercine_tools.types.Dep] | None = None,
) boilercine_tools.sync.Compilation#

Compile dependencies.

boilercine_tools.sync.NAME_PAT#

‘[A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9._-]*[A-Za-z0-9]’

Regular expression for a legal Python package name.

See: https://packaging.python.org/en/latest/specifications/name-normalization/#name-format

boilercine_tools.sync.OP_PAT#

‘join(…)’

Regular expression for valid version separators.

boilercine_tools.sync.get_directs(
requirements: str | None = None,
) dict[str, boilercine_tools.types.Dep]#

Get directs.

class boilercine_tools.sync.Compilation#

Compilation.

compiler: boilercine_tools.sync.Compiler#

‘field(…)’

Compiler used to compile.

time: datetime.datetime#

None

Time of compilation.

requirements: str = <Multiline-String>#

Result of compilation.

directs: dict[str, boilercine_tools.types.Dep]#

‘field(…)’

Direct dependencies and their revisions.

__post_init__()#
boilercine_tools.sync.get_lockfile(
high: bool = False,
) pathlib.Path#

Get lockfile path.

boilercine_tools.sync.compile(
compiler: boilercine_tools.sync.Compiler,
) tuple[datetime.datetime, str]#

Compile dependencies.

boilercine_tools.sync.get_subs() dict[str, boilercine_tools.types.Dep]#

Get submodules.

boilercine_tools.sync.get_submodule_info(
kind: boilercine_tools.types.SubmoduleInfoKind,
) list[str]#

Get submodule info.

boilercine_tools.sync.escape(
path: str | pathlib.Path,
) str#

Escape a path, suitable for passing to e.g. run().