odoo-addon-attachment-queue-email 18.0.1.0.0.2__py3-none-any.whl

odoo/addons/attachment_queue_email/README.rst

@@ -0,0 +1,123 @@
+.. image:: https://odoo-community.org/readme-banner-image
+   :target: https://odoo-community.org/get-involved?utm_source=readme
+   :alt: Odoo Community Association
+
+======================
+Attachment Queue Email
+======================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:27f9d13a667b05afb86742b7074e5ac32070df09ff3cc42906202f5a1d2a950d
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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%2Fserver--tools-lightgray.png?logo=github
+    :target: https://github.com/OCA/server-tools/tree/18.0/attachment_queue_email
+    :alt: OCA/server-tools
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/server-tools-18-0/server-tools-18-0-attachment_queue_email
+    :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/server-tools&target_branch=18.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+Abstract module for importing emails attachments.
+
+Each email's attachment matching a given **"Attachment Condition"** will
+be imported creating a new ``attachment.queue`` object. These
+``attachment.queue`` objects are files wrapped with additional fields
+(mainly a **Filed Type** and a **State**) making them ready to be
+processed by a custom module as you can read in the
+`attachment_queue <https://github.com/OCA/server-tools/tree/18.0/attachment_queue>`__
+documentation.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Usage
+=====
+
+Adding an **"Attachment Condition"** to your *Incoming Mail Server*
+configuration will lead to the creation of ``attachment.queue`` objects
+from emails attachments coming from this server and matching the given
+*Attachment Condition*.
+
+   🔎 Recalling that, as the *Incoming Mail Servers* has only one
+   *"Create a New Record"* field, the emails coming from that server
+   **cannot be used to create other type of objects** than
+   ``attachment.queue``.
+
+Filling the condition's **File Type** field will spread this value to
+the newly created ``attchment.queue`` objects so they can be processed
+by a custom module following this **File Type** field value.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/server-tools/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/server-tools/issues/new?body=module:%20attachment_queue_email%0Aversion:%2018.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
+-------
+
+* Akretion
+
+Contributors
+------------
+
+- Valentin CHEMIERE <valentin.chemiere@akretion.com>
+- Florian DA COSTA <florian.dacosta@akretion.com>
+- Sebastien BEAU <sebastian.beau@akretion.com>
+- Clément Mombereau <clement.mombereau@akretion.com>
+- Benoit GUILLOT <benoit.guillot@akretion.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.
+
+.. |maintainer-florian-dacosta| image:: https://github.com/florian-dacosta.png?size=40px
+    :target: https://github.com/florian-dacosta
+    :alt: florian-dacosta
+.. |maintainer-sebastienbeau| image:: https://github.com/sebastienbeau.png?size=40px
+    :target: https://github.com/sebastienbeau
+    :alt: sebastienbeau
+.. |maintainer-bealdav| image:: https://github.com/bealdav.png?size=40px
+    :target: https://github.com/bealdav
+    :alt: bealdav
+
+Current `maintainers <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-florian-dacosta| |maintainer-sebastienbeau| |maintainer-bealdav| 
+
+This module is part of the `OCA/server-tools <https://github.com/OCA/server-tools/tree/18.0/attachment_queue_email>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

odoo/addons/attachment_queue_email/__init__.py

@@ -0,0 +1 @@
+from . import models

odoo/addons/attachment_queue_email/__manifest__.py

@@ -0,0 +1,22 @@
+# Copyright 2012 Akretion (https://www.akretion.com).
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl)
+
+{
+    "name": "Attachment Queue Email",
+    "version": "18.0.1.0.0",
+    "author": "Akretion,Odoo Community Association (OCA)",
+    "category": "Generic Modules",
+    "summary": "Create attachment from emails to be processed depending on their type",
+    "license": "AGPL-3",
+    "website": "https://github.com/OCA/server-tools",
+    "maintainers": ["florian-dacosta", "sebastienbeau", "bealdav"],
+    "depends": ["attachment_queue", "mail"],
+    "demo": [],
+    "data": [
+        "security/ir.model.access.csv",
+        "views/fetchmail_attachment_condition.xml",
+        "views/fetchmail_server.xml",
+    ],
+    "installable": True,
+    "images": [],
+}

