Odoo Development Environment Helper
Project description
odoo-dev
A CLI tool for managing Odoo development environments. Handles local Python setup, Docker containers, database operations, and more.
Installation
# Install with uv (recommended)
uv tool install odoo-dev
# Or with pip
pip install odoo-dev
Quick Start
# In your Odoo project directory
cd my-odoo-project
# Full setup: clone Odoo repos, create venv, configure VSCode
odoo-dev setup
# Or for community edition only
odoo-dev setup --community
Commands
Local Development (default)
odoo-dev run # Start Odoo locally
odoo-dev run -d mydb --dev reload # With hot reload
odoo-dev run --debug # With debugpy (VSCode attach)
odoo-dev shell mydb # Open Odoo shell
odoo-dev update base -d mydb # Update modules
odoo-dev test my_module # Run tests with coverage
odoo-dev scaffold my_module # Create new module
Database Operations
odoo-dev db list # List databases
odoo-dev db restore backup.zip # Restore from backup
odoo-dev db restore backup.zip mydb --no-neutralize
odoo-dev db drop mydb # Drop database
odoo-dev db neutralize mydb # Disable emails/crons
Docker (optional)
odoo-dev docker start # Start containers
odoo-dev docker stop # Stop containers
odoo-dev docker logs # View logs
odoo-dev docker build # Rebuild image
odoo-dev docker shell mydb # Shell in container
odoo-dev docker psql # PostgreSQL shell
Setup Commands
odoo-dev setup # Full setup
odoo-dev setup --community # Community edition only
odoo-dev setup-venv # Just create venv
odoo-dev vscode # Configure VSCode debugging
Project Structure
odoo-dev expects this project structure:
my-odoo-project/
├── .env # Optional: ODOO_VERSION, PYTHON_VERSION
├── addons/ # Your custom addons
├── requirements.txt # Project-specific Python deps
├── odoo/ # Cloned by setup
├── enterprise/ # Cloned by setup (unless --community)
├── design-themes/ # Cloned by setup
├── .venv/ # Created by setup
└── conf/
└── odoo.conf # Created by setup
Configuration
Create a .env file in your project root:
ODOO_VERSION=18.0
PYTHON_VERSION=3.12
Requirements
- Python 3.12+
- uv (recommended) or pip
- Git
- PostgreSQL (for local development)
- Docker (optional, for containerized development)
Development
# Clone and install for development
git clone git@git.bemade.org:bemade/odoo-dev.git
cd odoo-dev
uv sync
# Run tests
uv run pytest # All tests
uv run pytest -m "not slow" # Fast tests only
# Build
uv build
License
LGPL-3. For complete license terms, visit https://www.gnu.org/licenses/lgpl-3.0.en.html
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
odoo_dev-0.2.7.tar.gz
(45.4 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
odoo_dev-0.2.7-py3-none-any.whl
(21.6 kB
view details)
File details
Details for the file odoo_dev-0.2.7.tar.gz.
File metadata
- Download URL: odoo_dev-0.2.7.tar.gz
- Upload date:
- Size: 45.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Pop!_OS","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2cad4cbaa0b6adeac152aaf5cc24746b12e987fb5c752c4fcbf79f20fdbb7572
|
|
| MD5 |
44c0787e74754d3508d64c7ff5fd1788
|
|
| BLAKE2b-256 |
5cd18a0186d89f282432e08eda7d07bf0a7aa2d7bf493f07ab68ff0acaaa5b02
|
File details
Details for the file odoo_dev-0.2.7-py3-none-any.whl.
File metadata
- Download URL: odoo_dev-0.2.7-py3-none-any.whl
- Upload date:
- Size: 21.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Pop!_OS","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7bdd1f06a518d62e62106c1726f1126704b91c648e2d4f403068e8abf5edf810
|
|
| MD5 |
6c1786b8ec4f5ea69e7bb5ab5d7ad5ea
|
|
| BLAKE2b-256 |
f5c122eddbcbed3e92adfe377d1224faedb4b3a63f50b9aca6afeed7c104aaa3
|
