python-terminusgps 20.6.1__tar.gz → 20.6.2__tar.gz

{python_terminusgps-20.6.1 → python_terminusgps-20.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 20.6.1
+Version: 20.6.2
 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
@@ -16,6 +16,5 @@ Requires-Dist: argparse>=1.4.0
 Requires-Dist: authorizenet>=1.1.5
 Requires-Dist: boto3>=1.34.144
 Requires-Dist: django>=5.1.5
-Requires-Dist: lxml==4.9.4
 Requires-Dist: python-wialon>=1.2.4
 Requires-Dist: twilio>=9.4.5

{python_terminusgps-20.6.1 → python_terminusgps-20.6.2}/docs/source/conf.py

@@ -10,7 +10,7 @@ from sphinxawesome_theme.postprocess import Icons
 project = "python-terminusgps"
 copyright = "2025, Terminus GPS, LLC"
 author = "Terminus GPS, LLC"
-release = "20.5.2"
+release = "20.6.1"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

{python_terminusgps-20.6.1 → python_terminusgps-20.6.2}/docs/source/index.rst

@@ -27,6 +27,7 @@ In Python, all subpackages are nested within :py:mod:`terminusgps`:
     :maxdepth: 2
     :caption: Contents:
 
+    settings.rst
     authorizenet/index.rst
     aws/index.rst
     twilio/index.rst

{python_terminusgps-20.6.1 → python_terminusgps-20.6.2}/docs/source/wialon/examples.rst

@@ -2,34 +2,44 @@ Usage Examples
 ==============
 
 ===============================
-Create a new unit and rename it
+Create a new user and rename it
 ===============================
 
-1. Import :py:obj:`~terminusgps.wialon.session.WialonSession` and :py:obj:`~terminusgps.wialon.items.unit.WialonUnit`.
+----------------------------------------------------------------------------------------------------------------------
+1. Import :py:obj:`~terminusgps.wialon.session.WialonSession` and :py:obj:`~terminusgps.wialon.items.user.WialonUser`.
+----------------------------------------------------------------------------------------------------------------------
 
 Let's also import :py:obj:`~terminusgps.wialon.utils.generate_wialon_password` so we don't have to come up with a valid Wialon password ourselves.
 
 .. code:: python
 
     from terminusgps.wialon.session import WialonSession
-    from terminusgps.wialon.items import WialonUnit
+    from terminusgps.wialon.items import WialonUser
     from terminusgps.wialon.utils import generate_wialon_password
 
-2. Open the session in a context manager and instantiate a unit.
+----------------------------------------------------------------
+2. Open the session in a context manager and instantiate a user.
+----------------------------------------------------------------
+
+When creating a new Wialon object, you *must* pass :py:obj:`None` as the ``id`` parameter.
+
+It is recommended to only use keyword arguments when instantiating a :py:obj:`~terminusgps.wialon.items.base.WialonBase` object.
 
 .. code:: python
 
     with WialonSession(token="my_wialon_api_token") as session:
-        unit = WialonUnit(
+        user = WialonUser(
             id=None,
             session=session,
-            creator_id="123",
+            creator_id="27884511", # Admin user id
             name="test_user",
             password=generate_wialon_password(32)
         )
-        print(f"{unit.name = }") # unit.name = "test_user"
+        print(f"{user.name = }") # user.name = "test_user"
 
-3. Within the context manager, :py:obj:`~terminusgps.wialon.items.WialonUnit` methods can be executed.
+-----------------------------------------------------------------------------------------------------------
+3. Within the context manager, :py:meth:`~terminusgps.wialon.items.base.WialonBase.rename` can be executed.
+-----------------------------------------------------------------------------------------------------------
 
 .. code:: python
 
@@ -37,6 +47,7 @@ Let's also import :py:obj:`~terminusgps.wialon.utils.generate_wialon_password` s
         ...
 
         unit.rename("super_test_user")
+        print(f"{user.name = }") # user.name = "super_test_user"
         # Session is logged out after exiting scope
 
 -----------------
@@ -64,14 +75,18 @@ Full code example
 Create an account and migrate a unit into it
 ============================================
 
+------------------------------------------------------------------------------------------------------------------------------------------------
 1. Import :py:obj:`~terminusgps.wialon.session.WialonSession`, :py:mod:`~terminusgps.wialon.items`, and :py:mod:`~terminusgps.wialon.constants`.
+------------------------------------------------------------------------------------------------------------------------------------------------
 
 .. code:: python
 
     from terminusgps.wialon.session import WialonSession
     from terminusgps.wialon import items, constants
 
+--------------------------
 2. Create an account user.
+--------------------------
 
 .. code:: python
 
@@ -84,7 +99,9 @@ Create an account and migrate a unit into it
             password="super_secure_password1!",
         )
 
+--------------------------------------------
 3. Create a resource using the account user.
+--------------------------------------------
 
 .. code:: python
 
@@ -97,7 +114,9 @@ Create an account and migrate a unit into it
             name="account_resource",
         )
 
