stormware 2.0.0__tar.gz → 2.2.0__tar.gz

{stormware-2.0.0/stormware.egg-info → stormware-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: stormware
-Version: 2.0.0
+Version: 2.2.0
 Summary: API connectors for data analysis and task automation
 Author-email: Logikal GmbH <contact@logikal.io>
 License: Copyright 2023 Logikal GmbH
@@ -41,15 +41,15 @@ Requires-Dist: pandas[performance]~=2.2
 Requires-Dist: pandas-stubs~=2.2
 Requires-Dist: xdg-base-dirs~=6.0
 Provides-Extra: google
-Requires-Dist: google-api-python-client==2.161.0; extra == "google"
+Requires-Dist: google-api-python-client==2.162.0; extra == "google"
 Requires-Dist: google-auth==2.38.0; extra == "google"
-Requires-Dist: google-cloud-bigquery[pandas]~=3.29; extra == "google"
+Requires-Dist: google-cloud-bigquery[pandas]==3.29.0; extra == "google"
 Requires-Dist: google-cloud-bigquery-storage~=2.28; extra == "google"
 Requires-Dist: google-cloud-secret-manager==2.23.1; extra == "google"
 Requires-Dist: google-crc32c==1.6.0; extra == "google"
 Provides-Extra: amazon
-Requires-Dist: boto3==1.36.26; extra == "amazon"
-Requires-Dist: boto3-stubs==1.36.26; extra == "amazon"
+Requires-Dist: boto3==1.37.4; extra == "amazon"
+Requires-Dist: boto3-stubs==1.37.4; extra == "amazon"
 Provides-Extra: facebook
 Requires-Dist: facebook-business==22.0.2; extra == "facebook"
 

{stormware-2.0.0 → stormware-2.2.0}/requirements/dev.txt

@@ -2,4 +2,4 @@
 -r build.txt
 -r docs.txt
 
-pytest-logikal==4.0.2
+pytest-logikal==4.0.5

{stormware-2.0.0 → stormware-2.2.0}/requirements/dev.txt.lock

@@ -3,12 +3,12 @@
 ##  DO NOT EDIT THIS FILE.
 ##  This is a locked requirements file generated by pyorbs.
 ##
-##  Requirements hash: c5fd3a7bdc7898b444842cb6e565f34dacc9d467286f77d4eb387f23902733e7
+##  Requirements hash: cc9601c96bdeb06c8a9dc0c1317bbc8d9d14698261e2a0362edcf8e2fa7a1cf6
 ##
 ###################################################################################################
 -e .
 aiohappyeyeballs==2.4.6
-aiohttp==3.11.12
+aiohttp==3.11.13
 aiosignal==1.3.2
 alabaster==1.0.0
 astroid==3.3.8
@@ -18,10 +18,10 @@ babel==2.17.0
 bandit==1.8.3
 beautifulsoup4==4.13.3
 bleach==6.2.0
-boto3==1.36.26
-boto3-stubs==1.36.26
-botocore==1.36.26
-botocore-stubs==1.36.26
+boto3==1.37.4
+boto3-stubs==1.37.4
+botocore==1.37.4
+botocore-stubs==1.37.1
 Bottleneck==1.4.2
 build==1.2.2
 cachetools==5.5.2
@@ -32,11 +32,11 @@ codespell==2.4.1
 colorama==0.4.6
 comm==0.2.2
 coverage==7.6.12
-cryptography==44.0.1
+cryptography==44.0.2
 curlify==2.2.1
 db-dtypes==1.4.1
 debugpy==1.8.12
-decorator==5.2.0
+decorator==5.2.1
 defusedxml==0.7.1
 dill==0.3.9
 docutils==0.21.2
@@ -47,7 +47,7 @@ fastjsonschema==2.21.1
 filelock==3.17.0
 frozenlist==1.5.0
 google-api-core==2.24.1
-google-api-python-client==2.161.0
+google-api-python-client==2.162.0
 google-auth==2.38.0
 google-auth-httplib2==0.2.0
 google-cloud-bigquery==3.29.0
@@ -58,22 +58,23 @@ google-crc32c==1.6.0
 google-resumable-media==2.7.2
 googleapis-common-protos==1.68.0
 grpc-google-iam-v1==0.14.0
-grpcio==1.70.0
-grpcio-status==1.70.0
+grpcio==1.71.0rc2
+grpcio-status==1.71.0rc2
 httplib2==0.22.0
 id==1.5.0
 idna==3.10
 imagesize==1.4.1
 iniconfig==2.0.0
 ipykernel==6.29.5
-ipython==8.32.0
+ipython==9.0.0
+ipython_pygments_lexers==1.1.1
 ipywidgets==8.1.5
-isort==6.0.0
+isort==6.0.1
 jaraco.classes==3.4.0
 jaraco.context==6.0.1
 jaraco.functools==4.1.0
 jedi==0.19.2
-jeepney==0.8.0
+jeepney==0.9.0
 Jinja2==3.1.5
 jmespath==1.0.1
 jsonschema==4.23.0
@@ -85,7 +86,7 @@ jupyterlab_pygments==0.3.0
 jupyterlab_widgets==3.0.13
 keyring==25.6.0
 llvmlite==0.44.0
-logikal-docs==1.2.1
+logikal-docs==1.2.2
 logikal-utils==1.4.0
 markdown-it-py==3.0.0
 MarkupSafe==3.0.2
@@ -101,7 +102,7 @@ nbclient==0.10.2
 nbconvert==7.16.6
 nbformat==5.10.4
 nest-asyncio==1.6.0
-nh3==0.2.20
+nh3==0.2.21
 numba==0.61.0
 numexpr==2.10.2
 numpy==2.1.3
@@ -117,7 +118,7 @@ pip==25.0.1
 pip-licenses==5.0.0
 platformdirs==4.3.6
 pluggy==1.5.0
-prettytable==3.14.0
+prettytable==3.15.1
 prompt_toolkit==3.0.50
 propcache==0.3.0
 proto-plus==1.26.0
@@ -139,7 +140,7 @@ pyparsing==3.2.1
 pyproject_hooks==1.2.0
 pytest==8.3.4
 pytest-cov==6.0.0
-pytest-logikal==4.0.2
+pytest-logikal==4.0.5
 pytest-mock==3.14.0
 pytest-mypy==0.10.3
 pytest-xdist==3.6.1
@@ -153,16 +154,17 @@ requests==2.32.3
 requests-toolbelt==1.0.0
 rfc3986==2.0.0
 rich==13.9.4
+roman-numerals-py==3.1.0
 rpds-py==0.23.1
 rsa==4.9
-s3transfer==0.11.2
+s3transfer==0.11.3
 SecretStorage==3.3.3
-setuptools==75.8.0
+setuptools==75.8.2
 six==1.17.0
 snowballstemmer==2.2.0
 soupsieve==2.6
-Sphinx==8.1.3
-sphinx-rtd-theme==3.0.1
+Sphinx==8.2.1
+sphinx-rtd-theme==3.0.2
 sphinxcontrib-applehelp==2.0.0
 sphinxcontrib-devhelp==2.0.0
 sphinxcontrib-htmlhelp==2.1.0
@@ -181,7 +183,7 @@ traitlets==5.14.3
 twine==6.1.0
 types-awscrt==0.23.10
 types-pytz==2025.1.0.20250204
-types-s3transfer==0.11.2
+types-s3transfer==0.11.3
 typing_extensions==4.12.2
 tzdata==2025.1
 uritemplate==4.1.1

{stormware-2.0.0 → stormware-2.2.0}/requirements/docs.txt

@@ -4,4 +4,4 @@
 -r extras/amazon.txt
 -r extras/facebook.txt
 
-logikal-docs[jupyter]==1.2.1
+logikal-docs[jupyter]==1.2.2

{stormware-2.0.0 → stormware-2.2.0}/requirements/docs.txt.lock

@@ -3,12 +3,12 @@
 ##  DO NOT EDIT THIS FILE.
 ##  This is a locked requirements file generated by pyorbs.
 ##
-##  Requirements hash: cfca97e1bd71f2a750747edd0f5a215a3b3ab76afe92bb7eccfd2c1ac72e2612
+##  Requirements hash: c217d81e73279da34df380e3d7b016bc2c11457d6af4fea4497deea27fb05a27
 ##
 ###################################################################################################
 -e .
 aiohappyeyeballs==2.4.6
-aiohttp==3.11.12
+aiohttp==3.11.13
 aiosignal==1.3.2
 alabaster==1.0.0
 asttokens==3.0.0
@@ -16,10 +16,10 @@ attrs==25.1.0
 babel==2.17.0
 beautifulsoup4==4.13.3
 bleach==6.2.0
-boto3==1.36.26
-boto3-stubs==1.36.26
-botocore==1.36.26
-botocore-stubs==1.36.26
+boto3==1.37.4
+boto3-stubs==1.37.4
+botocore==1.37.4
+botocore-stubs==1.37.1
 Bottleneck==1.4.2
 cachetools==5.5.2
 certifi==2025.1.31
@@ -28,7 +28,7 @@ comm==0.2.2
 curlify==2.2.1
 db-dtypes==1.4.1
 debugpy==1.8.12
-decorator==5.2.0
+decorator==5.2.1
 defusedxml==0.7.1
 docutils==0.21.2
 executing==2.2.0
@@ -36,7 +36,7 @@ facebook_business==22.0.2
 fastjsonschema==2.21.1
 frozenlist==1.5.0
 google-api-core==2.24.1
-google-api-python-client==2.161.0
+google-api-python-client==2.162.0
 google-auth==2.38.0
 google-auth-httplib2==0.2.0
 google-cloud-bigquery==3.29.0
@@ -47,13 +47,14 @@ google-crc32c==1.6.0
 google-resumable-media==2.7.2
 googleapis-common-protos==1.68.0
 grpc-google-iam-v1==0.14.0
-grpcio==1.70.0
-grpcio-status==1.70.0
+grpcio==1.71.0rc2
+grpcio-status==1.71.0rc2
 httplib2==0.22.0
 idna==3.10
 imagesize==1.4.1
 ipykernel==6.29.5
-ipython==8.32.0
+ipython==9.0.0
+ipython_pygments_lexers==1.1.1
 ipywidgets==8.1.5
 jedi==0.19.2
 Jinja2==3.1.5
@@ -66,7 +67,7 @@ jupyter_core==5.7.2
 jupyterlab_pygments==0.3.0
 jupyterlab_widgets==3.0.13
 llvmlite==0.44.0
-logikal-docs==1.2.1
+logikal-docs==1.2.2
 logikal-utils==1.4.0
 MarkupSafe==3.0.2
 matplotlib-inline==0.1.7
@@ -105,15 +106,16 @@ pytz==2025.1
 pyzmq==26.2.1
 referencing==0.36.2
 requests==2.32.3
+roman-numerals-py==3.1.0
 rpds-py==0.23.1
 rsa==4.9
-s3transfer==0.11.2
-setuptools==75.8.0
+s3transfer==0.11.3
+setuptools==75.8.2
 six==1.17.0
 snowballstemmer==2.2.0
 soupsieve==2.6
-Sphinx==8.1.3
-sphinx-rtd-theme==3.0.1
+Sphinx==8.2.1
+sphinx-rtd-theme==3.0.2
 sphinxcontrib-applehelp==2.0.0
 sphinxcontrib-devhelp==2.0.0
 sphinxcontrib-htmlhelp==2.1.0
@@ -128,7 +130,7 @@ tornado==6.4.2
 traitlets==5.14.3
 types-awscrt==0.23.10
 types-pytz==2025.1.0.20250204
-types-s3transfer==0.11.2
+types-s3transfer==0.11.3
 typing_extensions==4.12.2
 tzdata==2025.1
 uritemplate==4.1.1

stormware-2.2.0/requirements/extras/amazon.txt

@@ -0,0 +1,2 @@
+boto3==1.37.4
+boto3-stubs==1.37.4

{stormware-2.0.0 → stormware-2.2.0}/requirements/extras/google.txt

@@ -1,6 +1,6 @@
-google-api-python-client==2.161.0
+google-api-python-client==2.162.0
 google-auth==2.38.0
-google-cloud-bigquery[pandas]~=3.29
+google-cloud-bigquery[pandas]==3.29.0
 google-cloud-bigquery-storage~=2.28
 google-cloud-secret-manager==2.23.1
 google-crc32c==1.6.0

{stormware-2.0.0 → stormware-2.2.0}/stormware/google/gmail.py

@@ -5,6 +5,7 @@ Gmail API connector.
 # - Google API Python Client Library: https://googleapis.github.io/google-api-python-client/
 # - Gmail API: https://developers.google.com/gmail/api
 import base64
+import email
 from dataclasses import dataclass
 from datetime import datetime, timezone
 from logging import getLogger
@@ -19,7 +20,7 @@ from stormware.google.auth import GCPAuth
 logger = getLogger(__name__)
 
 
-@dataclass
+@dataclass(order=True, kw_only=True)
 class Label:
     """
     Represents a label.
@@ -28,7 +29,7 @@ class Label:
     name: str | None = None
 
 
-@dataclass
+@dataclass(order=True, kw_only=True)
 class Attachment:
     """
     Represents an email message attachment.
@@ -39,13 +40,25 @@ class Attachment:
     mime_type: str | None
 
 
-@dataclass(order=True)
+@dataclass(order=True, kw_only=True)
+class Address:
+    """
+    Represents an email address.
+    """
+    email: str
+    display_name: str | None = None
+
+
+@dataclass(order=True, kw_only=True)
 class Message:  # pylint: disable=too-many-instance-attributes
     """
     Represents an email message.
     """
     id: str
     thread_id: str | None = None
+    sender: Address | None = None
+    to: list[Address] | None = None
+    cc: list[Address] | None = None
     subject: str | None = None
     plain_text: str | None = None
     html_text: str | None = None
@@ -68,7 +81,7 @@ class Message:  # pylint: disable=too-many-instance-attributes
                 self.add_part(subpart)
 
 
-@dataclass
+@dataclass(kw_only=True)
 class Query:  # pylint: disable=too-many-instance-attributes
     """
     Represents a Gmail `search query <https://support.google.com/mail/answer/7190?hl=en>`_.
@@ -131,6 +144,19 @@ class Gmail(ClientManager[Any]):
     def create_client(self) -> Any:
         return build('gmail', 'v1', credentials=self.auth.credentials(), cache_discovery=False)
 
+    def labels(self, *, user_id: str = 'me') -> list[Label]:
+        """
+        Load labels.
+
+        Args:
+            user_id: The user ID to use.
+
+        """
+        response = self.client.users().labels().list(  # pylint: disable=no-member
+            userId=user_id
+        ).execute()
+        return [Label(id=label['id'], name=label['name']) for label in response.get('labels', [])]
+
     def messages(self, query: Query, *, user_id: str = 'me') -> list[Message]:
         """
         Load messages that match a given query.
@@ -149,7 +175,7 @@ class Gmail(ClientManager[Any]):
         while True:  # pylint: disable=while-used
             page += 1
             logger.debug(f'Loading page {page}')
-            response = self.client.users().messages().list(  # pylint: disable=no-member
+            response = self.client.users().messages().list(
                 q=query_str,
                 userId=user_id,
                 labelIds=[label.id for label in query.labels or []],
@@ -164,6 +190,13 @@ class Gmail(ClientManager[Any]):
                     for message in messages
                 ]
 
+    @staticmethod
+    def _parse_address(addresses: str) -> list[Address]:
+        return [
+            Address(email=field[1], display_name=field[0] or None)
+            for field in email.utils.getaddresses([addresses])
+        ]
+
     def message(self, message: Message, *, user_id: str = 'me') -> Message:
         """
         Load a specific message.
@@ -189,14 +222,23 @@ class Gmail(ClientManager[Any]):
         message = Message(
             id=response['id'],
             thread_id=response.get('threadId'),
+            to=[],
+            cc=[],
             timestamp=datetime.fromtimestamp(int(response['internalDate']) / 1000, timezone.utc),
             labels=[Label(id=label_id) for label_id in response.get('labelIds')],
             attachments=[],
         )
 
-        headers = response.get('payload', {}).get('headers', {})
-        if items := [header['value'] for header in headers if header['name'].lower() == 'subject']:
-            message.subject = items[0]
+        # Process headers
+        for header in response.get('payload', {}).get('headers', []):
+            if header['name'].lower() == 'from':
+                message.sender = self._parse_address(header['value'])[0]
+            elif header['name'].lower() == 'to':
+                message.to = self._parse_address(header['value'])
+            elif header['name'].lower() == 'cc':
+                message.cc = self._parse_address(header['value'])
+            elif header['name'].lower() == 'subject':
+                message.subject = header['value']
 
         # Process message parts
         for part in response.get('payload', {}).get('parts', []):

{stormware-2.0.0 → stormware-2.2.0/stormware.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: stormware
-Version: 2.0.0
+Version: 2.2.0
 Summary: API connectors for data analysis and task automation
 Author-email: Logikal GmbH <contact@logikal.io>
 License: Copyright 2023 Logikal GmbH
@@ -41,15 +41,15 @@ Requires-Dist: pandas[performance]~=2.2
 Requires-Dist: pandas-stubs~=2.2
 Requires-Dist: xdg-base-dirs~=6.0
 Provides-Extra: google
-Requires-Dist: google-api-python-client==2.161.0; extra == "google"
+Requires-Dist: google-api-python-client==2.162.0; extra == "google"
 Requires-Dist: google-auth==2.38.0; extra == "google"
-Requires-Dist: google-cloud-bigquery[pandas]~=3.29; extra == "google"
+Requires-Dist: google-cloud-bigquery[pandas]==3.29.0; extra == "google"
 Requires-Dist: google-cloud-bigquery-storage~=2.28; extra == "google"
 Requires-Dist: google-cloud-secret-manager==2.23.1; extra == "google"
 Requires-Dist: google-crc32c==1.6.0; extra == "google"
 Provides-Extra: amazon
-Requires-Dist: boto3==1.36.26; extra == "amazon"
-Requires-Dist: boto3-stubs==1.36.26; extra == "amazon"
+Requires-Dist: boto3==1.37.4; extra == "amazon"
+Requires-Dist: boto3-stubs==1.37.4; extra == "amazon"
 Provides-Extra: facebook
 Requires-Dist: facebook-business==22.0.2; extra == "facebook"
 

{stormware-2.0.0 → stormware-2.2.0}/stormware.egg-info/requires.txt

@@ -4,16 +4,16 @@ pandas-stubs~=2.2
 xdg-base-dirs~=6.0
 
 [amazon]
-boto3==1.36.26
-boto3-stubs==1.36.26
+boto3==1.37.4
+boto3-stubs==1.37.4
 
 [facebook]
 facebook-business==22.0.2
 
 [google]
-google-api-python-client==2.161.0
+google-api-python-client==2.162.0
 google-auth==2.38.0
-google-cloud-bigquery[pandas]~=3.29
+google-cloud-bigquery[pandas]==3.29.0
 google-cloud-bigquery-storage~=2.28
 google-cloud-secret-manager==2.23.1
 google-crc32c==1.6.0

stormware-2.0.0/requirements/extras/amazon.txt

@@ -1,2 +0,0 @@
-boto3==1.36.26
-boto3-stubs==1.36.26