🧰 Upgrade Utils

This repository contains helper functions¹ to facilitate the writing of upgrade scripts.

The functions in this repo are meant to work (sometimes just not fail) from Odoo 7.0 up to latest version. Thus the only supported version of this repo is master head.

Installation

Alternative

On platforms where you don't manage Odoo yourself, you can install this package via pip:

$ python3 -m pip install git+https://github.com/odoo/upgrade-util@master

You can freeze the hash version when installing in this fashion. Just replace master by the hash of the commit you want to target.

On Odoo.sh it is recommended to add it to the requirements.txt of your repository:

odoo_upgrade @ git+https://github.com/odoo/upgrade-util@master

How to use the helper functions?

Once installed, the following packages are available

odoo.upgrade.util: the helper functions.
odoo.upgrade.testing: base TestCase classes

Documentation

Basic guide on how to write upgrade scripts
The reference documentation

Footnotes

We call them "utils". ↩

Provide feedback

Saved searches

Use saved searches to filter your results more quickly