python-terminusgps 43.0.0__tar.gz → 43.1.0__tar.gz

python_terminusgps-43.1.0/.github/workflows/sphinx.yml

@@ -0,0 +1,26 @@
+name: "Sphinx: Render docs"
+on: push
+
+jobs:
+  builds:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - name: Build HTML
+        uses: ammaraskar/sphinx-action@8.2.3
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: html-docs
+          path: docs/build/html/
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        if: github.ref == 'refs/heads/main'
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs/build/html
+

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/.gitignore

@@ -1,5 +1,6 @@
 .*
 !.gitignore
+!.github
 
 # Python-generated files
 __pycache__/

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 43.0.0
+Version: 43.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
@@ -12,7 +12,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.12
 Requires-Dist: authorizenet>=1.1.5
-Requires-Dist: django>=5.1.5
+Requires-Dist: django>=5.2.6
 Requires-Dist: python-wialon>=1.2.4
 Description-Content-Type: text/markdown
 

python_terminusgps-43.1.0/docs/CNAME

@@ -0,0 +1 @@
+docs.terminusgps.com

python_terminusgps-43.1.0/docs/requirements.txt

@@ -0,0 +1,4 @@
+django>=5.2.1
+furo==2024.04.27
+python-wialon>=1.2.4
+sphinxawesome-theme>=5.3.2

python_terminusgps-43.1.0/docs/source/authorizenet/api.rst

@@ -0,0 +1,38 @@
+Authorizenet API Endpoints
+==========================
+
+================
+Address Profiles
+================
+
+.. automodule:: terminusgps.authorizenet.api.address_profiles
+   :members:
+
+=================
+Customer Profiles
+=================
+
+.. automodule:: terminusgps.authorizenet.api.customer_profiles
+   :members:
+
+================
+Payment Profiles
+================
+
+.. automodule:: terminusgps.authorizenet.api.payment_profiles
+   :members:
+
+=============
+Subscriptions
+=============
+
+.. automodule:: terminusgps.authorizenet.api.subscriptions
+   :members:
+
+============
+Transactions
+============
+
+.. automodule:: terminusgps.authorizenet.api.transactions
+   :members:
+

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/docs/source/authorizenet/controllers.rst

@@ -1,7 +1,4 @@
 API Controllers
 ===============
 
-.. autoclass:: terminusgps.authorizenet.controllers.AuthorizenetControllerExecutor
-    :members:
-
 .. autoexception:: terminusgps.authorizenet.controllers.AuthorizenetControllerExecutionError

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/docs/source/authorizenet/index.rst

@@ -7,10 +7,9 @@ Authorizenet API
     :maxdepth: 2
     :caption: Contents:
 
+    api.rst
     auth.rst
     constants.rst
     controllers.rst
-    profiles.rst
-    subscriptions.rst
-    utils.rst
+    usage.rst
     validators.rst

python_terminusgps-43.1.0/docs/source/authorizenet/usage.rst

@@ -0,0 +1,20 @@
+Usage
+=====
+
+Check the Authorizenet API documentation for expected attributes in each response.
+
+.. code:: python
+
+    from terminusgps.authorizenet import api as anet
+
+    # An Authorizenet 'createCustomerProfileRequest'
+    response = anet.create_customer_profile(
+        merchant_id="1",
+        email="blake@terminusgps.com",
+        description="Blake Nall"
+    )
+
+    # Authorizenet API calls may return None
+    # Check first before trying to access attributes on it
+    if response is not None and hasattr(response, "customerProfileId"):
+        response.customerProfileId

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/docs/source/conf.py

@@ -8,23 +8,16 @@
 import os
 import sys
 
-import django
-from sphinxawesome_theme.postprocess import Icons
-
-sys.path.insert(0, os.path.abspath("../.."))
-os.environ["DJANGO_SETTINGS_MODULE"] = "terminusgps.django.settings"
-django.setup()
-
+sys.path.insert(0, os.path.abspath("../../"))
 project = "python-terminusgps"
 copyright = "2025, Terminus GPS, LLC"
 author = "Terminus GPS, LLC"
