# podman-smart-boot Python reference

Reference implementation of the label-driven startup controller as a `uv` Python package.

## Install

```bash
cd /root/tools/podman-smart-boot/python
uv sync
```

## Run

```bash
uv run podman-smart-boot-py schema
uv run podman-smart-boot-py plan
uv run podman-smart-boot-py run
```

## Quality commands

```bash
uv run ruff format src tests
uv run ruff check src tests
uv run pytest
uv build --no-sources
```

## Private registry

Install from the private DevPI registry with:

```bash
pip install --index-url https://pypi.registry.hochguertel.work/root/dev/+simple/ podman-smart-boot
```

Publish with `uv` using the configured `hochguertel-pypi` index:

```bash
UV_PUBLISH_USERNAME=...
UV_PUBLISH_PASSWORD=...
uv publish --index hochguertel-pypi
```

## Test layout

- `tests/unit` — pure helpers such as parsing, batching, and plan rendering
- `tests/integration` — Podman discovery, health gating, and batch execution with mocked command calls
- `tests/e2e` — CLI execution through the installed module entrypoint with a fake `podman` binary

The Python version is intended to evolve fastest and stay close to the behavior validated on the
real host.
