pypomes-jwt 1.3.6__py3-none-any.whl → 1.3.8__py3-none-any.whl

pypomes_jwt/__init__.py

@@ -7,20 +7,15 @@ from .jwt_pomes import (
     jwt_issue_token, jwt_issue_tokens, jwt_refresh_tokens,
     jwt_get_claims, jwt_validate_token, jwt_revoke_token
 )
-from .jwt_providers import (
-    provider_register, provider_get_token
-)
 
 __all__ = [
-    # jwt_constants
+    # jwt_config
     "JwtConfig", "JwtDbConfig", "JwtAlgorithm",
     # jwt_pomes
     "jwt_needed", "jwt_verify_request",
     "jwt_assert_account", "jwt_set_account", "jwt_remove_account",
     "jwt_issue_token", "jwt_issue_tokens", "jwt_refresh_tokens",
-    "jwt_get_claims", "jwt_validate_token", "jwt_revoke_token",
-    # jwt_providers
-    "provider_register", "provider_get_token"
+    "jwt_get_claims", "jwt_validate_token", "jwt_revoke_token"
 ]
 
 from importlib.metadata import version

pypomes_jwt/jwt_config.py

@@ -66,14 +66,22 @@ del _encoding_key
 del _default_algorithm
 
 
+# database access is not be necessary, if only handling externally provided JWT tokens
 class JwtDbConfig(StrEnum):
     """
     Parameters for JWT database connection.
     """
-    ENGINE = env_get_str(key=f"{APP_PREFIX}_JWT_DB_ENGINE")
-    TABLE = env_get_str(key=f"{APP_PREFIX}_JWT_DB_TABLE")
-    COL_ACCOUNT = env_get_str(key=f"{APP_PREFIX}_JWT_DB_COL_ACCOUNT")
-    COL_ALGORITHM = env_get_str(key=f"{APP_PREFIX}_JWT_DB_COL_ALGORITHM")
-    COL_DECODER = env_get_str(key=f"{APP_PREFIX}_JWT_DB_COL_DECODER")
-    COL_KID = env_get_str(key=f"{APP_PREFIX}_JWT_DB_COL_KID")
-    COL_TOKEN = env_get_str(key=f"{APP_PREFIX}_JWT_DB_COL_TOKEN")
+    ENGINE = env_get_str(key=f"{APP_PREFIX}_JWT_DB_ENGINE",
+                         def_value="")
+    TABLE = env_get_str(key=f"{APP_PREFIX}_JWT_DB_TABLE",
+                        def_value="")
+    COL_ACCOUNT = env_get_str(key=f"{APP_PREFIX}_JWT_DB_COL_ACCOUNT",
+                              def_value="")
+    COL_ALGORITHM = env_get_str(key=f"{APP_PREFIX}_JWT_DB_COL_ALGORITHM",
+                                def_value="")
+    COL_DECODER = env_get_str(key=f"{APP_PREFIX}_JWT_DB_COL_DECODER",
+                              def_value="")
+    COL_KID = env_get_str(key=f"{APP_PREFIX}_JWT_DB_COL_KID",
+                          def_value="")
+    COL_TOKEN = env_get_str(key=f"{APP_PREFIX}_JWT_DB_COL_TOKEN",
+                            def_value="")

