PyPI - base-api-utils - Versions diffs - 1.1.76__tar.gz → 1.1.78__tar.gz - Mend

@@ -0,0 +1,99 @@
+"""
+Fingerprint utility functions for computing SHA-256 based identity hashes.
+These functions enable change detection to determine when entities need to be
+created or updated by computing deterministic fingerprints from their field values.
+"""
+import hashlib
+from datetime import datetime
+from typing import Any, Dict, Iterable, Optional
+def compute_sha256(data: str) -> str:
+    """
+    Compute SHA-256 hash of the input string.
+    Args:
+        data: The string to hash
+    Returns:
+        64-character lowercase hex string
+    """
+    return hashlib.sha256(data.encode('utf-8')).hexdigest()
+def format_value(value: Any) -> Optional[str]:
+    """
+    Format a field value for inclusion in a fingerprint string.
+    Args:
+        value: The value to format
+    Returns:
+        Formatted string representation, or None if the value should be skipped
+    """
+    if value is None:
+        return None
+    if isinstance(value, bool):
+        return "true" if value else "false"
+    if isinstance(value, datetime):
+        return value.isoformat()
+    return str(value)
+def build_fingerprint_string(fields: Dict[str, Any]) -> str:
+    """
+    Build a deterministic string from field name-value pairs.
+    Fields are sorted by name for determinism. Fields with None values are skipped.
+    Args:
+        fields: Dictionary of field names to values
+    Returns:
+        Concatenated string of "name=value" pairs separated by "|"
+    """
+    parts = []
+    for key in sorted(fields.keys()):
+        formatted = format_value(fields[key])
+        if formatted is not None:
+            parts.append(f"{key}={formatted}")
+    return "|".join(parts)
+def format_id_list(ids: Iterable[int]) -> str:
+    """
+    Format a list of IDs as a comma-separated string.
+    IDs are sorted numerically for determinism.
+    Args:
+        ids: Iterable of integer IDs
+    Returns:
+        Comma-separated string of sorted IDs
+    """
+    return ",".join(str(id_) for id_ in sorted(ids))
+def combine_fingerprints(fingerprints: Iterable[str]) -> str:
+    """
+    Combine multiple fingerprints into a single hash.
+    Fingerprints are sorted for determinism before being concatenated and hashed.
+    Args:
+        fingerprints: Iterable of fingerprint hex strings
+    Returns:
+        64-character lowercase hex string, or empty string if no fingerprints
+    """
+    sorted_fps = sorted(fingerprints)
+    if not sorted_fps:
+        return ""
+    combined = "|".join(sorted_fps)
+    return compute_sha256(combined)

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: base-api-utils
-Version: 1.1.76
+Version: 1.1.78
 Summary: Django Rest Framework micro services common utilities
 Author-email: Román Gutierrez <roman@tipit.net>, Sebastian Marcet <sebastian@tipit.net>
 Project-URL: Homepage, https://github.com/fntechgit/base-api-utils

@@ -7,7 +7,7 @@ where = ["src"]
 [project]
 name = "base-api-utils"
-version = "1.1.76"
+version = "1.1.78"
 dependencies = [
     "boto3",
     "celery",

@@ -6,7 +6,8 @@ from django.core.cache import cache
 from requests_oauthlib import OAuth2Session
 from requests.exceptions import RequestException
 from rest_framework.exceptions import ValidationError, NotFound
-from rest_framework.status import HTTP_404_NOT_FOUND, HTTP_401_UNAUTHORIZED, HTTP_412_PRECONDITION_FAILED
+from rest_framework.status import HTTP_404_NOT_FOUND, HTTP_401_UNAUTHORIZED, HTTP_412_PRECONDITION_FAILED, \
+    HTTP_403_FORBIDDEN
 from .oauth2_client_factory import OAuth2ClientFactory
 from .shared import client_secret_basic_auth_method
@@ -58,12 +59,15 @@ class AbstractOAuth2APIClient(ABC):
                     if ex.response.status_code == HTTP_404_NOT_FOUND:
                         raise NotFound(ex.response.text)
-                    if ex.response.status_code == HTTP_401_UNAUTHORIZED:
-                        logging.warning(f"Access token revoked or expired. Cleaning cache and retrying... (attempt {retries + 1})")
+                    if ex.response.status_code in (HTTP_401_UNAUTHORIZED, HTTP_403_FORBIDDEN):
+                        logging.warning(
+                            f"Access token revoked, expired or insufficient permissions (HTTP {ex.response.status_code}). "
+                            f"Cleaning cache and retrying... (attempt {retries + 1})"
+                        )
                         self.clean_access_token()
                         retries += 1
                         if retries >= self.MAX_RETRIES:
-                            logging.error("Max retries reached after token revocation")
+                            logging.error("Max retries reached after authentication/authorization failure")
                             raise
                         continue

@@ -6,7 +6,14 @@ from .enums import EnumChoices
 from .exceptions import S3Exception, custom_exception_handler
 from .external_errors import NamedCircuitBreakerError, handle_external_service_errors
 from .file_lock import FileLock
-from .http_helpers import raise_for_auth_errors, raise_for_status_codes
+from .fingerprint_helpers import (
+    compute_sha256,
+    format_value,
+    build_fingerprint_string,
+    format_id_list,
+    combine_fingerprints,
+)
+from .http_helpers import raise_for_auth_errors, raise_for_external_catch, raise_for_status_codes
 from .inject_job import inject_job
 from .pagination import LargeResultsSetPagination
 from .rate_utils import RateUtils

@@ -23,3 +23,6 @@ def raise_for_auth_errors(response):
         HTTPError: If status code is 401 or 403
     """
     raise_for_status_codes(response, (401, 403))
+def raise_for_external_catch(response):
+    response.raise_for_status()

@@ -76,6 +76,7 @@ src/base_api_utils/utils/enums.py
 src/base_api_utils/utils/exceptions.py
 src/base_api_utils/utils/external_errors.py
 src/base_api_utils/utils/file_lock.py
+src/base_api_utils/utils/fingerprint_helpers.py
 src/base_api_utils/utils/http_helpers.py
 src/base_api_utils/utils/inject_job.py
 src/base_api_utils/utils/oauth2_custom_schema_base.py

base-api-utils 1.1.76__tar.gz → 1.1.78__tar.gz

base-api-utils 1.1.76tar.gz → 1.1.78tar.gz