polytropos 2.0.0

A build backend for Odoo modules supporting multiple versions

Polytropos

{ width="400" style="display: block; margin: 0 auto;" }

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

[build-system]
requires = ["polytropos"]
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"]

Installation

Python will auto-install the build backend to do the build.

But yes, you can install a small CLI with:

pip install polytropos

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

uvx polytropos --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.