odoo-cli-official 0.1.0__tar.gz

odoo_cli_official-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.ruff_cache/
+dist/
+build/
+.DS_Store
+
+# Virtual environment
+.venv/
+
+# Ondeck
+.ondeck

odoo_cli_official-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Frederic van der Essen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

odoo_cli_official-0.1.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: odoo-cli-official
+Version: 0.1.0
+Summary: CLI tool to manage and develop local Odoo instances
+Project-URL: Homepage, https://github.com/fvdsn/odoo-cli
+Project-URL: Repository, https://github.com/fvdsn/odoo-cli
+Project-URL: Issues, https://github.com/fvdsn/odoo-cli/issues
+Author: Frederic van der Essen
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,development,odoo,postgresql
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# odoo-cli
+
+A CLI tool to manage and develop local Odoo instances: one workspace, git
+worktrees for multitasking across versions, shared venvs, derived database
+names, and automatic port allocation — with the filesystem, the database, and
+`odoo/odoo/release.py` as the only sources of truth. The full design lives in
+[`docs/`](docs/) (`requirements.md`, `architecture.md`, `usecase.md`).
+
+## Install
+
+```bash
+uv tool install odoo-cli-official   # installs the `odoo` executable
+```
+
+Runtime is the Python standard library plus a vendored
+[click](https://click.palletsprojects.com) (Python 3.11+); nothing else.
+
+## Quick start
+
+```bash
+odoo init                 # workspace at ~/odoo, latest stable, empty db
+odoo module install crm
+odoo start                # foreground; Ctrl-C to stop
+```
+
+The workspace looks like:
+
+```text
+~/.config/odoo/odoo.conf  <- the only config file (Odoo's own format/location)
+~/odoo/
+    .repositories/        <- shared bare clones (presence = enabled)
+    .venvs/19.0/          <- one venv per detected Odoo version
+    .run/19.0/19.0/ports  <- allocated ports per (worktree, database)
+    19.0/                 <- a worktree: odoo/, documentation/, ...
+```
+
+## Daily commands
+
+| Command | Description |
+|---|---|
+| `odoo start [-d DB] [--new-port] [--prod]` | Start the server (foreground) |
+| `odoo where [--json]` | Show the resolved context + exact odoo-bin command |
+| `odoo update [modules]` | Update modules (default: all installed) |
+| `odoo module install <modules>` | Install modules (creates the db if needed) |
+| `odoo test <module\|installed\|all> [-t tag]` | Run tests in `{db}-test` |
+| `odoo shell [-c CODE]` | Odoo Python REPL / one-shot execution |
+| `odoo db reset` | Drop + recreate, reinstalling the db's module set |
+| `odoo config get/set/list` | Edit the shared odoo.conf |
+| `odoo repo enable <enterprise\|themes\|upgrade>` | Enable an optional repo |
+| `odoo repo add <name> <url>` | Clone a custom addon repository |
+| `odoo worktree create <name> [version] [--linked-from SRC --addon REPO]` | New worktree |
+| `odoo venv` | Rebuild the venv for the current worktree |
+
+Commands infer their target from the current directory (or `-w`/`-d`); the
+database defaults to the worktree name.
+
+## Development
+
+```bash
+# any Python >= 3.11 (a bare `python` may resolve to an older interpreter)
+python3 -m unittest discover           # unit + cli + integration (fast, no network)
+ODOO_CLI_E2E=1 ODOO_CLI_E2E_ODOO_REPO=~/src/odoo \
+    python3 -m unittest discover tests/e2e -v  # real-Odoo flows (slow, opt-in)
+```
+
+Architecture, layering rules, and the testing strategy are documented in
+[`docs/architecture.md`](docs/architecture.md).

odoo_cli_official-0.1.0/README.md

@@ -0,0 +1,67 @@
+# odoo-cli
+
+A CLI tool to manage and develop local Odoo instances: one workspace, git
+worktrees for multitasking across versions, shared venvs, derived database
+names, and automatic port allocation — with the filesystem, the database, and
+`odoo/odoo/release.py` as the only sources of truth. The full design lives in
+[`docs/`](docs/) (`requirements.md`, `architecture.md`, `usecase.md`).
+
+## Install
+
+```bash
+uv tool install odoo-cli-official   # installs the `odoo` executable
+```
+
+Runtime is the Python standard library plus a vendored
+[click](https://click.palletsprojects.com) (Python 3.11+); nothing else.
+
+## Quick start
+
+```bash
+odoo init                 # workspace at ~/odoo, latest stable, empty db
+odoo module install crm
+odoo start                # foreground; Ctrl-C to stop
+```
+
+The workspace looks like:
+
+```text
+~/.config/odoo/odoo.conf  <- the only config file (Odoo's own format/location)
+~/odoo/
+    .repositories/        <- shared bare clones (presence = enabled)
+    .venvs/19.0/          <- one venv per detected Odoo version
+    .run/19.0/19.0/ports  <- allocated ports per (worktree, database)
+    19.0/                 <- a worktree: odoo/, documentation/, ...
+```
+
+## Daily commands
+
+| Command | Description |
+|---|---|
+| `odoo start [-d DB] [--new-port] [--prod]` | Start the server (foreground) |
+| `odoo where [--json]` | Show the resolved context + exact odoo-bin command |
+| `odoo update [modules]` | Update modules (default: all installed) |
+| `odoo module install <modules>` | Install modules (creates the db if needed) |
+| `odoo test <module\|installed\|all> [-t tag]` | Run tests in `{db}-test` |
+| `odoo shell [-c CODE]` | Odoo Python REPL / one-shot execution |
+| `odoo db reset` | Drop + recreate, reinstalling the db's module set |
+| `odoo config get/set/list` | Edit the shared odoo.conf |
+| `odoo repo enable <enterprise\|themes\|upgrade>` | Enable an optional repo |
+| `odoo repo add <name> <url>` | Clone a custom addon repository |
+| `odoo worktree create <name> [version] [--linked-from SRC --addon REPO]` | New worktree |
+| `odoo venv` | Rebuild the venv for the current worktree |
+
+Commands infer their target from the current directory (or `-w`/`-d`); the
+database defaults to the worktree name.
+
+## Development
+
+```bash
+# any Python >= 3.11 (a bare `python` may resolve to an older interpreter)
+python3 -m unittest discover           # unit + cli + integration (fast, no network)
+ODOO_CLI_E2E=1 ODOO_CLI_E2E_ODOO_REPO=~/src/odoo \
+    python3 -m unittest discover tests/e2e -v  # real-Odoo flows (slow, opt-in)
+```
+
+Architecture, layering rules, and the testing strategy are documented in
+[`docs/architecture.md`](docs/architecture.md).