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
# 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
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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
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
File details
Details for the file polytropos-6.7.0.tar.gz.
File metadata
- Download URL: polytropos-6.7.0.tar.gz
- Upload date:
- Size: 590.5 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3e1f4d2ca4a8777d2f33ee05614f8ed518a75fd6e3639890630f95cf29a582ba
|
|
| MD5 |
058cae625b2ffe15cca86fd1cab882cd
|
|
| BLAKE2b-256 |
35a58c1a91be433eb0477e1b7af99856ac7ad138d76eb1b0fe05ff0d971b1031
|
File details
Details for the file polytropos-6.7.0-py3-none-any.whl.
File metadata
- Download URL: polytropos-6.7.0-py3-none-any.whl
- Upload date:
- Size: 27.9 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
586b475e7f4f25e65251a528d3a49174535ec0ec64b71c9ae6c79efd121bafc6
|
|
| MD5 |
de35970854002670e6759daeb2a22589
|
|
| BLAKE2b-256 |
d73471370d8b5ce02964cace47f07108666da80bf0fe2d3b5e1b744a4edc3f18
|
