polytropos 3.1.0

A build backend for Odoo modules supporting multiple versions

Polytropos

Polytropos is a Python build backend for Odoo modules that enables writing code once and using it across multiple Odoo versions.

Features

• Multi-version support: Write your module once, target multiple Odoo releases
• Conditional manifests: Configure different manifest values per Odoo version, to let you include or exclude XML files per version (views, assets or other data)
• Editable installs: Develop in editable mode with full version support
• PEP 517 compliant: Works with any PEP 517 compatible frontend

Quick Example

Replace your module's __manifest__.py with this pyproject.toml file:

[build-system]
requires = ["polytropos[build]"]
build-backend = "polytropos.build"

[project]
name = "odoo-addon-my-module"
version = "1.0.0"
dependencies = [
    "odoo>=17.0" # Specify supported Odoo versions here
]

[tool.polytropos]
default_odoo_release = "18.0"

# All versions have this data
[[tool.polytropos.manifest]]
depends = ["base"]
data = ["data/views.xml"]

# In Odoo 18+, there are special permissions
[[tool.polytropos.manifest]]
releases = ">=18"
data = ["security/ir.model.access.csv"]

Then, inside the module folder:

# Don't forget the module must be a Python package
touch __init__.py

# Build wheels for different odoo releases
uv build --sdist
uv build --wheel --config-setting odoo_release=17.0
uv build --wheel --config-setting odoo_release=18.0
uv build --wheel --config-setting odoo_release=19.0

# List wheels
ls -1 dist/
my_module-1.0.0.tar.gz
odoo_addon_my_module-17.0.1.0.0-py3-none-any.whl
odoo_addon_my_module-18.0.1.0.0-py3-none-any.whl
odoo_addon_my_module-19.0.1.0.0-py3-none-any.whl

Single branch, single code, multiple releases! 🤯

Installation

Python will auto-install the build backend when you build a module.

But yes, you can install a small CLI with:

pip install polytropos[cli]

For development, the recommended tool you need is uv. Then:

uvx polytropos[cli] --help-all

Why Polytropos?

Odoo modules traditionally require separate codebases for each version. Polytropos solves this by generating version-specific code at build time, allowing you to maintain a single codebase.

If your product is the combination of Odoo + its release, you probably won't need Polytropos.

If your product are Odoo addons, and you want to provide the same product to your customers regardless of the Odoo version they're running, then you will benefit a lot by Polytropos.

Examples

Check out the examples folder for real-world modules with views, models, and tests that exercise the conditional logic.

Credits

Polytropos is developed and maintained by Moduon. Need a professional Odoo partner? Contact us.