python-terminusgps 41.0.0__tar.gz → 41.1.0__tar.gz

{python_terminusgps-41.0.0 → python_terminusgps-41.1.0}/PKG-INFO

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

{python_terminusgps-41.0.0 → python_terminusgps-41.1.0}/docs/source/conf.py

@@ -18,7 +18,7 @@ django.setup()
 project = "python-terminusgps"
 copyright = "2025, Terminus GPS, LLC"
 author = "Terminus GPS, LLC"
-release = "40.1.4"
+release = "41.1.0"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

{python_terminusgps-41.0.0 → python_terminusgps-41.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-terminusgps"
-version = "41.0.0"
+version = "41.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" } ]

python_terminusgps-41.1.0/terminusgps/wialon/factory.py

@@ -0,0 +1,58 @@
+from terminusgps.wialon.items import (
+    WialonResource,
+    WialonRetranslator,
+    WialonRoute,
+    WialonUnit,
+    WialonUnitGroup,
+    WialonUser,
+)
+from terminusgps.wialon.items.base import WialonObject
+from terminusgps.wialon.session import WialonSession
+
+WIALON_ITEM_MAP = {
+    "avl_hw": None,
+    "avl_resource": WialonResource,
+    "avl_retranslator": WialonRetranslator,
+    "avl_unit": WialonUnit,
+    "avl_unit_group": WialonUnitGroup,
+    "user": WialonUser,
+    "avl_route": WialonRoute,
+}
+
+
+class WialonObjectCreationError(Exception):
+    """Raised when a factory fails to create a Wialon object."""
+
+
+def create_wialon_object(
+    session: WialonSession, items_type: str, *args, **kwargs
+) -> WialonObject:
+    """
+    Creates an ``items_type`` object in Wialon and returns it as a Python object.
+
+    :param session: A valid Wialon API session.
+    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
+    :param items_type: A Wialon items type string.
+    :type items_type: :py:obj:`str`
+    :param args: Positional arguments to pass to the Wialon object's :py:meth:`create` method.
+    :param kwargs: Keyword arguments to pass to the Wialon object's :py:meth:`create` method.
+    :raises WialonAPIError: If something went wrong calling the Wialon API.
+    :raises WialonObjectCreationError: If something went wrong creating the object in Wialon.
+    :returns: A Wialon object.
+    :rtype: :py:obj:`~terminusgps.wialon.items.base.WialonObject`
+
+    """
+    if items_type not in WIALON_ITEM_MAP:
+        raise ValueError(f"Unknown Wialon items type: '{items_type}'.")
+
+    cls = WIALON_ITEM_MAP.get(items_type)
+    if cls is None:
+        raise ValueError(f"Wialon items type '{items_type}' is not implemented.")
+
+    obj = cls(session)
+    obj.create(*args, **kwargs)
+    if not obj.id:
+        raise WialonObjectCreationError(
+            f"Failed to execute create({args = }, {kwargs = }) on '{obj}'."
+        )
+    return obj

{python_terminusgps-41.0.0 → python_terminusgps-41.1.0}/terminusgps/wialon/items/resource.py

@@ -30,7 +30,7 @@ class WialonResource(WialonObject):
             raise ValueError(f"'creator_id' must be a digit, got '{creator_id}'.")
         response = self.session.wialon_api.core_create_resource(
             **{
-                "creator_id": int(creator_id),
+                "creatorId": int(creator_id),
                 "name": name,
                 "dataFlags": flags.DataFlag.RESOURCE_BASE,
                 "skipCreatorCheck": int(skip_creator_check),

{python_terminusgps-41.0.0 → python_terminusgps-41.1.0}/terminusgps/wialon/items/unit_group.py

@@ -25,7 +25,7 @@ class WialonUnitGroup(WialonObject):
             raise ValueError(f"'creator_id' must be a digit, got '{creator_id}'.")
         response = self.session.wialon_api.core_create_unit_group(
             **{
-                "creator_id": int(creator_id),
+                "creatorId": int(creator_id),
                 "name": name,
                 "dataFlags": flags.DataFlag.UNIT_BASE,
             }

{python_terminusgps-41.0.0 → python_terminusgps-41.1.0}/uv.lock

@@ -298,7 +298,7 @@ wheels = [
 
 [[package]]
 name = "python-terminusgps"
-version = "41.0.0"
+version = "41.1.0"
 source = { editable = "." }
 dependencies = [
     { name = "authorizenet" },