+------------------------------------------------------------------
 4. Retrieve a :py:obj:`~terminusgps.wialon.items.unit.WialonUnit`.
+------------------------------------------------------------------
 
 .. code:: python
 
@@ -105,7 +124,9 @@ Create an account and migrate a unit into it
         ...
         unit = items.WialonUnit(id="12345678", session=session)
 
+------------------------------------------------
 5. Grant the account user migration permissions.
+------------------------------------------------
 
 .. code:: python
 
@@ -113,7 +134,9 @@ Create an account and migrate a unit into it
         ...
         account_user.grant_access(unit, access_mask=constants.ACCESSMASK_UNIT_MIGRATION)
 
+--------------------------------------------------------
 6. Transform the resource into an account and enable it.
+--------------------------------------------------------
 
 .. code:: python
 
@@ -122,7 +145,9 @@ Create an account and migrate a unit into it
         account_resource.create_account("terminusgps_ext_hist")
         account_resource.enable()
 
+-------------------------------------
 7. Migrate the unit into the account.
+-------------------------------------
 
 .. code:: python
 

{python_terminusgps-20.6.1 → python_terminusgps-20.6.2}/docs/source/wialon/index.rst

@@ -15,5 +15,4 @@ Wialon API
     flags.rst
     items.rst
     session.rst
-    settings.rst
     utils.rst

{python_terminusgps-20.6.1 → python_terminusgps-20.6.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-terminusgps"
-version = "20.6.1"
+version = "20.6.2"
 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" } ]
@@ -17,7 +17,6 @@ dependencies = [
     "authorizenet>=1.1.5",
     "boto3>=1.34.144",
     "django>=5.1.5",
-    "lxml==4.9.4",
     "python-wialon>=1.2.4",
     "twilio>=9.4.5",
 ]

{python_terminusgps-20.6.1 → python_terminusgps-20.6.2}/terminusgps/wialon/utils.py

@@ -1,6 +1,5 @@
 import secrets
 import string
-import warnings
 import typing
 
 from terminusgps.wialon import items, flags

{python_terminusgps-20.6.1 → python_terminusgps-20.6.2}/uv.lock

@@ -556,14 +556,13 @@ wheels = [
 
 [[package]]
 name = "python-terminusgps"
-version = "20.6.1"
+version = "20.6.2"
 source = { editable = "." }
 dependencies = [
     { name = "argparse" },
     { name = "authorizenet" },
     { name = "boto3" },
     { name = "django" },
-    { name = "lxml" },
     { name = "python-wialon" },
     { name = "twilio" },
 ]
@@ -581,7 +580,6 @@ requires-dist = [
     { name = "authorizenet", specifier = ">=1.1.5" },
     { name = "boto3", specifier = ">=1.34.144" },
     { name = "django", specifier = ">=5.1.5" },
-    { name = "lxml", specifier = "==4.9.4" },
     { name = "python-wialon", specifier = ">=1.2.4" },
     { name = "twilio", specifier = ">=9.4.5" },
 ]