python-terminusgps 1.10.3__py3-none-any.whl → 1.12.0__py3-none-any.whl

{python_terminusgps-1.10.3.dist-info → python_terminusgps-1.12.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 1.10.3
+Version: 1.12.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.3.dist-info → python_terminusgps-1.12.0.dist-info}/RECORD

@@ -21,13 +21,13 @@ terminusgps/wialon/utils.py,sha256=9xJq5eAWm-vu0nJVJ7eUcwhJhMCrGjS1p__4CIBXYm4,3
 terminusgps/wialon/items/__init__.py,sha256=3BVthghekMvhMQSzQgBMlD_phxmKSmp3Zvmo-z0O8Bs,211
 terminusgps/wialon/items/base.py,sha256=sWM8Kg3eJ008M51q42OREHmeifOrFbV1JS9ELqE7coA,6878
 terminusgps/wialon/items/notification.py,sha256=wC-KXxW4LhjSLJVzBGPfu5hz1vcIGKnYFMxQQ1JzX0g,1058
-terminusgps/wialon/items/resource.py,sha256=xElMYSMyKA5y8rIP0EeF429MBV2hbLZcS6SokftvrOs,5641
+terminusgps/wialon/items/resource.py,sha256=7quzb_xvjyEZDTtLMweYOf37NsT9klYcCj4e6apGa5Q,8282
 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.3.dist-info/METADATA,sha256=CY4t0bmdtp64bLgfSNzbQS2_lcc1HX7thHdSbRLK63U,912
-python_terminusgps-1.10.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_terminusgps-1.10.3.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-python_terminusgps-1.10.3.dist-info/RECORD,,
+python_terminusgps-1.12.0.dist-info/METADATA,sha256=PCs6sRzEkIVWNdLK2lLtsUzVnSnR5r5DbnI-ih540Ms,912
+python_terminusgps-1.12.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_terminusgps-1.12.0.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+python_terminusgps-1.12.0.dist-info/RECORD,,

terminusgps/wialon/items/resource.py

@@ -22,17 +22,59 @@ class WialonResource(WialonBase):
 
     @property
     def is_account(self) -> bool:
+        """
+        Whether or not the resource is an account.
+
+        :type: :py:obj:`bool`
+
+        """
         response = self.session.wialon_api.core_search_item(
             **{"id": self.id, "flags": flags.DATAFLAG_RESOURCE_BILLING_PROPERTIES}
         )
         return response.get("item", {}).get("bact") == self.id
 
+    def is_migrated(self, unit: WialonBase) -> bool:
+        """
+        Checks if a unit is migrated into the account.
+
+        :param unit: A Wialon object.
+        :type unit: :py:obj:`~terminusgps.wialon.items.base.WialonBase`
+        :returns: Whether or not the unit is migrated into the account.
+        :rtype: :py:obj:`bool`
+
+        """
+        assert self.is_account, "The resource is not an acccount"
+        response = self.session.wialon_api.account_list_change_accounts(
+            **{"units": [unit.id]}
+        )
+        results = [self.id == int(item.get("id")) for item in response]
+        return any(results)
+
+    def set_dealer_rights(self, enabled: bool = False) -> None:
+        """
+        Sets dealer rights on the account.
+
+        :param enabled: :py:obj:`True` to enable dealer rights, :py:obj:`False` to disable dealer rights. Default is :py:obj:`False`.
+        :type enabled: :py:obj:`bool`
+        :raises AssertionError: If the resource is not an account.
+        :raises WialonError: If something goes wrong with Wialon.
+        :returns: Nothing.
+        :rtype: :py:obj:`None`
+
+        """
+        assert self.is_account, "The resource is not an account"
+        self.session.wialon_api.account_update_dealer_rights(
+            **{"itemId": self.id, "enable": str(enabled).lower()}
+        )
+
     def migrate_unit(self, unit: WialonBase) -> None:
         """
         Migrates a :py:obj:`WialonUnit` into the account.
 
         :param unit: A Wialon object.
         :type unit: :py:obj:`~terminusgps.wialon.items.base.WialonBase`
+        :raises AssertionError: If the resource is not an account.
+        :raises WialonError: If something goes wrong with Wialon.
         :returns: Nothing.
         :rtype: :py:obj:`None`
 
@@ -48,6 +90,8 @@ class WialonResource(WialonBase):
 
         :param new_plan: The name of a billing plan.
         :type new_plan: :py:obj:`str`
+        :raises AssertionError: If the resource is not an account.
+        :raises WialonError: If something goes wrong with Wialon.
         :returns: Nothing.
         :rtype: :py:obj:`None`
 
@@ -63,11 +107,13 @@ class WialonResource(WialonBase):
 
         :param billing_plan: The name of a billing plan.
         :type billing_plan: :py:obj:`str`
+        :raises AssertionError: If the resource is already account.
+        :raises WialonError: If something goes wrong with Wialon.
         :returns: Nothing.
         :rtype: :py:obj:`None`
 
         """
-        assert self.is_account, "The resource is already an account"
+        assert not self.is_account, "The resource is already an account"
         self.session.wialon_api.account_create_account(
             **{"itemId": self.id, "plan": billing_plan}
         )
@@ -76,6 +122,8 @@ class WialonResource(WialonBase):
         """
         Deletes the account if it exists, as well as any micro-objects and macro-objects it contains.
 
+        :raises AssertionError: If the resource is not an account.
+        :raises WialonError: If something goes wrong with Wialon.
         :returns: Nothing.
         :rtype: :py:obj:`None`
 
@@ -87,6 +135,8 @@ class WialonResource(WialonBase):
         """
         Enables the Wialon account.
 
+        :raises AssertionError: If the resource is not an account.
+        :raises WialonError: If something goes wrong with Wialon.
         :returns: Nothing.
         :rtype: :py:obj:`None`
 
@@ -100,6 +150,8 @@ class WialonResource(WialonBase):
         """
         Disables the Wialon account.
 
+        :raises AssertionError: If the resource is not an account.
+        :raises WialonError: If something goes wrong with Wialon.
         :returns: Nothing.
         :rtype: :py:obj:`None`
 
@@ -115,6 +167,8 @@ class WialonResource(WialonBase):
 
         :param days: Number of days to set the counter to. Default is ``0``.
         :type days: :py:obj:`int`
+        :raises AssertionError: If the resource is not an account.
+        :raises WialonError: If something goes wrong with Wialon.
         :returns: Nothing.
         :rtype: :py:obj:`None`
 
@@ -130,6 +184,8 @@ class WialonResource(WialonBase):
 
         :param days: Number of days to add to the account. Default is ``30``.
         :type days: :py:obj:`int`
+        :raises AssertionError: If the resource is not an account.
+        :raises WialonError: If something goes wrong with Wialon.
         :returns: Nothing.
         :rtype: :py:obj:`None`
 
@@ -159,6 +215,8 @@ class WialonResource(WialonBase):
         :type block_balance_val: :py:obj:`float`
         :param deny_balance_val: Minimum amount on the account's balance before denying the account.
         :type deny_balance_val: :py:obj:`float`
+        :raises AssertionError: If the resource is not an account.
+        :raises WialonError: If something goes wrong with Wialon.
         :returns: Nothing.
         :rtype: :py:obj:`None`
 

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.