python-terminusgps 1.10.2__py3-none-any.whl → 1.11.0__py3-none-any.whl

{python_terminusgps-1.10.2.dist-info → python_terminusgps-1.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 1.10.2
+Version: 1.11.0
 Summary: Provides abstractions/utilities for working with Wialon API, Authorize.NET API, AWS API, and more.
 Project-URL: Documentation, https://app.terminusgps.com/docs/apps/python-terminusgps/index.html
 Project-URL: Repository, https://github.com/terminusgps/python-terminusgps

{python_terminusgps-1.10.2.dist-info → python_terminusgps-1.11.0.dist-info}/RECORD

@@ -9,8 +9,9 @@ terminusgps/authorizenet/profiles/customers.py,sha256=iEuNFP6PHuGdFQftgxxKpQFYaG
 terminusgps/authorizenet/profiles/payments.py,sha256=qOWp-gO6qBCADP98WjoNCHm-jtq7DY5-moiPsOnT5yI,5263
 terminusgps/aws/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 terminusgps/aws/secrets.py,sha256=kgRA77rs0mD4berWRLkPtJLOe4Grf--o5f8NzwQqXCk,360
+terminusgps/aws/ses.py,sha256=sDca2GjMaZvUt3kUPtGCpcqHiOkij9lMV1ogZofgYUU,2372
 terminusgps/twilio/__init__.py,sha256=dYo41F2jft_eHDWSUtSpKGSRG1bewq_qClqilUJZkYM,33
-terminusgps/twilio/caller.py,sha256=XLMONHnojYZ0QVS0UlJlBZkL2qw3LO2b53jWJ4uv6oM,1832
+terminusgps/twilio/caller.py,sha256=nHCIwUulo-C_v2orsp6OY0nuJA6YetSkxpMTwrRQ-uA,1831
 terminusgps/wialon/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 terminusgps/wialon/constants.py,sha256=g06sNgWtSvY1pZljbH9KMsArhs8jFZRgJM9GT4Gluf0,3079
 terminusgps/wialon/errors.py,sha256=SV9pVwU6FZ_zGlGP6zJN6aLE2auF4TfHFISQLiPMKrI,1758
@@ -18,14 +19,15 @@ terminusgps/wialon/flags.py,sha256=-OoH-eZM54yjRqxsAXL8VImdQu_7C0OAxCrFqaCEuko,1
 terminusgps/wialon/session.py,sha256=YClz5dMQ4vshznngOYkW-kVPh4YAGDx4QHyOGpPwd-k,9474
 terminusgps/wialon/utils.py,sha256=9xJq5eAWm-vu0nJVJ7eUcwhJhMCrGjS1p__4CIBXYm4,3407
 terminusgps/wialon/items/__init__.py,sha256=3BVthghekMvhMQSzQgBMlD_phxmKSmp3Zvmo-z0O8Bs,211
-terminusgps/wialon/items/base.py,sha256=r0cDn7c1vKVARPmODbGPkeP2F-sktCqVofIb1Q_gsCQ,6694
-terminusgps/wialon/items/resource.py,sha256=xElMYSMyKA5y8rIP0EeF429MBV2hbLZcS6SokftvrOs,5641
+terminusgps/wialon/items/base.py,sha256=sWM8Kg3eJ008M51q42OREHmeifOrFbV1JS9ELqE7coA,6878
+terminusgps/wialon/items/notification.py,sha256=wC-KXxW4LhjSLJVzBGPfu5hz1vcIGKnYFMxQQ1JzX0g,1058
+terminusgps/wialon/items/resource.py,sha256=KH5U9eizT6hpxC3r0JGhon-wbV_MiyU3eE57rCaznw8,5913
 terminusgps/wialon/items/retranslator.py,sha256=zsQXqOhH1zFe5_e8DROPu60z3v6xPWOEPyMCi2IqJAo,3861
 terminusgps/wialon/items/route.py,sha256=qOHPN_rejwiGqvwWzlwmUIAIyc3lKavCalf8ki66rx0,760
-terminusgps/wialon/items/unit.py,sha256=AUPoECgjzxnBxTAjPCbSVL_OzqCP7Oa4vjprFT3gJJ8,7275
+terminusgps/wialon/items/unit.py,sha256=3fp9HXxW8e7PvMXwRBurNUrDstEmGyLBVRu3Q9kNcAM,7275
 terminusgps/wialon/items/unit_group.py,sha256=1yc7ldPIgGbtiTj0djRDWmt6Q9K_VT9sxOaioasbbLY,5212
 terminusgps/wialon/items/user.py,sha256=p_NA4iXLappr44RKwt9EHv_v0jc1XOQU_mJWe61s_qI,6077
-python_terminusgps-1.10.2.dist-info/METADATA,sha256=mOx5v7vNDP2-65IJpMHgC2epvklGGClRyb2FGrjPEjE,912
-python_terminusgps-1.10.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_terminusgps-1.10.2.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-python_terminusgps-1.10.2.dist-info/RECORD,,
+python_terminusgps-1.11.0.dist-info/METADATA,sha256=oLYm0XWa_83TL-87BxqWU1yvdRrc3JqzrshOxq7SQ98,912
+python_terminusgps-1.11.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_terminusgps-1.11.0.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+python_terminusgps-1.11.0.dist-info/RECORD,,

terminusgps/aws/ses.py

@@ -0,0 +1,72 @@
+import boto3
+import json
+
+
+class SESEmailTemplate:
+    def __init__(self, template_name: str, region_name: str = "us-east-1") -> None:
+        self.name = template_name
+        self.region = region_name
+        self.client = boto3.Session().client(service_name="ses")
+
+    def send(
+        self,
+        from_addr: str,
+        recipients: list[str],
+        replyto_list: list[str],
+        data: dict[str, str],
+        cc_list: list[str] | None = None,
+        bcc_list: list[str] | None = None,
+    ) -> None:
+        destination = self._get_destination(recipients, cc_list, bcc_list)
+        self.client.send_templated_email(
+            **{
+                "Source": from_addr,
+                "Destination": destination,
+                "ReplyToAddresses": replyto_list,
+                "Template": self.name,
+                "TemplateData": json.dumps(data),
+            }
+        )
+
+    def create(self, subject: str, text_content: str, html_content: str) -> None:
+        self.client.create_template(
+            **{
+                "Template": {
+                    "TemplateName": self.name,
+                    "SubjectPart": subject,
+                    "TextPart": text_content,
+                    "HtmlPart": html_content,
+                }
+            }
+        )
+
+    def update(self, subject: str, text_content: str, html_content: str) -> None:
+        self.client.update_template(
+            **{
+                "Template": {
+                    "TemplateName": self.name,
+                    "SubjectPart": subject,
+                    "TextPart": text_content,
+                    "HtmlPart": html_content,
+                }
+            }
+        )
+
+    def test_render(self, data: dict[str, str]) -> str:
+        response = self.client.test_render_template(
+            **{"TemplateName": self.name, "TemplateData": json.dumps(data)}
+        )
+        return response.get("RenderedTemplate")
+
+    def _get_destination(
+        self,
+        recipients: list[str],
+        cc_list: list[str] | None,
+        bcc_list: list[str] | None,
+    ) -> dict[str, list[str]]:
+        destination: dict[str, list[str]] = {"ToAddresses": recipients}
+        if cc_list is not None:
+            destination.update({"CcAddresses": cc_list})
+        if bcc_list is not None:
+            destination.update({"BccAddresses": bcc_list})
+        return destination

terminusgps/twilio/caller.py

@@ -37,7 +37,6 @@ class TwilioCaller:
                 )
             case _:
                 raise ValueError(f"Unsupported TwilioCaller method '{method}'.")
