Polytropos
Polytropos is a Python build backend for Odoo modules that enables writing code once and using it across multiple Odoo releases.
Features
- Multi-release support: Write your module once, target multiple Odoo releases
- Conditional manifests: Configure different manifest values per Odoo release, to let you include or exclude data files per release
- Editable installs: Develop in editable is supported
- 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 = [
# Specify supported Odoo versions here
"odoo>=17"
]
# All versions have this data
[[tool.polytropos.manifest]]
depends = ["base"]
data = ["data/views.xml"]
# This section is only for Odoo 18+
[[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
uv build --wheel --config-setting odoo_release=20.0
# List artifacts
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
odoo_addon_my_module-20.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 or branches for each release. Polytropos solves this by generating release-specific code at build time, allowing you to maintain a single codebase.
So, it will help you or not depending on your product vision:
| What is your product? | What does that mean? | Is Polytropos for you? |
|---|---|---|
| Odoo + its release + all addons in that release | Customers that want new features must upgrade to newer Odoo releases. | ⛔ No |
| Addons that should work always the same way | Customers need new features and cannot wait for the upgrade to the next Odoo release; but when they upgrade, they expect the same features they have now | ✅ Yes |
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.
1 maintainer
Metadata
1 maintainer
Release files for polytropos 6.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| polytropos-6.8.0.tar.gz | 724.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| polytropos-6.8.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 751.9 kB
Release files / polytropos-6.8.0.tar.gz
| Download URL | polytropos-6.8.0.tar.gz |
|---|---|
| Size | 724.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
56c0bef94a0aa261ffc74bf9dae06d6725705bb8dd8645b14e76319157d7635f
|
|
BLAKE2b-256 checksum How to use checksums |
ad23e30105eba4eeb5edc91c172ce1fd91e5140630cd516ba43248024e0c5cb0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / polytropos-6.8.0-py3-none-any.whl
| Download URL | polytropos-6.8.0-py3-none-any.whl |
|---|---|
| Size | 27.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a087d119e62be4e0507f788ecb4bfd011113518594f7455fe4ef2f431b03acbd
|
|
BLAKE2b-256 checksum How to use checksums |
2bf86383facf2f41c1969707df0100c72e7a2d04b829f6185447c75bba13f6de
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
