Metadata-Version: 2.1
Name: odoo-addon-odoo_repository_migration
Version: 16.0.1.3.2.2
Summary: Collect modules migration data for Odoo Repositories.
Home-page: https://github.com/OCA/module-composition-analysis
Author: Camptocamp, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
License: AGPL-3
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 16.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Requires-Python: >=3.10
Requires-Dist: oca-port
Requires-Dist: odoo-addon-odoo-repository<16.1dev,>=16.0dev
Requires-Dist: odoo<16.1dev,>=16.0a

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

==============================
Odoo Repository Migration Data
==============================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:897a7456693242289caa6a0ae4c8e32ea2c2d336832aa6ef5a4e50262e2865e6
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fmodule--composition--analysis-lightgray.png?logo=github
    :target: https://github.com/OCA/module-composition-analysis/tree/16.0/odoo_repository_migration
    :alt: OCA/module-composition-analysis
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/module-composition-analysis-16-0/module-composition-analysis-16-0-odoo_repository_migration
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/module-composition-analysis&target_branch=16.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module collects and records modules migration data from Odoo
repositories.

Thanks to `oca-port <https://github.com/OCA/oca-port/>`__ and data
collected by ``odoo_repository``, this module will generate migration
data on each module for declared migration paths (e.g. 16.0 -> 18.0).

Also, for specific cases you can declare what a module became in a given
Odoo version, like OCA ``web_domain_field`` replaced by standard Odoo
module ``web`` starting from 17.0 (with an optional explanation that
could help users, like how to use this new module compared to the
previous one).

Given a migration path, a module can get one of this migration status:

+-----------------------------+----------------------------------------+
| Status                      | Description                            |
+=============================+========================================+
| *Fully Ported*              | All commits from source version are    |
|                             | present in target version              |
+-----------------------------+----------------------------------------+
| *To migrate*                | The module doesn't exist on target     |
|                             | version                                |
+-----------------------------+----------------------------------------+
| *Ported (missing commits?)* | Some commits from source version are   |
|                             | not ported in target version (could be |
|                             | false-positive)                        |
+-----------------------------+----------------------------------------+
| *To review*                 | A migration PR has been detected       |
+-----------------------------+----------------------------------------+
| *Replaced*                  | The module has been replaced by        |
|                             | another one (not sharing the same git  |
|                             | history)                               |
+-----------------------------+----------------------------------------+
| *Moved to standard?*        | The module name has been detected in   |
|                             | Odoo standard repositories for target  |
|                             | version. High chance this module is or |
|                             | should be replaced by another one      |
|                             | instead (by creating a timeline), so   |
|                             | it mainly helps to detect such cases.  |
+-----------------------------+----------------------------------------+
| *Moved to OCA*              | the module name is available in an OCA |
|                             | repository (could be a false-positive  |
|                             | because sharing the same name, in such |
|                             | case a timeline has to be created)     |
+-----------------------------+----------------------------------------+
| *Moved to generic repo*     | a specific module (only available in a |
|                             | project) in source version now exists  |
|                             | in a generic repository (could be a    |
|                             | false-positive if both modules have    |
|                             | only their name in common)             |
+-----------------------------+----------------------------------------+

It helps to build a consolidated knowledge database accross different
Odoo versions for everyone: functionals and developers.

**Table of contents**

.. contents::
   :local:

Usage
=====

To enable this feature, the option *Collect migration data* should be
enabled on repositories (opt-in).

To record what a module became starting from a given Odoo version, you
should do it through the *Odoo Repositories / Data / Modules /
Timelines* menu.

Once the scheduled action ran, the migration data are available on each
module in *Migration* tab, or through the *Odoo Repositories / Data /
Modules / Migrations* menu.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/module-composition-analysis/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 welcomed
`feedback <https://github.com/OCA/module-composition-analysis/issues/new?body=module:%20odoo_repository_migration%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* Camptocamp

Contributors
------------

- Camptocamp

  - Sébastien Alix <seb@usr-src.org>

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

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.

This module is part of the `OCA/module-composition-analysis <https://github.com/OCA/module-composition-analysis/tree/16.0/odoo_repository_migration>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
