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().