-
         return task
 
     async def create_call(self, to_number: str, message: str) -> None:

terminusgps/wialon/items/base.py

@@ -5,7 +5,14 @@ from terminusgps.wialon.session import WialonSession
 
 
 class WialonBase:
-    def __init__(self, id: str | int, session: WialonSession, **kwargs) -> None:
+    def __init__(
+        self,
+        id: str | int | None = None,
+        session: WialonSession | None = None,
+        **kwargs,
+    ) -> None:
+        if session is None:
+            raise ValueError("A valid Wialon API session is required.")
         if isinstance(id, str) and not id.isdigit():
             raise ValueError(f"'id' must be a digit. Got '{id}'.")
 
@@ -59,7 +66,7 @@ class WialonBase:
         return True if self.id in response.keys() else False
 
     @abstractmethod
-    def create(self) -> int | None:
+    def create(self, *args, **kwargs) -> int | None:
         """Creates a Wialon object and returns its id."""
         raise NotImplementedError("Subclasses must implement this method.")
 

terminusgps/wialon/items/notification.py

@@ -0,0 +1,33 @@
+from terminusgps.wialon.items.base import WialonBase
+
+
+class WialonNotification(WialonBase):
+    def create(
+        self,
+        resource_id: str | int,
+        name: str,
+        activation_time: int,
+        deactivation_time: int,
+        text: str | None = None,
+        max_alarms: int = 0,
+        interval: int = 0,
+        lang: str = "en",
+    ) -> int | None:
+        if isinstance(resource_id, str) and not resource_id.isdigit():
+            raise ValueError(f"'resource_id' must be a digit, got '{resource_id}'.")
+
+        response = self.session.wialon_api.resource_update_notification(
+            **{
+                "itemId": resource_id,
+                "id": 0,
+                "callMode": "create",
+                "n": name,
+                "txt": text if text else name,
+                "ta": activation_time,
+                "td": deactivation_time,
+                "ma": max_alarms,
+                "mmtd": interval,
+                "la": lang,
+            }
+        )
+        return int(response[0].get("id")) if response else None