odoo/addons/attachment_queue_email/i18n/attachment_queue_email.pot

@@ -0,0 +1,200 @@
+# Translation of Odoo Server.
+# This file contains the translation of the following modules:
+# 	* attachment_queue_email
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Server 18.0\n"
+"Report-Msgid-Bugs-To: \n"
+"Last-Translator: \n"
+"Language-Team: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: \n"
+"Plural-Forms: \n"
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_attachment_queue__assigned_attachment_ids
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__assigned_attachment_ids
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_server__assigned_attachment_ids
+msgid "Assigned Attachments"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_server__attachment_condition_ids
+msgid "Attachment Condition"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model_terms:ir.ui.view,arch_db:attachment_queue_email.view_fetchmail_attachment_condition_form
+msgid "Attachment Condition requirements"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model_terms:ir.ui.view,arch_db:attachment_queue_email.view_email_server_form
+msgid "Attachment Conditions"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model,name:attachment_queue_email.model_attachment_queue
+msgid "Attachment Queue"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model_terms:ir.ui.view,arch_db:attachment_queue_email.view_fetchmail_attachment_condition_form
+msgid "Attachment process"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__company_id
+msgid "Company"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__name
+msgid "Condition Name"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__create_uid
+msgid "Created by"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__create_date
+msgid "Created on"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__display_name
+msgid "Display Name"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__email_from
+msgid "Email From"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_attachment_queue__fetchmail_server_id
+msgid "Email Server"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__email_subject
+msgid "Email Subject"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__email_to
+msgid "Email To"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_attachment_queue__fetchmail_attachment_condition_id
+msgid "FetchMail condition"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model,name:attachment_queue_email.model_fetchmail_attachment_condition
+msgid "Fetchmail Attachment Conditions"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__file_extension
+msgid "File Extension"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__file_type
+msgid "File Type"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,help:attachment_queue_email.field_fetchmail_server__attachment_condition_ids
+msgid ""
+"Files attached to the emails matching these conditions will be imported in "
+"Odoo as 'Attachment Queue' objects"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__id
+msgid "ID"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,help:attachment_queue_email.field_fetchmail_attachment_condition__email_to
+msgid ""
+"If empty, catches the email no matter the recipient.\n"
+"Otherwise catches the emails where the recipients emails contains the given characters."
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,help:attachment_queue_email.field_fetchmail_attachment_condition__email_from
+msgid ""
+"If empty, catches the emails from every senders.\n"
+"Otherwise catches the emails where the sender's email contains the given characters"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,help:attachment_queue_email.field_fetchmail_attachment_condition__email_subject
+msgid ""
+"If empty, catches the emails with every kind of Subjects.\n"
+"Otherwise catches the emails where the Subject contains the given characters"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model,name:attachment_queue_email.model_fetchmail_server
+msgid "Incoming Mail Server"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__write_uid
+msgid "Last Updated by"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__write_date
+msgid "Last Updated on"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model_terms:ir.ui.view,arch_db:attachment_queue_email.view_fetchmail_attachment_condition_form
+msgid "Requirements"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__server_id
+msgid "Server Mail"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,field_description:attachment_queue_email.field_attachment_queue__smart_search
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_attachment_condition__smart_search
+#: model:ir.model.fields,field_description:attachment_queue_email.field_fetchmail_server__smart_search
+msgid "Smart Search"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,help:attachment_queue_email.field_fetchmail_attachment_condition__file_type
+msgid ""
+"The 'file type' is transmited to the 'Attachment Queue' objects created from the selected emails attachments.\n"
+"It will allow Odoo to recognize what do do with them once created."
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,help:attachment_queue_email.field_attachment_queue__fetchmail_attachment_condition_id
+msgid "The Fetchmail attachment condition used to create this attachment"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,help:attachment_queue_email.field_attachment_queue__fetchmail_server_id
+msgid "The email server used to create this attachment"
+msgstr ""
+
+#. module: attachment_queue_email
+#: model:ir.model.fields,help:attachment_queue_email.field_fetchmail_attachment_condition__file_extension
+msgid ""
+"The extension (or part of the name) of the sought files. If empty, all the "
+"email's attachments will be imported."
+msgstr ""

odoo/addons/attachment_queue_email/models/__init__.py

