Package: odoo-addon-openupgrade-framework
This module is a technical module that contains a number of monkeypatches
to improve the behaviour of Odoo when migrating your database using the
OpenUpgrade migration scripts:Prevent dropping columns or tables in the database when fields or models
are obsoleted in the Odoo data model of the target release. After the
migration, you can review and delete unused database tables and columns
usingdatabase_cleanup. Seehttps://odoo-community.org/shop/product/database-cleanup-918When data records are deleted during the migration (such as views or other
system records), this is done in a secure mode. If the deletion fails because
of some unforeseen dependency, the deletion will be cancelled and a message
is logged, after which the migration continues.Prevent a number of log messages that do not apply when using OpenUpgrade.Suppress log messages about failed view validation, which are to be expected
during a migration.Run migration scripts for modules that are installed as new dependencies
of upgraded modules (when there are such scripts for those particular
modules)Production databases generated with demo data, will be transformed to
non-demo ones. If you want to avoid that, you have to pass through the
environment variable OPENUPGRADE_USE_DEMO, the value “yes”.For detailed documentation see:https://github.com/OCA/OpenUpgrade/https://oca.github.io/OpenUpgradeTable of contentsInstallationConfigurationDevelopmentBug TrackerCreditsAuthorsContributorsOther creditsMaintainersInstallationThis module does not need to be installed on a database.
It simply needs to be available via youraddons-path.Configurationcall your odoo instance with the option--load=base,web,openupgrade_frameworkoradd the key to your configuration file:[options]server_wide_modules=web,openupgrade_frameworkWhen you load the module in either way of these ways, and you have theopenupgrade_scriptsmodule in your addons path available, the–upgrade-pathoption of Odoo will be set automatically to the location
of the OpenUpgrade migration scripts.DevelopmentTheodoo_patchfolder contains python files in a tree that mimicks the
folder tree of the Odoo project. It contains a number of monkey patches
to improve the migration of an Odoo database between two major versions.So far, we are able to make everything work without overwriting large blocks
of code, but if larger patches need to be added, please use the method
described below:To see the patches added, you can usemeldtools:meld PATH_TO_ODOO_FOLDER/odoo/ PATH_TO_OPENUPGRADE_FRAMEWORK_MODULE/odoo_patchTo make more easy the diff analysis :Make sure the python files has the same path as the original one.Keep the same indentation as the original file. (usingif True:if required)Add the following two lines at the beginning of your file, to avoid flake8 / pylint
errors# flake8: noqa# pylint: skip-fileWhen you want to change the code. add the following tags:For an addition:# <OpenUpgrade:ADD>somecode...# </OpenUpgrade>For a change:# <OpenUpgrade:CHANGE>somecode...# </OpenUpgrade>For a removal:# <OpenUpgrade:REMOVE># Comment the code, instead of removing it.# </OpenUpgrade>Bug TrackerBugs are tracked onGitHub Issues.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomedfeedback.Do not contact contributors directly about support or help with technical issues.CreditsAuthorsTherp BVOpener B.V.GRAPHunki Enterprises BVContributorsStefan Rijnhart <stefan@opener.amsterdam>Sylvain LE GAL <https://twitter.com/legalsylvain>Other creditsMany developers have contributed to the OpenUpgrade framework in its previous
incarnation. Their original contributions may no longer needed, or they are
no longer recognizable in their current form but OpenUpgrade would not have
existed at this point without them.MaintainersThis module is maintained by the OCA.OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.Currentmaintainers:This module is part of theOCA/OpenUpgradeproject on GitHub.You are welcome to contribute. To learn how please visithttps://odoo-community.org/page/Contribute.