terminusgps/wialon/items/resource.py

@@ -27,6 +27,13 @@ class WialonResource(WialonBase):
         )
         return response.get("item", {}).get("bact") == self.id
 
+    def is_migrated(self, unit: WialonBase) -> bool:
+        response = self.session.wialon_api.account_list_change_accounts(
+            **{"units": [unit.id]}
+        )
+        results = [unit.id == int(item.get("id")) for item in response]
+        return any(results)
+
     def migrate_unit(self, unit: WialonBase) -> None:
         """
         Migrates a :py:obj:`WialonUnit` into the account.

terminusgps/wialon/items/unit.py

@@ -133,15 +133,6 @@ class WialonUnit(WialonBase):
             **{"itemId": self.id, "phoneNumber": quote_plus(phone)}
         )
 
-    def clean_phone_numbers(self, phones: list[str]) -> list[str]:
-        cleaned_phones = []
-        for num in phones:
-            if "," in num:
-                cleaned_phones.extend(num.split(","))
-            else:
-                cleaned_phones.append(num)
-        return cleaned_phones
-
     def get_phone_numbers(self) -> list[str]:
         """
         Retrieves all phone numbers assigned to the unit.
@@ -167,6 +158,15 @@ class WialonUnit(WialonBase):
             phone_numbers.extend(phones_2)
         return list(dict.fromkeys(phone_numbers))  # Removes duplicate phone numbers
 
+    def clean_phone_numbers(self, phones: list[str]) -> list[str]:
+        cleaned_phones = []
+        for num in phones:
+            if "," in num:
+                cleaned_phones.extend(num.split(","))
+            else:
+                cleaned_phones.append(num)
+        return cleaned_phones
+
     def _get_afield_phone_numbers(self, key: str = "to_number") -> list[str] | None:
         """
         Retrives any phone numbers saved in an admin field by key.