@@ -0,0 +1,3 @@
+from . import attachment_queue
+from . import fetchmail_server
+from . import fetchmail_attachment_condition

odoo/addons/attachment_queue_email/models/attachment_queue.py

@@ -0,0 +1,105 @@
+# Copyright 2012 Akretion (https://www.akretion.com).
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl)
+
+import base64
+
+from odoo import api, fields, models
+
+
+class AttachmentQueue(models.Model):
+    _inherit = "attachment.queue"
+
+    fetchmail_attachment_condition_id = fields.Many2one(
+        "fetchmail.attachment.condition",
+        string="FetchMail condition",
+        help="The Fetchmail attachment condition used to create this attachment",
+    )
+    fetchmail_server_id = fields.Many2one(
+        "fetchmail.server",
+        string="Email Server",
+        related="fetchmail_attachment_condition_id.server_id",
+        store=True,
+        readonly=True,
+        help="The email server used to create this attachment",
+    )
+
+    @api.model
+    def _get_attachment_queue_data(self, condition, msg, att):
+        data = att[1]
+        # seems files are byte when it comes from zip file so we manage
+        # both case
+        if isinstance(data, str):
+            data = data.encode()
+        values = {
+            "fetchmail_attachment_condition_id": condition.id,
+            "file_type": condition.file_type,
+            "name": att[0],
+            "datas": base64.b64encode(data),
+            "state": "pending",
+            "company_id": condition.company_id.id,
+        }
+        return values
+
+    @api.model
+    def prepare_data_from_basic_condition(self, cond, msg_dict):
+        vals_list = []
+        # match_from and match_subj are True if empty or if matching with
+        # msg_dict's values
+        match_from = (
+            cond.email_from
+            and cond.email_from in msg_dict.get("from", "")
+            or not cond.email_from
+        )
+        match_subj = (
+            cond.email_subject
+            and cond.email_subject in msg_dict.get("subject", "")
+            or not cond.email_subject
+        )
+        match_to = (
+            cond.email_to
+            and cond.email_to in msg_dict.get("to", "")
+            or not cond.email_to
+        )
+
+        if match_from and match_subj and match_to:
+            for att in msg_dict["attachments"]:
+                if cond.file_extension in att[0] or not cond.file_extension:
+                    vals_list.append(
+                        self._get_attachment_queue_data(cond, msg_dict, att)
+                    )
+        return vals_list
+
+    @api.model
+    def _prepare_data_for_attachment_queue(self, msg_dict):
+        """Prepare the datas for the creation of one or many attachment.queue depending
+        on the number of the email's attachments files and if the email matches the
+        fetchmail.attachment.condition's conditions.
+
+        :param msg_dict: a dictionnary with the email data
+        :type: dict
+
+        :return: a list of dictionnary that contains the attachment.queue data
+        :rtype: list
+        """
+        res = []
+        server_id = self.env.context.get("default_fetchmail_server_id", False)
+        file_condition_obj = self.env["fetchmail.attachment.condition"]
+        conds = file_condition_obj.search([("server_id", "=", server_id)])
+        for cond in conds:
+            vals_list = self.prepare_data_from_basic_condition(cond, msg_dict)
+            if vals_list:
+                res += vals_list
+        return res
+
+    @api.model
+    def message_new(self, msg_dict, custom_values=None):
+        """Create Attachments Queues objects from the received email's attachments."""
+        # Rewriting completely ``message_new`` instead of overiding it in order to
+        # allows the creation of many new objects instead of only one.
+        created_recs = []
+        res = self._prepare_data_for_attachment_queue(msg_dict)
+        if res:
+            for vals in res:
+                created_recs.append(self.create(vals))
+            return created_recs[0]
+        return None

odoo/addons/attachment_queue_email/models/fetchmail_attachment_condition.py

