A hatch(ling) plugin to work with projects containing Odoo addons. This tool will help you package a project containing Odoo addons so it can be installed with pip:
- automatically generates dependencies based on Odoo addons manifests,
- package addons into the odoo/addons namespace independently of the source project layout,
- install the addons in editable mode without fiddling with
--addons-path
,
π‘ This project is best used when working with end-customer projects. To package individual reusable addons, consider the whool project.
Table of Contents
Assuming you have a project containing your awesome Odoo addons at the root of your
project repository, you can set it up by creating a pyproject.toml
file like so.
# Use the hatchling build backend, with the hatch-odoo plugin.
[build-system]
requires = ["hatchling", "hatch-odoo"]
build-backend = "hatchling.build"
[project]
name = "MyAwesomeProject"
version = "1.0"
readme = "README.md"
requires-python = ">=3.8"
# Dependencies are dynamic because they will be generated from Odoo addons manifests.
dynamic = ["dependencies"]
# Enable the hatch-odoo metadata hook to generate dependencies from addons manifests.
[tool.hatch.metadata.hooks.odoo-addons-dependencies]
# Enable the hatch-odoo build hook to package the Odoo addons into odoo/addons.
[tool.hatch.build.hooks.odoo-addons-dirs]
[tool.hatch-odoo]
# If our addons have non standard version numbers, let's help hatch-odoo discover the Odoo version.
odoo_version_override = "15.0"
# Let's add additional dependencies that are not declared in addons manifests.
dependencies = ["click-odoo-contrib"]
# Our addons are in the project root directory.
addons_dirs = ["."]
You can then install it in editable mode, together with its dependencies in a virtual environment with a procedure like this:
# python3 -m venv .venv
# source .venv/bin/activate
# pip install --upgrade pip setuptools wheel
# pip install -r https://raw.githubusercontent.com/odoo/odoo/15.0/requirements.txt
# pip install -e git+https://github.com/odoo/[email protected]
# pip install -e .
# odoo
All dependencies (such as OCA addons and external dependencies) declared in your project addons manifests will be downloaded and installed from PyPI automatically.
There is no need to configure the Odoo addons path: since addons are installed in
odoo/addons
, the regular Python import machinery works out of the box
You can then pin dependencies for reproducibility with pip freeze
or other tools.
pip-deepfreeze is known to work well with
git URLs, but other tools such as pip-tools
, may work as well.
Depending on your taste and requirements, there are several alternative ways to
organize your source code. The test projects in
tests/data each have a
README that describe the layout and corresponding tradeoffs, with the corresponding
pyproject.toml
.
hatch-odoo
is distributed under the terms of the MIT license.