Metadata-Version: 2.1
Name: odoo-addon-edi_project_oca
Version: 17.0.1.0.0.6
Requires-Python: >=3.10
Requires-Dist: odoo-addon-component_event>=17.0dev,<17.1dev
Requires-Dist: odoo-addon-edi_oca>=17.0dev,<17.1dev
Requires-Dist: odoo>=17.0a,<17.1dev
Summary: Define EDI Configuration for Projects and Tasks
Home-page: https://github.com/OCA/edi-framework
License: LGPL-3
Author: Camptocamp,Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 17.0
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Development Status :: 4 - Beta

===========
Edi Project
===========

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

.. |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/licence-LGPL--3-blue.png
    :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
    :alt: License: LGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fedi--framework-lightgray.png?logo=github
    :target: https://github.com/OCA/edi-framework/tree/17.0/edi_project_oca
    :alt: OCA/edi-framework
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/edi-framework-17-0/edi-framework-17-0-edi_project_oca
    :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/edi-framework&target_branch=17.0
    :alt: Try me on Runboat

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

This module intends to create a base to be extended by local EDI rules
for project management.

In order to add customizations for projects, create a listener:

.. code:: python

   from odoo.addons.component.core import Component


   class ProjectEventListenerExample(Component):
       _name = "project.project.event.listener.example"
       _inherit = "base.event.listener"
       _apply_on = ["project.project"]

       def on_record_create(self, record, fields=None):
           """Do stuff after the project has been created"""

       def on_record_write(self, record, fields=None):
           """Do stuff after the project has been updated"""

       def on_record_unlink(self, record):
           """Do stuff before the project gets deleted"""

In order to add customizations for tasks, create a listener:

.. code:: python

   from odoo.addons.component.core import Component


   class ProjectTaskEventListenerExample(Component):
       _name = "project.task.event.listener.example"
       _inherit = "base.event.listener"
       _apply_on = ["project.task"]

       def on_record_create(self, record, fields=None):
         """Do stuff after the task has been created"""

       def on_record_write(self, record, fields=None):
         """Do stuff after the task has been updated"""

       def on_record_unlink(self, record):
         """Do stuff before the task gets deleted"""

Use ``@skip_if()`` decorator to avoid triggering a listener's method if
necessary:

.. code:: python

   from odoo.addons.component.core import Component
   from odoo.addons.component_event import skip_if


   class ProjectTaskEventListenerExample(Component):
       _name = "project.task.event.listener.example"
       _inherit = "base.event.listener"
       _apply_on = ["project.task"]

       @skip_if(lambda self, task: not task.stage_id)  # Do nothing if the task has no stage
       def on_record_update(self, record, fields=None):
           """Do stuff after the task has been created"""

**Table of contents**

.. contents::
   :local:

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/edi-framework/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/edi-framework/issues/new?body=module:%20edi_project_oca%0Aversion:%2017.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
------------

- Silvio Gregorini <silvio.gregorini@camptocamp.com>

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/edi-framework <https://github.com/OCA/edi-framework/tree/17.0/edi_project_oca>`_ project on GitHub.

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