python-terminusgps 28.9.0__py3-none-any.whl → 28.11.0__py3-none-any.whl

{python_terminusgps-28.9.0.dist-info → python_terminusgps-28.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 28.9.0
+Version: 28.11.0
 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

{python_terminusgps-28.9.0.dist-info → python_terminusgps-28.11.0.dist-info}/RECORD

@@ -1,5 +1,7 @@
 terminusgps/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+terminusgps/mixins.py,sha256=r6_I9D_7cX6_ZlkYp2GySu_2gywzhvs1lePFFf3dDYA,981
 terminusgps/settings.py,sha256=vY5yNjyMu-7Ya0bIPWUvrrSLERtxHGdkfeoY4Ul6cP0,613
+terminusgps/validators.py,sha256=4qGYSNXje-8SstuRsKYF9RH7-0B1v0xjRuYDHFaz9eg,2278
 terminusgps/authorizenet/__init__.py,sha256=LiGLlWNNiqS7RSOP4Apabx-b9EBYyNbxRY_a0mvJoaE,466
 terminusgps/authorizenet/auth.py,sha256=ICxPPzoUc64VbsIIemEWKrn8xjHGwbNdo2VbtaFCFss,1107
 terminusgps/authorizenet/errors.py,sha256=HG5NwVxQCtOYidVl30y49PC0Ovw5VYdsy9wTgUFMw9M,949
@@ -30,7 +32,7 @@ terminusgps/wialon/items/route.py,sha256=8SzlqNmpYVdt-ZAY--B_KHoDIHgN0Zb7KBsBWAz
 terminusgps/wialon/items/unit.py,sha256=i7sQiRu3N0XxyTHVN2RnmjYy9X48KdnZLSB18ic37w8,9363
 terminusgps/wialon/items/unit_group.py,sha256=YsYh34l2DjSKcv5SIZkEVi5FSjveGB1gxU2fwdLyvl4,4101
 terminusgps/wialon/items/user.py,sha256=PFYBie04F16YE2B5364PLxkmlTmQr4sZXpItvRBxsDc,7143
-python_terminusgps-28.9.0.dist-info/METADATA,sha256=ikW1QHGC85Ch9G2-99zUIpaOrYiQCOnmU8gkUy-zNTc,946
-python_terminusgps-28.9.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_terminusgps-28.9.0.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-python_terminusgps-28.9.0.dist-info/RECORD,,
+python_terminusgps-28.11.0.dist-info/METADATA,sha256=EiJNW0h7a2jgPPjIEQ8bYo2BvlcAmMKqnXkuVMp6vW0,947
+python_terminusgps-28.11.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_terminusgps-28.11.0.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+python_terminusgps-28.11.0.dist-info/RECORD,,

terminusgps/mixins.py

@@ -0,0 +1,34 @@
+import typing
+
+from django.http import HttpResponse
+from django.views.generic.base import TemplateResponseMixin
+
+
+class HtmxTemplateResponseMixin(TemplateResponseMixin):
+    """
+    Renders a partial HTML template depending on HTTP headers.
+
+    `htmx documentation <https://htmx.org/docs/>`_
+
+    """
+
+    partial_template_name: str | None = None
+    """
+    A partial template rendered by `htmx`_.
+
+    .. _htmx: https://htmx.org/docs/
+
+    :type: :py:obj:`str` | :py:obj:`None`
+    :value: :py:obj:`None`
+
+    """
+
+    def render_to_response(
+        self, context: dict[str, typing.Any], **response_kwargs: typing.Any
+    ) -> HttpResponse:
+        htmx_request = self.request.headers.get("HX-Request", False)
+        boosted = self.request.headers.get("HX-Boosted", False)
+
+        if htmx_request and self.partial_template_name and not boosted:
+            self.template_name = self.partial_template_name
+        return super().render_to_response(context, **response_kwargs)

terminusgps/validators.py

@@ -0,0 +1,58 @@
+import string
+
+from django.core.exceptions import ValidationError
+from django.utils.translation import gettext_lazy as _
+
+
+def validate_vin_number(value: str) -> None:
+    """Raises :py:exec:`ValidationError` if the value is an invalid VIN number."""
+    if not len(value) == 17:
+        raise ValidationError(
+            _("Whoops! VIN # must be exactly 17 characters long, got %(len)s."),
+            code="invalid",
+            params={"len": len(value)},
+        )
+
+
+def validate_wialon_password(value: str) -> None:
+    """Raises :py:exec:`ValidationError` if the value represents an invalid Wialon password."""
+    special_symbols_0: list[str] = ["!", "@", "#", "$", "%", "^", "*"]
+    special_symbols_1: list[str] = ["(", ")", "[", "]", "-", "_", "+"]
+    forbidden_symbols: list[str] = [",", ":", "&", "<", ">", "'"]
+    value = value.strip() if value.startswith(" ") or value.endswith(" ") else value
+
+    if len(value) < 4:
+        raise ValidationError(
+            _("Password cannot be less than 4 characters in length. Got '%(len)s'."),
+            code="invalid",
+            params={"len": len(value)},
+        )
+    if len(value) > 64:
+        raise ValidationError(
+            _(
+                "Password cannot be greater than 64 characters in length. Got '%(len)s'."
+            ),
+            code="invalid",
+            params={"len": len(value)},
+        )
+    if not any([char for char in value if char in string.ascii_uppercase]):
+        raise ValidationError(
+            _("Password must contain at least one uppercase letter."), code="invalid"
+        )
+    if not any([char for char in value if char in string.ascii_lowercase]):
+        raise ValidationError(
+            _("Password must contain at least one lowercase letter."), code="invalid"
+        )
+    if not any(
+        [char for char in value if char in special_symbols_0 + special_symbols_1]
+    ):
+        raise ValidationError(
+            _("Password must contain at least one special symbol."), code="invalid"
+        )
+    for char in value:
+        if char in forbidden_symbols:
+            raise ValidationError(
+                _("Password cannot contain forbidden character '%(char)s'."),
+                code="invalid",
+                params={"char": char},
+            )