python-terminusgps 1.0.1__tar.gz → 1.1.0__tar.gz

{python_terminusgps-1.0.1 → python_terminusgps-1.1.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.3
 Name: python-terminusgps
-Version: 1.0.1
-Summary: Provides abstractions/utilities for working with Wialon and Authorize.NET APIs.
+Version: 1.1.0
+Summary: Provides abstractions/utilities for working with Wialon API, Authorize.NET API, AWS API, and more.
 Author-email: Blake Nall <blake@terminusgps.com>
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Operating System :: OS Independent
@@ -11,4 +11,5 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.12
 Requires-Dist: argparse>=1.4.0
 Requires-Dist: authorizenet>=1.1.5
+Requires-Dist: boto3>=1.35.80
 Requires-Dist: python-wialon>=1.2.4

{python_terminusgps-1.0.1 → python_terminusgps-1.1.0}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "python-terminusgps"
-version = "1.0.1"
-description = "Provides abstractions/utilities for working with Wialon and Authorize.NET APIs."
+version = "1.1.0"
+description = "Provides abstractions/utilities for working with Wialon API, Authorize.NET API, AWS API, and more."
 readme = "README.md"
 authors = [ {name = "Blake Nall", email = "blake@terminusgps.com" } ]
 classifiers = [
@@ -15,6 +15,7 @@ requires-python = ">=3.12"
 dependencies = [
     "argparse>=1.4.0",
     "authorizenet>=1.1.5",
+    "boto3>=1.35.80",
     "python-wialon>=1.2.4",
 ]
 

python_terminusgps-1.1.0/terminusgps/aws/secrets.py

@@ -0,0 +1,9 @@
+import boto3
+import json
+
+
+def get_secret(name: str, region: str = "us-east-1") -> dict[str, str]:
+    """Logs into the default AWS CLI session and returns a secret value."""
+    client = boto3.Session().client(service_name="secretsmanager", region_name=region)
+    secret = client.get_secret_value(SecretId=name)["SecretString"]
+    return json.loads(secret)

python_terminusgps-1.1.0/terminusgps/wialon/items/user.py

@@ -0,0 +1,80 @@
+from urllib.parse import quote_plus
+
+from terminusgps.wialon import flags
+from terminusgps.wialon.items.base import WialonBase
+from terminusgps.wialon import constants
+
+
+class WialonUser(WialonBase):
+    def create(self, **kwargs) -> int | None:
+        if not kwargs.get("owner_id"):
+            raise ValueError("'owner_id' is required on creation.")
+        if not kwargs.get("name"):
+            raise ValueError("'name' is required on creation.")
+        if not kwargs.get("password"):
+            raise ValueError("'password' is required on creation.")
+
+        response = self.session.wialon_api.core_create_user(
+            **{
+                "creatorId": kwargs["owner_id"],
+                "name": kwargs["name"],
+                "password": kwargs["password"],
+                "dataFlags": flags.DATAFLAG_UNIT_BASE,
+            }
+        )
+        return response.get("item", {}).get("id")
+
+    def _get_access_response(self, hw_type: str) -> dict:
+        return self.session.wialon_api.user_get_items_access(
+            **{
+                "userId": self.id,
+                "directAccess": True,
+                "itemSuperclass": hw_type,
+                "flags": 0x2,
+            }
+        )
+
+    @property
+    def units(self) -> list[str]:
+        response = self._get_access_response(hw_type="avl_unit")
+        return [key for key in response.keys()]
+
+    @property
+    def groups(self) -> list[str]:
+        response = self._get_access_response(hw_type="avl_unit_group")
+        return [key for key in response.keys()]
+
+    def has_access(self, other_item: WialonBase) -> bool:
+        response = self._get_access_response(hw_type=other_item.hw_type)
+        items = [key for key in response.keys()]
+        if str(other_item.id) in items:
+            return True
+        return False
+
+    def assign_phone(self, phone: str) -> None:
+        self.add_cproperty(("phone", quote_plus(phone)))
+
+    def assign_email(self, email: str) -> None:
+        self.add_cproperty(("email", email))
+
+    def assign_item(
+        self, item: WialonBase, access_mask: int = constants.ACCESSMASK_UNIT_BASIC
+    ) -> None:
+        """Assigns an item to this user according to the supplied access mask integer."""
+        self.session.wialon_api.user_update_item_access(
+            **{"userId": self.id, "itemId": item.id, "accessMask": access_mask}
+        )
+
+    def set_settings_flags(self, flags: int, flags_mask: int) -> None:
+        self.session.wialon_api.user_update_user_flags(
+            **{"userId": self.id, "flags": flags, "flagsMask": flags_mask}
+        )
+
+    def update_password(self, old_password: str, new_password: str) -> None:
+        self.session.wialon_api.user_update_password(
+            **{
+                "userId": self.id,
+                "oldPassword": old_password,
+                "newPassword": new_password,
+            }
+        )

{python_terminusgps-1.0.1 → python_terminusgps-1.1.0}/terminusgps/wialon/utils.py

@@ -13,10 +13,12 @@ def is_unique(value: str, session: WialonSession, items_type: str = "avl_unit")
     return not bool(result)
 
 
-def gen_wialon_password(length: int = 32) -> str:
+def gen_wialon_password(length: int = 16) -> str:
     """Generates a Wialon compliant password."""
     if length > 64:
         raise ValueError(f"Passwords cannot be greater than 64 chars. Got '{length}'.")
+    if length < 4:
+        raise ValueError(f"Password cannot be less than 4 chars. Got '{length}'.")
 
     symbols: str = "!@#$%^*()[]-_+"
     alphabet: str = string.ascii_letters + string.digits + symbols

{python_terminusgps-1.0.1 → python_terminusgps-1.1.0}/uv.lock

@@ -21,6 +21,34 @@ dependencies = [
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/2d/9a/61c151f508a9b32014b622c9c65b614c7c32068201eee1d93c93010558bc/authorizenet-1.1.5.tar.gz", hash = "sha256:ba8b538028201c01d7ed097ea0842f7732c220472006d105b4a6b948ddcaf4dc", size = 158959 }
 
+[[package]]
+name = "boto3"
+version = "1.35.80"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "botocore" },
+    { name = "jmespath" },
+    { name = "s3transfer" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/81/cd/58de9a4e792176bca4f2e4b4248a9db4a47ae217bc20ac6adb3052b029d3/boto3-1.35.80.tar.gz", hash = "sha256:50dae461ab5fbedfb81b690895d48a918fed0d5fdff37be1c4232770c0dc9712", size = 111009 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0a/72/f6724a19acaac7a7cdfc088ac95d2d0ea3626c00d5a5197a99e49bde474d/boto3-1.35.80-py3-none-any.whl", hash = "sha256:21a3b18c3a7fd20e463708fe3fa035983105dc7f3a1c274e1903e1583ab91159", size = 139179 },
+]
+
+[[package]]
+name = "botocore"
+version = "1.35.80"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "jmespath" },
+    { name = "python-dateutil" },
+    { name = "urllib3" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/81/e3/b10f8c2c58fd144d99de10e5f964bd1b0e609d27cb05513bebfdfa47e3eb/botocore-1.35.80.tar.gz", hash = "sha256:b8dfceca58891cb2711bd6455ec4f7159051f3796e0f64adef9bb334f19d8a92", size = 13456944 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f6/cc/7ecef0f0e883f4bd8e23a04e86d98f8c7d6aa6a821efcec67b3547388d2e/botocore-1.35.80-py3-none-any.whl", hash = "sha256:36e589dccb62380abd628b08fecfa2f7c89b99f41ec9fc42c467c94008c0be4a", size = 13263229 },
+]
+
 [[package]]
 name = "certifi"
 version = "2024.8.30"
