python-terminusgps 41.0.1__tar.gz → 41.2.0__tar.gz

{python_terminusgps-41.0.1 → python_terminusgps-41.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 41.0.1
+Version: 41.2.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.1 → python_terminusgps-41.2.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.2.0"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

{python_terminusgps-41.0.1 → python_terminusgps-41.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-terminusgps"
-version = "41.0.1"
+version = "41.2.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.2.0/terminusgps/wialon/factory.py

@@ -0,0 +1,60 @@
+from terminusgps.wialon.items import (
+    WialonAccount,
+    WialonResource,
+    WialonRetranslator,
+    WialonRoute,
+    WialonUnit,
+    WialonUnitGroup,
+    WialonUser,
+)
+from terminusgps.wialon.items.base import WialonObject
+from terminusgps.wialon.session import WialonSession
+
+WIALON_ITEM_MAP = {
+    "account": WialonAccount,
+    "avl_hw": None,
+    "avl_resource": WialonResource,
+    "avl_retranslator": WialonRetranslator,
+    "avl_route": WialonRoute,
+    "avl_unit": WialonUnit,
+    "avl_unit_group": WialonUnitGroup,
+    "user": WialonUser,
+}
+
+
+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.1 → python_terminusgps-41.2.0}/uv.lock

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