documente_shared 0.1.187__tar.gz → 0.1.188__tar.gz

documente_shared-0.1.188/.claude/commands/commit.md

@@ -0,0 +1,34 @@
+---
+allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
+argument-hint: [message]
+description: Create a git commit
+---
+
+## Context
+
+- Current git status: !`git status`
+- Current git diff: !`git diff HEAD`
+- Current branch: !`git branch --show-current`
+- Recent commits: !`git log --oneline -10`
+
+## Your task
+
+Based on the above changes, create a single git commit following the **Conventional Commits** specification.
+
+### Commit message format
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+```
+
+### Rules
+
+1. **type** must be one of: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
+2. **scope** is optional but recommended — use the domain or module affected (e.g., `auth`, `transactions`, `ui`)
+3. **description** must be lowercase, imperative mood, no period at the end
+4. Add a **body** only if the changes need further explanation
+5. If the argument `$ARGUMENTS` is provided, use it as guidance for the commit message
+6. Do not include any "Co-Authored-By" lines in the commit message
+7. Before committing, stage all modified, deleted, and untracked files that are part of the changes using `git add`. Include both tracked changes and new untracked files relevant to the work. Do NOT stage files that contain secrets (`.env`, credentials, etc.)

{documente_shared-0.1.187 → documente_shared-0.1.188}/Makefile

@@ -25,6 +25,20 @@ clean:
 	docker ps -aq | xargs docker stop
 	docker ps -aq | xargs docker rm
 
+lint:
+	uv run ruff check documente_shared tests
+
+lint_fix:
+	uv run ruff check --fix documente_shared tests
+
+format:
+	uv run ruff format documente_shared tests
+
+format_check:
+	uv run ruff format --check documente_shared tests
+
+check: lint format_check
+
 test:
 	$(COMPOSE_PACKAGE) bash -c "uv run pytest --pyargs $(ARG)"
 

{documente_shared-0.1.187 → documente_shared-0.1.188}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: documente_shared
-Version: 0.1.187
+Version: 0.1.188
 Summary: Shared utilities for LlamitAI projects
 Author-email: Tech <tech@llamitai.com>
 License: MIT
@@ -11,6 +11,7 @@ Requires-Dist: pydantic>=2.12.5
 Requires-Dist: requests>=2.32.5
 Requires-Dist: sentry-sdk>=2.52.0
 Requires-Dist: structlog>=25.5.0
+Requires-Dist: tenacity>=9.1.4
 Requires-Dist: unidecode>=1.4.0
 Description-Content-Type: text/markdown
 

documente_shared-0.1.188/documente_shared/application/digest.py

@@ -0,0 +1,7 @@
+import hashlib
+
+
+def get_file_digest(file_bytes: bytes) -> str:
+    sha256_hash = hashlib.sha256()
+    sha256_hash.update(file_bytes)
+    return sha256_hash.hexdigest()

{documente_shared-0.1.187 → documente_shared-0.1.188}/documente_shared/application/exceptions.py

@@ -4,13 +4,15 @@ from typing import Callable, Any, TypeVar
 
 F = TypeVar("F", bound=Callable[..., Any])
 
-def initialize_sentry(dsn: str, environment: str = 'dev') -> None:
-    if not sentry_sdk.Hub.current.client: 
+
+def initialize_sentry(dsn: str, environment: str = "dev") -> None:
+    if not sentry_sdk.Hub.current.client:
         sentry_sdk.init(
             dsn=dsn,
             environment=environment,
         )
 
+
 def track_exceptions(func: F) -> F:
     @wraps(func)
     def wrapper(*args: Any, **kwargs: Any) -> Any:
@@ -20,4 +22,5 @@ def track_exceptions(func: F) -> F:
             sentry_sdk.capture_exception(e)
             sentry_sdk.flush()
             raise
+
     return wrapper  # type: ignore

{documente_shared-0.1.187 → documente_shared-0.1.188}/documente_shared/application/files.py

@@ -7,7 +7,7 @@ def split_file_params(filepath: str) -> Tuple[str, str, str]:
     folder_path = path.dirname(filepath)
     filename = path.splitext(path.basename(filepath))[0]
     extension = path.splitext(filepath)[1]
-    extension = extension.replace('.', '')
+    extension = extension.replace(".", "")
     return folder_path, filename, extension
 
 
@@ -18,20 +18,22 @@ def get_filename_from_path(file_path: Optional[str]) -> Optional[str]:
 
 
 def remove_slash_from_path(file_path: str) -> str:
-    if file_path and file_path.startswith('/'):
+    if file_path and file_path.startswith("/"):
         return file_path[1:]
     return file_path
 
+
 def remove_extension(filename: str) -> str:
-    if filename and '.' in filename:
-        return filename.rsplit('.', 1)[0]
+    if filename and "." in filename:
+        return filename.rsplit(".", 1)[0]
     return filename
 
+
 def build_bucket_file_key(file_path: str) -> str:
     if not file_path:
-        return ''
+        return ""
     parsed = urlparse(file_path)
     if parsed.scheme and parsed.netloc:
-        return parsed.path.lstrip('/')
+        return parsed.path.lstrip("/")
 
     return remove_slash_from_path(file_path)

{documente_shared-0.1.187 → documente_shared-0.1.188}/documente_shared/application/json.py

@@ -32,8 +32,8 @@ def safe_format(data: Any) -> Any:
 
 
 def normalize_key(key: str) -> str:
-    normalized = unicodedata.normalize('NFC', key)
-    underscored = re.sub(r'\s+', '_', normalized)
+    normalized = unicodedata.normalize("NFC", key)
+    underscored = re.sub(r"\s+", "_", normalized)
     return underscored
 
 

{documente_shared-0.1.187 → documente_shared-0.1.188}/documente_shared/application/numbers.py

@@ -4,4 +4,4 @@ from decimal import Decimal
 def normalize_number(number: str | float | Decimal) -> str:
     if not isinstance(number, Decimal):
         number = Decimal(number)
-    return str(number.quantize(Decimal('0.001')))
+    return str(number.quantize(Decimal("0.001")))

{documente_shared-0.1.187 → documente_shared-0.1.188}/documente_shared/application/payloads.py

@@ -2,8 +2,9 @@ import re
 
 
 def camel_to_snake_key(name: str) -> str:
-    s1 = re.sub('(.)([A-Z][a-z]+)', r'\1_\2', name)
-    return re.sub('([a-z0-9])([A-Z])', r'\1_\2', s1).lower()
+    s1 = re.sub("(.)([A-Z][a-z]+)", r"\1_\2", name)
+    return re.sub("([a-z0-9])([A-Z])", r"\1_\2", s1).lower()
+
 
 def camel_to_snake(data: dict | list) -> dict | list:
     if isinstance(data, dict):
@@ -26,4 +27,3 @@ def snake_to_camel(data: dict | list) -> dict | list:
         return [snake_to_camel(item) for item in data]
     else:
         return data
-        

{documente_shared-0.1.187 → documente_shared-0.1.188}/documente_shared/application/query_params.py

@@ -6,7 +6,6 @@ from typing import List, Optional, Type, Union
 from uuid import UUID
 
 
-
 def camelize_string(value: str) -> str:
     if not value:
         return value

{documente_shared-0.1.187 → documente_shared-0.1.188}/documente_shared/application/retry_utils.py

@@ -2,6 +2,7 @@ import time
 import random
 from functools import wraps
 from typing import Optional, Callable
+
 import structlog
 
 logger = structlog.get_logger()
@@ -23,12 +24,12 @@ def retry_on_size_integrity(base_delay: float = 0.8, max_retries: int = 3):
                             file_key=file_key,
                         )
                         if attempt < max_retries - 1:
-                            delay = base_delay * (2 ** attempt) + random.uniform(0, base_delay)
+                            delay = base_delay * (2**attempt) + random.uniform(0, base_delay)
                             time.sleep(delay)
                             continue
                         raise RuntimeError(f"No se pudo obtener file_context para {file_key}")
 
-                    if 'Body' not in file_context:
+                    if "Body" not in file_context:
                         logger.warning(
                             "[shared.retry.body_not_found]",
                             attempt=attempt + 1,
@@ -36,19 +37,23 @@ def retry_on_size_integrity(base_delay: float = 0.8, max_retries: int = 3):
                             file_key=file_key,
                         )
                         if attempt < max_retries - 1:
-                            delay = base_delay * (2 ** attempt) + random.uniform(0, base_delay)
+                            delay = base_delay * (2**attempt) + random.uniform(0, base_delay)
                             time.sleep(delay)
                             continue
                         raise RuntimeError(f"'Body' no encontrado en file_context para {file_key}")
 
-                    expected_size = file_context.get('ContentLength', 0)
-                    body = file_context['Body'].read()
+                    expected_size = file_context.get("ContentLength", 0)
+                    body = file_context["Body"].read()
                     actual_size = len(body)
 
                     if expected_size == actual_size:
-                        file_context['Body'] = body
+                        file_context["Body"] = body
                         if attempt > 0:
-                            logger.info("[shared.retry.download_success]", file_key=file_key, attempts=attempt + 1)
+                            logger.info(
+                                "[shared.retry.download_success]",
+                                file_key=file_key,
+                                attempts=attempt + 1,
+                            )
                         return file_context
 
                     logger.warning(
@@ -61,7 +66,7 @@ def retry_on_size_integrity(base_delay: float = 0.8, max_retries: int = 3):
                     )
 
                     if attempt < max_retries - 1:
-                        delay = base_delay * (2 ** attempt) + random.uniform(0, base_delay)
+                        delay = base_delay * (2**attempt) + random.uniform(0, base_delay)
                         time.sleep(delay)
 
                 except Exception as e:
@@ -74,7 +79,7 @@ def retry_on_size_integrity(base_delay: float = 0.8, max_retries: int = 3):
                         error=str(e),
                     )
                     if attempt < max_retries - 1:
-                        delay = base_delay * (2 ** attempt) + random.uniform(0, base_delay)
+                        delay = base_delay * (2**attempt) + random.uniform(0, base_delay)
                         time.sleep(delay)
                         continue
                     raise
@@ -82,5 +87,7 @@ def retry_on_size_integrity(base_delay: float = 0.8, max_retries: int = 3):
             raise RuntimeError(
                 f"Descarga incompleta/inconsistente de S3 para {file_key} después de {max_retries} intentos"
             )
+
         return wrapper
+
     return decorator

{documente_shared-0.1.187 → documente_shared-0.1.188}/documente_shared/domain/base_enum.py

@@ -38,17 +38,17 @@ class BaseEnum(Enum):
         return [
             value
             for key, value in cls.__dict__.items()
-            if isinstance(value, str) and not key.startswith('__')
+            if isinstance(value, str) and not key.startswith("__")
         ]
 
     @classmethod
     def from_value(
         cls,
         value: Union[str, int],
-    ) -> Optional['BaseEnum']:
+    ) -> Optional["BaseEnum"]:
         for tag in cls:
             if isinstance(tag.value, str) and str(tag.value).upper() == str(value).upper():
                 return tag
             elif not isinstance(tag.value, str) and tag.value == value:
                 return tag
-        return None
+        return None

{documente_shared-0.1.187 → documente_shared-0.1.188}/documente_shared/domain/constants.py

@@ -7,4 +7,7 @@ la_paz_tz = ZoneInfo("America/La_Paz")
 DOCUMENTE_API_URL = environ.get("DOCUMENTE_API_URL")
 DOCUMENTE_API_KEY = environ.get("DOCUMENTE_API_KEY")
 
-DEFAULT_PAGINATION_PAGE_SIZE = 50
+DEFAULT_PAGINATION_PAGE_SIZE = 50
+
+HTTP_RETRY_TOTAL = 3
+HTTP_RETRY_BACKOFF_FACTOR = 0.5