-release = "44.0.0"
+release = "43.1.0"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
 extensions = [
-    "autoclasstoc",
     "sphinx.ext.autodoc",
     "sphinx.ext.autosummary",
     "sphinx.ext.intersphinx",
@@ -32,7 +25,7 @@ extensions = [
 ]
 
 intersphinx_mapping = {
-    "python": ("https://docs.python.org/3", None),
+    "python": ("https://docs.python.org/3/", None),
     "django": (
         "http://docs.djangoproject.com/en/stable/",
         "http://docs.djangoproject.com/en/stable/_objects/",
@@ -47,7 +40,6 @@ exclude_patterns = []
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
 html_theme = "sphinxawesome_theme"
-html_permalinks_icon = Icons.permalinks_icon
 pygments_style = "sas"
 pygments_style_dark = "lightbulb"
 html_static_path = ["_static"]

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/docs/source/django/mixins.rst

@@ -3,7 +3,6 @@ Mixins
 
 .. autoclass:: terminusgps.django.mixins.HtmxTemplateResponseMixin
    :members:
-   :autoclasstoc:
 
 =====
 Usage

python_terminusgps-43.1.0/docs/source/wialon/index.rst

@@ -0,0 +1,10 @@
+Wialon API
+==========
+
+:py:mod:`terminusgps` offers the :py:mod:`wialon` package.
+
+.. toctree::
+    :maxdepth: 2
+    :caption: Contents:
+
+    session.rst

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/docs/source/wialon/session.rst

@@ -4,7 +4,6 @@ Wialon API Sessions
 .. autoclass:: terminusgps.wialon.session.WialonSession
    :members:
    :class-doc-from: init
-   :autoclasstoc:
 
 
 =====

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-terminusgps"
-version = "43.0.0"
+version = "43.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" } ]
@@ -13,7 +13,7 @@ classifiers = [
 requires-python = ">=3.12"
 dependencies = [
     "authorizenet>=1.1.5",
-    "django>=5.1.5",
+    "django>=5.2.6",
     "python-wialon>=1.2.4",
 ]
 
@@ -70,8 +70,10 @@ skip-magic-trailing-comma = true
 
 [dependency-groups]
 dev = [
-    "autoclasstoc>=1.7.0",
     "django-stubs>=5.1.3",
-    "sphinx>=8.1.3",
+]
+docs = [
+    "autoclasstoc>=1.7.0",
+    "sphinx>=8.2.3",
     "sphinxawesome-theme>=5.3.2",
 ]

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/terminusgps/authorizenet/api/address_profiles.py

@@ -15,18 +15,18 @@ __all__ = [
 def create_customer_shipping_address(
     customer_profile_id: int,
     address: apicontractsv1.customerAddressType,
-    default: bool = True,
+    default: bool = False,
 ) -> ObjectifiedElement | None:
     """
     `createCustomerShippingAddressRequest <https://developer.authorize.net/api/reference/index.html#customer-profiles-create-customer-shipping-address>`_.
 
     :param customer_profile_id: An Authorizenet customer profile id.
     :type customer_profile_id: :py:obj:`int`
-    :param elem: An Authorizenet customer address element.
-    :type elem: :py:obj:`~authorizenet.apicontractsv1.customerAddressType`
-    :param default: Whether or not to mark the new shipping address as default. Default is :py:obj:`True`.
+    :param address: An Authorizenet customer address element.
+    :type address: :py:obj:`~authorizenet.apicontractsv1.customerAddressType`
+    :param default: Whether to set the address profile as default. Default is :py:obj:`False`.
     :type default: :py:obj:`bool`
-    :returns: An Authorizenet createCustomerShippingAddress response.
+    :returns: An Authorizenet createCustomerShippingAddressResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
@@ -51,7 +51,7 @@ def get_customer_shipping_address(
     :type customer_profile_id: :py:obj:`int`
     :param address_profile_id: An Authorizenet customer address profile id.
     :type address_profile_id: :py:obj:`int`
-    :returns: An Authorizenet getCustomerShippingAddress response.
+    :returns: An Authorizenet getCustomerShippingAddressResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
@@ -77,9 +77,9 @@ def update_customer_shipping_address(
     :type customer_profile_id: :py:obj:`int`
     :param address: An Authorizenet customer address element.
     :type address: :py:obj:`~authorizenet.apicontractsv1.customerAddressType`
-    :param default: Whether or not to mark the new shipping address as default. Default is :py:obj:`False`.
+    :param default: Whether to set the address profile as default. Default is :py:obj:`False`.
     :type default: :py:obj:`bool`
-    :returns: An Authorizenet updateCustomerShippingAddress response.
+    :returns: An Authorizenet updateCustomerShippingAddressResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/terminusgps/authorizenet/api/customer_profiles.py

@@ -25,7 +25,7 @@ def create_customer_profile(
     :type email: :py:obj:`str`
     :param description: An optional customer description.
     :type description: :py:obj:`str`
-    :returns: An Authorizenet createCustomerProfile response.
+    :returns: An Authorizenet createCustomerProfileResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
@@ -49,9 +49,9 @@ def get_customer_profile(
 
     :param customer_profile_id: An Authorizenet customer profile id.
     :type customer_profile_id: :py:obj:`int`
-    :param include_issuer_info: Whether or not to include issuer info in the response. Default is :py:obj:`False`.
+    :param include_issuer_info: Whether to include issuer info in the response. Default is :py:obj:`False`.
     :type include_issuer_info: :py:obj:`bool`
-    :returns: An Authorizenet getCustomerProfile response.
+    :returns: An Authorizenet getCustomerProfileResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
@@ -69,7 +69,7 @@ def get_customer_profile_ids() -> ObjectifiedElement | None:
     """
     `getCustomerProfileIdsRequest <https://developer.authorize.net/api/reference/index.html#customer-profiles-get-customer-profile-ids>`_.
 
-    :returns: An Authorizenet getCustomerProfileIds response.
+    :returns: An Authorizenet getCustomerProfileIdsResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
@@ -89,7 +89,7 @@ def update_customer_profile(
 
     :param profile: An Authorizenet customer profile ex element.
     :type profile: :py:obj:`~authorizenet.apicontractsv1.customerProfileExType`
-    :returns: An Authorizenet updateCustomerProfile response.
+    :returns: An Authorizenet updateCustomerProfileResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
@@ -110,7 +110,7 @@ def delete_customer_profile(
 
     :param customer_profile_id: An Authorizenet customer profile id.
     :type customer_profile_id: :py:obj:`int`
-    :returns: An Authorizenet deleteCustomerProfile response.
+    :returns: An Authorizenet deleteCustomerProfileResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/terminusgps/authorizenet/api/payment_profiles.py

@@ -19,7 +19,7 @@ __all__ = [
 def create_customer_payment_profile(
     customer_profile_id: int,
     payment_profile: apicontractsv1.customerPaymentProfileType,
-    validate: bool = False,
+    validate: bool = True,
 ) -> ObjectifiedElement | None:
     """
     `createCustomerPaymentProfileRequest <https://developer.authorize.net/api/reference/index.html#customer-profiles-create-customer-payment-profile>`_.
@@ -28,7 +28,8 @@ def create_customer_payment_profile(
     :type customer_profile_id: :py:obj:`int`
     :param payment_profile: An Authorizenet payment profile element.
     :type payment_profile: :py:obj:`~authorizenet.apicontractsv1.customerPaymentProfileType`
-    :returns: An Authorizenet createCustomerPaymentProfile response.
+    :param validate: Whether to validate the payment profile. Default is :py:obj:`True`.
+    :returns: An Authorizenet createCustomerPaymentProfileResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
@@ -58,7 +59,7 @@ def get_customer_payment_profile(
     :type payment_profile_id: :py:obj:`int`
     :param include_issuer_info: Whether to include issuer info in the response. Default is :py:obj:`False`.
     :type include_issuer_info: :py:obj:`bool`
-    :returns: An Authorizenet getCustomerPaymentProfile response.
+    :returns: An Authorizenet getCustomerPaymentProfileResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
@@ -81,9 +82,9 @@ def validate_customer_payment_profile(
 
     :param customer_profile_id: An Authorizenet customer profile id.
     :type customer_profile_id: :py:obj:`int`
-    :param customer_payment_profile_id: An Authorizenet customer payment profile id.
-    :type customer_payment_profile_id: :py:obj:`int`
-    :returns: An Authorizenet validateCustomerPaymentProfile response.
+    :param payment_profile_id: An Authorizenet customer payment profile id.
+    :type payment_profile_id: :py:obj:`int`
+    :returns: An Authorizenet validateCustomerPaymentProfileResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
@@ -102,7 +103,7 @@ def update_customer_payment_profile(
     customer_profile_id: int,
     payment_profile_id: int,
     payment_profile: apicontractsv1.customerPaymentProfileType,
-    validate: bool = False,
+    validate: bool = True,
 ) -> ObjectifiedElement | None:
     """
     `updateCustomerPaymentProfileRequest <https://developer.authorize.net/api/reference/index.html#customer-profiles-update-customer-payment-profile>`_.
@@ -113,9 +114,9 @@ def update_customer_payment_profile(
     :type payment_profile_id: :py:obj:`int`
     :param payment_profile: An Authorizenet payment profile element.
     :type payment_profile: :py:obj:`~authorizenet.apicontractsv1.customerPaymentProfileType`
-    :param validate: Whether to validate the updated payment profile. Default is :py:obj:`False`.
+    :param validate: Whether to validate the payment profile. Default is :py:obj:`True`.
     :type validate: :py:obj:`bool`
-    :returns: An Authorizenet updateCustomerPaymentProfile response.
+    :returns: An Authorizenet updateCustomerPaymentProfileResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
@@ -144,7 +145,7 @@ def delete_customer_payment_profile(
     :type customer_profile_id: :py:obj:`int`
     :param payment_profile_id: An Authorizenet customer payment profile id.
     :type payment_profile_id: :py:obj:`int`
-    :returns: An Authorizenet deleteCustomerPaymentProfile response.
+    :returns: An Authorizenet deleteCustomerPaymentProfileResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/terminusgps/authorizenet/api/subscriptions.py

@@ -21,7 +21,7 @@ def create_subscription(
 
     :param subscription: An Authorizenet ARBSubscriptionType element.
     :type subscription: :py:obj:`~authorizenet.apicontractsv1.ARBSubscriptionType`
-    :returns: An Authorizenet ARBCreateSubscription response.
+    :returns: An Authorizenet ARBCreateSubscriptionResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
@@ -42,17 +42,17 @@ def get_subscription(
 
     :param subscription_id: An Authorizenet subscription id.
     :type subscription_id: :py:obj:`int`
-    :param include_transactions: Whether or not to include the subscription transaction list in the response. Default is :py:obj:`True`.
+    :param include_transactions: Whether to include the subscription transaction list in the response. Default is :py:obj:`True`.
     :type include_transactions: :py:obj:`bool`
-    :returns: An Authorizenet ARBGetSubscription response.
+    :returns: An Authorizenet ARBGetSubscriptionResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
-    request = apicontractsv1.ARBGetSubscriptionRequest(
-        merchantAuthentication=get_merchant_auth(),
-        subscriptionId=str(subscription_id),
-        includeTransactions=str(include_transactions).lower(),
-    )
+    request = apicontractsv1.ARBGetSubscriptionRequest()
+    request.merchantAuthentication = get_merchant_auth()
+    request.subscriptionId = str(subscription_id)
+    request.includeTransactions = str(include_transactions).lower()
+
     return execute_controller(
         apicontrollers.ARBGetSubscriptionController(request)
     )
@@ -64,38 +64,38 @@ def get_subscription_status(subscription_id: int) -> ObjectifiedElement | None:
 
     :param subscription_id: An Authorizenet subscription id.
     :type subscription_id: :py:obj:`int`
-    :returns: An Authorizenet ARBGetSubscriptionStatus response.
+    :returns: An Authorizenet ARBGetSubscriptionStatusResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
-    request = apicontractsv1.ARBGetSubscriptionStatusRequest(
-        merchantAuthentication=get_merchant_auth(),
-        subscriptionId=str(subscription_id),
-    )
+    request = apicontractsv1.ARBGetSubscriptionStatusRequest()
+    request.merchantAuthentication = get_merchant_auth()
+    request.subscriptionId = str(subscription_id)
+
     return execute_controller(
         apicontrollers.ARBGetSubscriptionStatusController(request)
     )
 
 
 def update_subscription(
-    subscription_id: int, subscription_obj: apicontractsv1.ARBSubscriptionType
+    subscription_id: int, subscription: apicontractsv1.ARBSubscriptionType
 ) -> ObjectifiedElement | None:
     """
     `ARBUpdateSubscriptionRequest <https://developer.authorize.net/api/reference/index.html#recurring-billing-update-a-subscription>`_.
 
     :param subscription_id: An Authorizenet subscription id.
     :type subscription_id: :py:obj:`int`
-    :param subscription_obj: An Authorizenet subscription object.
-    :type subscription_obj: :py:obj:`~authorizenet.apicontractsv1.ARBSubscriptionType`
-    :returns: An Authorizenet ARBUpdateSubscription response.
+    :param subscription: An Authorizenet ARBSubscriptionType element.
+    :type subscription: :py:obj:`~authorizenet.apicontractsv1.ARBSubscriptionType`
+    :returns: An Authorizenet ARBUpdateSubscriptionResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
-    request = apicontractsv1.ARBUpdateSubscriptionRequest(
-        merchantAuthentication=get_merchant_auth(),
-        subscriptionId=str(subscription_id),
-        subscription=subscription_obj,
-    )
+    request = apicontractsv1.ARBUpdateSubscriptionRequest()
+    request.merchantAuthentication = get_merchant_auth()
+    request.subscriptionId = str(subscription_id)
+    request.subscription = subscription
+
     return execute_controller(
         apicontrollers.ARBUpdateSubscriptionController(request)
     )
@@ -107,14 +107,14 @@ def cancel_subscription(subscription_id: int) -> ObjectifiedElement | None:
 
     :param subscription_id: An Authorizenet subscription id.
     :type subscription_id: :py:obj:`int`
-    :returns: An Authorizenet ARBCancelSubscription response.
+    :returns: An Authorizenet ARBCancelSubscriptionResponse element.
     :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
 
     """
-    request = apicontractsv1.ARBCancelSubscriptionRequest(
-        merchantAuthentication=get_merchant_auth(),
-        subscriptionId=str(subscription_id),
-    )
+    request = apicontractsv1.ARBCancelSubscriptionRequest()
+    request.merchantAuthentication = get_merchant_auth()
+    request.subscriptionId = str(subscription_id)
+
     return execute_controller(
         apicontrollers.ARBCancelSubscriptionController(request)
     )

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/terminusgps/authorizenet/api/transactions.py

@@ -1,4 +1,4 @@
-from datetime import datetime
+import datetime
 
 from authorizenet import apicontractsv1, apicontrollers
 from lxml.objectify import ObjectifiedElement
@@ -10,7 +10,9 @@ __all__ = []
 
 
 def get_settled_batch_list(
-    start: datetime, end: datetime, include_statistics: bool = False
+    start: datetime.datetime,
+    end: datetime.datetime,
+    include_statistics: bool = False,
 ) -> ObjectifiedElement | None:
     """
     `getSettledBatchListRequest <https://developer.authorize.net/api/reference/index.html#transaction-reporting-get-settled-batch-list>`_.

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/terminusgps/django/settings.py

@@ -15,5 +15,4 @@ MERCHANT_AUTH_LOGIN_ID = os.getenv("MERCHANT_AUTH_LOGIN_ID")
 MERCHANT_AUTH_TRANSACTION_KEY = os.getenv("MERCHANT_AUTH_TRANSACTION_KEY")
 MERCHANT_AUTH_ENVIRONMENT = constants.SANDBOX
 MERCHANT_AUTH_VALIDATION_MODE = "testMode"
-WIALON_ADMIN_ID = os.getenv("WIALON_ADMIN_ID")
 WIALON_TOKEN = os.getenv("WIALON_TOKEN")

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/terminusgps/wialon/session.py

@@ -50,7 +50,7 @@ class WialonSession:
 
         """
 
-        self._token = token or os.getenv("WIALON_TOKEN")
+        self._token = token if token else os.getenv("WIALON_TOKEN")
         self._username = None
         self._uid = None
         self._wialon_api = Wialon(
@@ -93,7 +93,7 @@ class WialonSession:
     @property
     def uid(self) -> str | None:
         """
-        A Wialon user ID this session is operating as.
+        User id of the session's authenticated Wialon user.
 
         :type: :py:obj:`str` | :py:obj:`None`
         :value: :py:obj:`None`
@@ -103,7 +103,7 @@ class WialonSession:
     @property
     def username(self) -> str | None:
         """
-        A Wialon username the session is operating as.
+        Username of the session's authenticated Wialon user.
 
         :type: :py:obj:`str` | :py:obj:`None`
         :value: :py:obj:`None`
@@ -114,6 +114,8 @@ class WialonSession:
     @property
     def id(self) -> str | None:
         """
+        Wialon API session id.
+
         Shortcut property for :py:attr:`WialonSession.wialon_api.sid`.
 
         Returns :py:obj:`None` if the session wasn't logged in.
@@ -127,19 +129,16 @@ class WialonSession:
     @property
     def token(self) -> str:
         """
-        A Wialon API token set during :py:meth:`WialonSession.__init__`.
-
-        Default token value is :confval:`WIALON_TOKEN`.
+        Wialon API token set during :py:meth:`WialonSession.__init__`.
 
         :type: :py:obj:`str`
-        :value: :confval:`WIALON_TOKEN`
 
         """
         return str(self._token)
 
     def login(self, token: str, flags: int | None = None) -> str:
         """
-        Logs into the Wialon API and starts a new session.
+        Logs into the Wialon API, starts a new session then returns its id.
 
         :param token: An active Wialon API token.
         :type token: :py:obj:`str`
@@ -190,7 +189,9 @@ class WialonSession:
 
         """
         if login_response is None:
-            raise ValueError(f"Login response is required, got '{login_response}'")
+            raise ValueError(
+                f"Login response is required, got '{login_response}'"
+            )
 
         self.wialon_api.sid = login_response.get("eid")
         self._uid = login_response.get("user", {}).get("id")

{python_terminusgps-43.0.0 → python_terminusgps-43.1.0}/uv.lock

@@ -298,7 +298,7 @@ wheels = [
 
 [[package]]
 name = "python-terminusgps"
-version = "43.0.0"
+version = "43.1.0"
 source = { editable = "." }
 dependencies = [
     { name = "authorizenet" },
@@ -308,8 +308,10 @@ dependencies = [
 
 [package.dev-dependencies]
 dev = [
-    { name = "autoclasstoc" },
     { name = "django-stubs" },
+]
+docs = [
+    { name = "autoclasstoc" },
     { name = "sphinx" },
     { name = "sphinxawesome-theme" },
 ]
@@ -317,15 +319,15 @@ dev = [
 [package.metadata]
 requires-dist = [
     { name = "authorizenet", specifier = ">=1.1.5" },
-    { name = "django", specifier = ">=5.1.5" },
+    { name = "django", specifier = ">=5.2.6" },
     { name = "python-wialon", specifier = ">=1.2.4" },
 ]
 
 [package.metadata.requires-dev]
-dev = [
+dev = [{ name = "django-stubs", specifier = ">=5.1.3" }]
+docs = [
     { name = "autoclasstoc", specifier = ">=1.7.0" },
-    { name = "django-stubs", specifier = ">=5.1.3" },
-    { name = "sphinx", specifier = ">=8.1.3" },
+    { name = "sphinx", specifier = ">=8.2.3" },
     { name = "sphinxawesome-theme", specifier = ">=5.3.2" },
 ]