{pypomes_jwt-1.3.6.dist-info → pypomes_jwt-1.3.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pypomes_jwt
-Version: 1.3.6
+Version: 1.3.8
 Summary: A collection of Python pomes, penyeach (JWT module)
 Project-URL: Homepage, https://github.com/TheWiseCoder/PyPomes-JWT
 Project-URL: Bug Tracker, https://github.com/TheWiseCoder/PyPomes-JWT/issues
@@ -10,8 +10,8 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.12
-Requires-Dist: cryptography>=46.0.2
+Requires-Dist: cryptography>=46.0.3
 Requires-Dist: flask>=3.1.2
 Requires-Dist: pyjwt>=2.10.1
-Requires-Dist: pypomes-core>=2.7.6
-Requires-Dist: pypomes-db>=2.7.6
+Requires-Dist: pypomes-core>=2.7.8
+Requires-Dist: pypomes-db>=2.8.1

pypomes_jwt-1.3.8.dist-info/RECORD

@@ -0,0 +1,8 @@
+pypomes_jwt/__init__.py,sha256=esLvNt3Vr4WiZlx1lqKbLIXpDhdBFjqhqKUM6laSwg4,820
+pypomes_jwt/jwt_config.py,sha256=ypr7BCRp1slJ503iyVmma-ljbaZAnbk_qpZKNRjD5CI,4026
+pypomes_jwt/jwt_pomes.py,sha256=WWmZYVpG6wqlIjcJU3jNyBquCgfB-OcgCJBmm6imL4Q,23524
+pypomes_jwt/jwt_registry.py,sha256=ypBEoL0I2F08sR2G2VO9wXxVeE252lNzjIAC3FGORhA,22631
+pypomes_jwt-1.3.8.dist-info/METADATA,sha256=8qS7vQRszQmdG5YU2bWTzlFIy_XpoaEcruzNL40TDec,660
+pypomes_jwt-1.3.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pypomes_jwt-1.3.8.dist-info/licenses/LICENSE,sha256=NdakochSXm_H_-DSL_x2JlRCkYikj3snYYvTwgR5d_c,1086
+pypomes_jwt-1.3.8.dist-info/RECORD,,

pypomes_jwt/jwt_providers.py

@@ -1,138 +0,0 @@
-import requests
-import sys
-from base64 import b64encode
-from datetime import datetime
-from logging import Logger
-from pypomes_core import TZ_LOCAL, exc_format
-from requests import Response
-from typing import Any
-
-# structure:
-# {
-#    <provider-id>: {
-#      "url": <strl>,
-#      "user": <str>,
-#      "pwd": <str>,
-#      "basic-auth": <bool>,
-#      "headers-data": <dict[str, str]>,
-#      "body-data": <dict[str, str],
-#      "token": <str>,
-#      "expiration": <timestamp>
-#    }
-# }
-_provider_registry: dict[str, dict[str, Any]] = {}
-
-
-def provider_register(provider_id: str,
-                      access_url: str,
-                      auth_user: str,
-                      auth_pwd: str,
-                      custom_auth: tuple[str, str] = None,
-                      headers_data: dict[str, str] = None,
-                      body_data: dict[str, str] = None) -> None:
-    """
-    Register an external authentication token provider.
-
-    If specified, *custom_auth* provides key names for sending credentials (username and password, in this order)
-    as key-value pairs in the body of the request. Otherwise, the external provider *provider_id* uses the standard
-    HTTP Basic Authorization scheme, wherein the credentials are B64-encoded and send in the request headers.
-
-    Optional constant key-value pairs (such as ['Content-Type', 'application/x-www-form-urlencoded']), to be
-    added to the request headers, may be specified in *headers_data*. Likewise, optional constant key-value pairs
-    (such as ['grant_type', 'client_credentials']), to be added to the request body, may be specified in *body_data*.
-
-    :param provider_id: the provider's identification
-    :param access_url: the url to request authentication tokens with
-    :param auth_user: the basic authorization user
-    :param auth_pwd: the basic authorization password
-    :param custom_auth: optional key names for sending the credentials as key-value pairs in the body of the request
-    :param headers_data: optional key-value pairs to be added to the request headers
-    :param body_data: optional key-value pairs to be added to the request body
-    """
-    global _provider_registry  # noqa: PLW0602
-    _provider_registry[provider_id] = {
-        "url": access_url,
-        "user": auth_user,
-        "pwd": auth_pwd,
-        "custom-auth": custom_auth,
-        "headers-data": headers_data,
-        "body-data": body_data,
-        "token": None,
-        "expiration": datetime.now(tz=TZ_LOCAL).timestamp()
-    }
-
-
-def provider_get_token(provider_id: str,
-                       errors: list[str] = None,
-                       logger: Logger = None) -> str | None:
-    """
-    Obtain an authentication token from the external provider *provider_id*.
-
-    :param provider_id: the provider's identification
-    :param errors: incidental error messages
-    :param logger: optional logger
-    """
-    # initialize the return variable
-    result: str | None = None
-
-    global _provider_registry  # noqa: PLW0602
-    err_msg: str | None = None
-    provider: dict[str, Any] = _provider_registry.get(provider_id)
-    if provider:
-        now: float = datetime.now(tz=TZ_LOCAL).timestamp()
-        if now > provider.get("expiration"):
-            user: str = provider.get("user")
-            pwd: str = provider.get("pwd")
-            headers_data: dict[str, str] = provider.get("headers-data") or {}
-            body_data: dict[str, str] = provider.get("body-data") or {}
-            custom_auth: tuple[str, str] = provider.get("custom-auth")
-            if custom_auth:
-                body_data[custom_auth[0]] = user
-                body_data[custom_auth[1]] = pwd
-            else:
-                enc_bytes: bytes = b64encode(f"{user}:{pwd}".encode())
-                headers_data["Authorization"] = f"Basic {enc_bytes.decode()}"
-            url: str = provider.get("url")
-            try:
-                # typical return on a token request:
-                # {
-                #   "token_type": "Bearer",
-                #   "access_token": <str>,
-                #   "expires_in": <number-of-seconds>,
-                #   optional data:
-                #   "refresh_token": <str>,
-                #   "refresh_expires_in": <number-of-seconds>
-                # }
-                response: Response = requests.post(url=url,
-                                                   data=body_data,
-                                                   headers=headers_data,
-                                                   timeout=None)
-                if response.status_code < 200 or response.status_code >= 300:
-                    # request resulted in error, report the problem
-                    err_msg = (f"POST '{url}': failed, "
-                               f"status {response.status_code}, reason '{response.reason}'")
-                else:
-                    reply: dict[str, Any] = response.json()
-                    provider["token"] = reply.get("access_token")
-                    provider["expiration"] = now + int(reply.get("expires_in"))
-                    if logger:
-                        logger.debug(msg=f"POST '{url}': status {response.status_code}")
-            except Exception as e:
-                # the operation raised an exception
-                err_msg = exc_format(exc=e,
-                                     exc_info=sys.exc_info())
-                err_msg = f"POST '{url}': error, '{err_msg}'"
-    else:
-        err_msg: str = f"Provider '{provider_id}' not registered"
-
-    if err_msg:
-        if isinstance(errors, list):
-            errors.append(err_msg)
-        if logger:
-            logger.error(msg=err_msg)
-    else:
-        result = provider.get("token")
-
-    return result
-
-

pypomes_jwt-1.3.6.dist-info/RECORD

@@ -1,9 +0,0 @@
-pypomes_jwt/__init__.py,sha256=vXAeaEnuUqpvGtV465TsW2Lf3ihijrMP2Hm4My79y88,968
-pypomes_jwt/jwt_config.py,sha256=GAFrvsCeBUIt2OzO-xLSM6qTe7iehvqrcHlu_CUnGAI,3638
-pypomes_jwt/jwt_pomes.py,sha256=WWmZYVpG6wqlIjcJU3jNyBquCgfB-OcgCJBmm6imL4Q,23524
-pypomes_jwt/jwt_providers.py,sha256=3o48fGZ9W0xwpdivECMb2E3GLdraU-Vh8zRyejbLgpc,5853
-pypomes_jwt/jwt_registry.py,sha256=ypBEoL0I2F08sR2G2VO9wXxVeE252lNzjIAC3FGORhA,22631
-pypomes_jwt-1.3.6.dist-info/METADATA,sha256=bWvYWUMYqc6AecDMkK0p3KxvXRMLZUTEglopfd8pk_A,660
-pypomes_jwt-1.3.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-pypomes_jwt-1.3.6.dist-info/licenses/LICENSE,sha256=NdakochSXm_H_-DSL_x2JlRCkYikj3snYYvTwgR5d_c,1086
-pypomes_jwt-1.3.6.dist-info/RECORD,,