Metadata-Version: 2.4
Name: odoo-venv
Version: 2.0.1
Summary: A command-line tool to spin up isolated Odoo dev environment in seconds.
Author: trisdoan
Author-email: trisdoan <doanminhtri8183@gmail.com>
License-Expression: AGPL-3.0
License-File: LICENSE
Requires-Dist: typer==0.26.5
Requires-Dist: typing-extensions==4.15.0
Requires-Dist: tomli==2.4.1
Requires-Dist: packaging==26.2
Requires-Dist: odoo-addons-path==2.0.1
Requires-Dist: uv~=0.7.12 ; extra == 'build'
Requires-Python: >=3.10
Provides-Extra: build
Description-Content-Type: text/markdown

# odoo-venv

A command-line tool to spin up isolated Odoo dev environments in seconds.

```bash
uv tool install odoo-venv
```

**Documentation:** <https://trobz.github.io/odoo-venv>

## Contributing

### Setup

```bash
make install
```

Creates the project's `uv` virtual environment and installs the pre-commit hooks.

### Checks

```bash
make check
make test
```

`make check` verifies `uv.lock` is consistent with `pyproject.toml`, runs pre-commit
(ruff check + ruff format), and type-checks with `ty`. `make test` runs pytest with
`--doctest-modules`, so docstring examples under `odoo_venv/` execute as tests.

To test against a clean cache (no previously resolved packages):

```bash
uv cache clean --force
```

### Documentation

```bash
make docs-serve   # preview locally
make docs         # build
```

Sources live under `site-docs/docs/`, configured by `zensical.toml`. `site/` is
generated output and is gitignored — never edit it directly. Docs deploy
automatically on push to `main` when `site-docs/**` or `zensical.toml` changes.

### Commit messages

Conventional Commits are **required**. `python-semantic-release` derives the next
version and `CHANGELOG.md` from commit types on every push to `main`.

### Releases

Releases are automatic on merge to `main` — do not hand-edit `version` in
`pyproject.toml` or `CHANGELOG.md`.
