Add support for managing attachments

Add a new manager for attachment records (`ir.attachment`) in Odoo.

These are intended to be used for uploading/downloading attachments to/from invoices.
Invoice attachments will then be attached to invoice emails sent out to customers.

The contents of the attachments won't be fetched when querying them from Odoo by default;
instead it is intended that the separate `download` method be used to download the attachment
contents separately. An `upload` method is also available, to provide an easier to use interface
for uploading attachments.

Author: Callum Dickinson

_typos.toml

@@ -0,0 +1,2 @@
+[default.extend-words]
+datas = "datas"

changelog.d/7.added.md

@@ -0,0 +1 @@
+Add support for managing attachments

openstack_odooclient/base/client.py

@@ -167,6 +167,12 @@ def __init__(
                 opener=opener,
             )
             self._odoo.login(database, username, password)
+        self._env_manager_mapping: dict[str, RecordManagerBase] = {}
+        """An internal mapping between env (model) names and their managers.
+
+        This is populated by the manager classes themselves when created,
+        and used by the ``Attachment.res_model_manager`` field.
+        """
         self._record_manager_mapping: dict[
             Type[RecordBase],
             RecordManagerBase,

openstack_odooclient/base/record_manager.py

@@ -109,6 +109,7 @@ def __init__(self, client: ClientBase) -> None:
         """The Odoo client object the manager uses."""
         # Assign this record manager object as the manager
         # responsible for the configured record class in the client.
+        self._client._env_manager_mapping[self.env_name] = self
         self._client._record_manager_mapping[self.record_class] = self
         self._record_type_hints = MappingProxyType(
             get_type_hints(
@@ -964,3 +965,6 @@ def _encode_value(self, type_hint: Any, value: Any) -> Any:
                 v_type = get_type_args(type_hint)[0]
                 return [self._encode_value(v_type, v) for v in value]
         return value
+
+
+RecordManager = RecordManagerBase[RecordBase["RecordManager"]]

openstack_odooclient/client.py

@@ -18,6 +18,7 @@
 from .base.client import ClientBase
 from .managers.account_move import AccountMoveManager
 from .managers.account_move_line import AccountMoveLineManager
+from .managers.attachment import AttachmentManager
 from .managers.company import CompanyManager
 from .managers.credit import CreditManager
 from .managers.credit_transaction import CreditTransactionManager
@@ -90,6 +91,9 @@ class Client(ClientBase):
     account_move_lines: AccountMoveLineManager
     """Account move (invoice) line manager."""
 
+    attachments: AttachmentManager
+    """Attachment manager."""
+
     companies: CompanyManager
     """Company manager."""
 

openstack_odooclient/managers/account_move.py

@@ -73,6 +73,28 @@ class AccountMove(RecordBase["AccountMoveManager"]):
     is_move_sent: bool
     """Whether or not the account move (invoice) has been sent."""
 
+    message_main_attachment_id: Annotated[
+        int,
+        ModelRef("message_main_attachment_id", Attachment),
+    ]
+    """The ID of the main attachment on the invoice, if there is one."""
+
+    message_main_attachment_name: Annotated[
+        str,
+        ModelRef("message_main_attachment_name", Attachment),
+    ]
+    """The name of the main attachment on the invoice, if there is one."""
+
+    message_main_attachment: Annotated[
+        Attachment,
+        ModelRef("message_main_attachment", Attachment),
+    ]
+    """The main attachment on the invoice, if there is one.
+
+    This fetches the full record from Odoo once,
+    and caches it for subsequent accesses.
+    """
+
     move_type: Literal[
         "entry",
         "out_invoice",
@@ -237,5 +259,6 @@ def send_openstack_invoice_email(
 
 # NOTE(callumdickinson): Import here to make sure circular imports work.
 from .account_move_line import AccountMoveLine  # noqa: E402
+from .attachment import Attachment  # noqa: E402
 from .currency import Currency  # noqa: E402
 from .project import Project  # noqa: E402