@@ -87,6 +115,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/76/c6/c88e154df9c4e1a2a66ccf0005a88dfb2650c1dffb6f5ce603dfbd452ce3/idna-3.10-py3-none-any.whl", hash = "sha256:946d195a0d259cbba61165e88e65941f16e9b36ea6ddb97f00452bae8b1287d3", size = 70442 },
 ]
 
+[[package]]
+name = "jmespath"
+version = "1.0.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/00/2a/e867e8531cf3e36b41201936b7fa7ba7b5702dbef42922193f05c8976cd6/jmespath-1.0.1.tar.gz", hash = "sha256:90261b206d6defd58fdd5e85f478bf633a2901798906be2ad389150c5c60edbe", size = 25843 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/31/b4/b9b800c45527aadd64d5b442f9b932b00648617eb5d63d2c7a6587b7cafc/jmespath-1.0.1-py3-none-any.whl", hash = "sha256:02e2e4cc71b5bcab88332eebf907519190dd9e6e82107fa7f83b1003a6252980", size = 20256 },
+]
+
 [[package]]
 name = "lxml"
 version = "4.9.4"
@@ -102,31 +139,37 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/5f/df/6d15cc415e04724ba4c141051cf43709e09bbcdd9868a6c2e7a7073ef498/lxml-4.9.4-cp312-cp312-win_amd64.whl", hash = "sha256:f1faee2a831fe249e1bae9cbc68d3cd8a30f7e37851deee4d7962b17c410dd56", size = 3773977 },
 ]
 