@@ -0,0 +1,45 @@
+# Copyright 2012 Akretion (https://www.akretion.com).
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl)
+
+from odoo import fields, models
+
+
+class FetchmailAttachmentCondition(models.Model):
+    _name = "fetchmail.attachment.condition"
+    _description = "Fetchmail Attachment Conditions"
+
+    name = fields.Char(
+        string="Condition Name",
+        required=True,
+    )
+    email_from = fields.Char(
+        help="If empty, catches the emails from every senders.\n"
+        "Otherwise catches the emails where the sender's email contains the given "
+        "characters",
+    )
+    email_to = fields.Char(
+        help="If empty, catches the email no matter the recipient.\n"
+        "Otherwise catches the emails where the recipients emails contains the given "
+        "characters.",
+    )
+    email_subject = fields.Char(
+        help="If empty, catches the emails with every kind of Subjects.\n"
+        "Otherwise catches the emails where the Subject contains the given characters",
+    )
+    file_extension = fields.Char(
+        help="The extension (or part of the name) of the sought files. "
+        "If empty, all the email's attachments will be imported.",
+    )
+    server_id = fields.Many2one("fetchmail.server", string="Server Mail")
+    file_type = fields.Selection(
+        selection=[],
+        help="The 'file type' is transmited to the 'Attachment Queue' objects created "
+        "from the selected emails attachments.\nIt will allow Odoo to recognize "
+        "what do do with them once created.",
+    )
+    company_id = fields.Many2one(
+        "res.company",
+        string="Company",
+        required=True,
+        default=lambda self: self.env.company,
+    )

odoo/addons/attachment_queue_email/models/fetchmail_server.py

@@ -0,0 +1,25 @@
+# Copyright 2012 Akretion (https://www.akretion.com).
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl)
+
+from odoo import api, fields, models
+
+
+class FetchmailServer(models.Model):
+    _inherit = "fetchmail.server"
+
+    attachment_condition_ids = fields.One2many(
+        "fetchmail.attachment.condition",
+        "server_id",
+        string="Attachment Condition",
+        help="Files attached to the emails matching these conditions will be imported "
+        "in Odoo as 'Attachment Queue' objects",
+    )
+
+    @api.onchange("attachment_condition_ids")
+    def onchange_attachment_condition(self):
+        for server in self:
+            if server.attachment_condition_ids:
+                server.object_id = self.env["ir.model"].search(
+                    [("model", "=", "attachment.queue")]
+                )
+                server.attach = True

odoo/addons/attachment_queue_email/readme/CONTRIBUTORS.md

@@ -0,0 +1,5 @@
+- Valentin CHEMIERE \<valentin.chemiere@akretion.com\>
+- Florian DA COSTA \<florian.dacosta@akretion.com\>
+- Sebastien BEAU \<sebastian.beau@akretion.com\>
+- Clément Mombereau \<clement.mombereau@akretion.com\>
+- Benoit GUILLOT \<benoit.guillot@akretion.com\>

odoo/addons/attachment_queue_email/readme/DESCRIPTION.md

@@ -0,0 +1,9 @@
+Abstract module for importing emails attachments.
+
+Each email's attachment matching a given **"Attachment Condition"** will
+be imported creating a new `attachment.queue` object. These
+`attachment.queue` objects are files wrapped with additional fields
+(mainly a **Filed Type** and a **State**) making them ready to be
+processed by a custom module as you can read in the
+[attachment_queue](https://github.com/OCA/server-tools/tree/18.0/attachment_queue)
+documentation.

odoo/addons/attachment_queue_email/readme/USAGE.md

@@ -0,0 +1,13 @@
+Adding an **"Attachment Condition"** to your *Incoming Mail Server*
+configuration will lead to the creation of `attachment.queue` objects
+from emails attachments coming from this server and matching the given
+*Attachment Condition*.
+
+> 🔎 Recalling that, as the *Incoming Mail Servers* has only one
+> *"Create a New Record"* field, the emails coming from that server
+> **cannot be used to create other type of objects** than
+> `attachment.queue`.
+
+Filling the condition's **File Type** field will spread this value to
+the newly created `attchment.queue` objects so they can be processed by
+a custom module following this **File Type** field value.

odoo/addons/attachment_queue_email/security/ir.model.access.csv

@@ -0,0 +1,3 @@
+id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
+access_fetchmail_attachment_condition_manager,fetchmail.attachment.condition.manager,model_fetchmail_attachment_condition,base.group_system,1,1,1,1
+access_fetchmail_attachment_condition_user,fetchmail.attachment.condition.user,model_fetchmail_attachment_condition,base.group_user,1,0,0,0