+[[package]]
+name = "python-dateutil"
+version = "2.9.0.post0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "six" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/66/c0/0c8b6ad9f17a802ee498c46e004a0eb49bc148f2fd230864601a86dcf6db/python-dateutil-2.9.0.post0.tar.gz", hash = "sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3", size = 342432 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl", hash = "sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427", size = 229892 },
+]
+
 [[package]]
 name = "python-terminusgps"
-version = "1.0.0"
+version = "1.1.0"
 source = { editable = "." }
 dependencies = [
     { name = "argparse" },
     { name = "authorizenet" },
+    { name = "boto3" },
     { name = "python-wialon" },
 ]
 
-[package.dev-dependencies]
-dev = [
-    { name = "setuptools" },
-]
-
 [package.metadata]
 requires-dist = [
     { name = "argparse", specifier = ">=1.4.0" },
     { name = "authorizenet", specifier = ">=1.1.5" },
+    { name = "boto3", specifier = ">=1.35.80" },
     { name = "python-wialon", specifier = ">=1.2.4" },
 ]
 
-[package.metadata.requires-dev]
-dev = [{ name = "setuptools", specifier = ">=75.6.0" }]
-
 [[package]]
 name = "python-wialon"
 version = "1.2.4"
@@ -165,12 +208,15 @@ wheels = [
 ]
 
 [[package]]
-name = "setuptools"
-version = "75.6.0"
+name = "s3transfer"
+version = "0.10.4"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/43/54/292f26c208734e9a7f067aea4a7e282c080750c4546559b58e2e45413ca0/setuptools-75.6.0.tar.gz", hash = "sha256:8199222558df7c86216af4f84c30e9b34a61d8ba19366cc914424cdbd28252f6", size = 1337429 }
+dependencies = [
+    { name = "botocore" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c0/0a/1cdbabf9edd0ea7747efdf6c9ab4e7061b085aa7f9bfc36bb1601563b069/s3transfer-0.10.4.tar.gz", hash = "sha256:29edc09801743c21eb5ecbc617a152df41d3c287f67b615f73e5f750583666a7", size = 145287 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/55/21/47d163f615df1d30c094f6c8bbb353619274edccf0327b185cc2493c2c33/setuptools-75.6.0-py3-none-any.whl", hash = "sha256:ce74b49e8f7110f9bf04883b730f4765b774ef3ef28f722cce7c273d253aaf7d", size = 1224032 },
+    { url = "https://files.pythonhosted.org/packages/66/05/7957af15543b8c9799209506df4660cba7afc4cf94bfb60513827e96bed6/s3transfer-0.10.4-py3-none-any.whl", hash = "sha256:244a76a24355363a68164241438de1b72f8781664920260c48465896b712a41e", size = 83175 },
 ]
 
 [[package]]
@@ -208,6 +254,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/0d/e7/f9fafbd4f39793a20cc52e77bbd766f7384312526d402c382928dc7667f6/simplejson-3.19.3-py3-none-any.whl", hash = "sha256:49cc4c7b940d43bd12bf87ec63f28cbc4964fc4e12c031cc8cd01650f43eb94e", size = 57004 },
 ]
 
+[[package]]
+name = "six"
+version = "1.17.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/94/e7/b2c673351809dca68a0e064b6af791aa332cf192da575fd474ed7d6f16a2/six-1.17.0.tar.gz", hash = "sha256:ff70335d468e7eb6ec65b95b99d3a2836546063f63acc5171de367e834932a81", size = 34031 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274", size = 11050 },
+]
+
 [[package]]
 name = "urllib3"
 version = "2.2.3"

python_terminusgps-1.0.1/terminusgps/wialon/items/user.py

@@ -1,22 +0,0 @@
-from terminusgps.wialon import flags
-from terminusgps.wialon.items.base import WialonBase
-
-
-class WialonUser(WialonBase):
-    def create(self, **kwargs) -> int | None:
-        if not kwargs.get("owner_id"):
-            raise ValueError("'owner_id' is required on creation.")
-        if not kwargs.get("name"):
-            raise ValueError("'name' is required on creation.")
-        if not kwargs.get("password"):
-            raise ValueError("'password' is required on creation.")
-
-        response = self.session.wialon_api.core_create_user(
-            **{
-                "creatorId": kwargs["owner_id"],
-                "name": kwargs["name"],
-                "password": kwargs["password"],
-                "dataFlags": flags.DATAFLAG_UNIT_BASE,
-            }
-        )
-        return response.get("item", {}).get("id")