valentina-python-client 1.3.0__tar.gz → 1.3.1__tar.gz

{valentina_python_client-1.3.0 → valentina_python_client-1.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: valentina-python-client
-Version: 1.3.0
+Version: 1.3.1
 Summary: Async Python client library for the Valentina Noir API
 Author: Nate Landau
 Author-email: Nate Landau <github@natenate.org>
@@ -30,13 +30,13 @@ Async Python client library for accessing the Valentina Noir API.
 
 ## Features
 
--   **Async-first design** - Built on httpx for efficient async HTTP operations
--   **Type-safe** - Full type hints with Pydantic models for request/response validation
--   **Convenient factory pattern** - Create a client once, access services from anywhere
--   **Automatic pagination** - Stream through large datasets with `iter_all()` or fetch everything with `list_all()`
--   **Robust error handling** - Specific exception types for different error conditions
--   **Idempotency support** - Optional automatic idempotency keys for safe retries
--   **Rate limit handling** - Built-in support for automatic rate limit retries
+- **Async-first design** - Built on httpx for efficient async HTTP operations
+- **Type-safe** - Full type hints with Pydantic models for request/response validation
+- **Convenient factory pattern** - Create a client once, access services from anywhere
+- **Automatic pagination** - Stream through large datasets with `iter_all()` or fetch everything with `list_all()`
+- **Robust error handling** - Specific exception types for different error conditions
+- **Idempotency support** - Optional automatic idempotency keys for safe retries
+- **Rate limit handling** - Built-in support for automatic rate limit retries
 
 This client is a supported and up-to-date reference implementation for the Valentina Noir API. The full documentation for is available at https://docs.valentina-noir.com/python-api-client/.
 
@@ -62,12 +62,12 @@ The script reads configuration from (highest precedence first):
 
 1. CLI arguments (`--api-url`, `--api-key`, `--company-id`)
 2. System environment variables (`VALENTINA_CLIENT_BASE_URL`, `VALENTINA_CLIENT_API_KEY`, `VALENTINA_CLIENT_DEFAULT_COMPANY_ID`)
-3. A `.env.secrets` file in the project root
+3. A `.env.secret` file in the project root
 
 Exit codes: `0` = all constants match, `1` = mismatches found, `2` = missing configuration.
 
 ## Resources
 
--   [Full Client Documentation](https://docs.valentina-noir.com/python-api-client/)
--   [API Concepts](https://docs.valentina-noir.com/concepts/)
--   [API Reference](https://api.valentina-noir.com/docs)
+- [Full Client Documentation](https://docs.valentina-noir.com/python-api-client/)
+- [API Concepts](https://docs.valentina-noir.com/concepts/)
+- [API Reference](https://api.valentina-noir.com/docs)

{valentina_python_client-1.3.0 → valentina_python_client-1.3.1}/README.md

@@ -4,13 +4,13 @@ Async Python client library for accessing the Valentina Noir API.
 
 ## Features
 
--   **Async-first design** - Built on httpx for efficient async HTTP operations
--   **Type-safe** - Full type hints with Pydantic models for request/response validation
--   **Convenient factory pattern** - Create a client once, access services from anywhere
--   **Automatic pagination** - Stream through large datasets with `iter_all()` or fetch everything with `list_all()`
--   **Robust error handling** - Specific exception types for different error conditions
--   **Idempotency support** - Optional automatic idempotency keys for safe retries
--   **Rate limit handling** - Built-in support for automatic rate limit retries
+- **Async-first design** - Built on httpx for efficient async HTTP operations
+- **Type-safe** - Full type hints with Pydantic models for request/response validation
+- **Convenient factory pattern** - Create a client once, access services from anywhere
+- **Automatic pagination** - Stream through large datasets with `iter_all()` or fetch everything with `list_all()`
+- **Robust error handling** - Specific exception types for different error conditions
+- **Idempotency support** - Optional automatic idempotency keys for safe retries
+- **Rate limit handling** - Built-in support for automatic rate limit retries
 
 This client is a supported and up-to-date reference implementation for the Valentina Noir API. The full documentation for is available at https://docs.valentina-noir.com/python-api-client/.
 
@@ -36,12 +36,12 @@ The script reads configuration from (highest precedence first):
 
 1. CLI arguments (`--api-url`, `--api-key`, `--company-id`)
 2. System environment variables (`VALENTINA_CLIENT_BASE_URL`, `VALENTINA_CLIENT_API_KEY`, `VALENTINA_CLIENT_DEFAULT_COMPANY_ID`)
-3. A `.env.secrets` file in the project root
+3. A `.env.secret` file in the project root
 
 Exit codes: `0` = all constants match, `1` = mismatches found, `2` = missing configuration.
 
 ## Resources
 
--   [Full Client Documentation](https://docs.valentina-noir.com/python-api-client/)
--   [API Concepts](https://docs.valentina-noir.com/concepts/)
--   [API Reference](https://api.valentina-noir.com/docs)
+- [Full Client Documentation](https://docs.valentina-noir.com/python-api-client/)
+- [API Concepts](https://docs.valentina-noir.com/concepts/)
+- [API Reference](https://api.valentina-noir.com/docs)

{valentina_python_client-1.3.0 → valentina_python_client-1.3.1}/pyproject.toml

@@ -10,7 +10,7 @@
     name = "valentina-python-client"
     readme = "README.md"
     requires-python = ">=3.13"
-    version = "1.3.0"
+    version = "1.3.1"
 
     [project.urls]
         Homepage   = "https://docs.valentina-noir.com/python-api-client/"
@@ -80,26 +80,6 @@
 [tool.coverage.xml]
     output = ".cache/coverage.xml"
 
-[tool.mypy] # https://mypy.readthedocs.io/en/latest/config_file.html
-    cache_dir                   = ".cache/mypy"
-    disallow_any_unimported     = false
-    disallow_subclassing_any    = false
-    disallow_untyped_decorators = false
-    disallow_untyped_defs       = true
-    exclude                     = ['duties.py', 'tests/']
-    follow_imports              = "normal"
-    ignore_missing_imports      = true
-    junit_xml                   = ".cache/mypy.xml"
-    no_implicit_optional        = true
-    pretty                      = false
-    show_column_numbers         = true
-    show_error_codes            = true
-    show_error_context          = true
-    strict_optional             = false
-    warn_redundant_casts        = true
-    warn_unreachable            = true
-    warn_unused_ignores         = true
-
 [tool.pytest.ini_options]
 
     addopts        = "--color=yes --doctest-modules --strict-config --strict-markers -n auto --dist loadfile"

{valentina_python_client-1.3.0 → valentina_python_client-1.3.1}/src/vclient/__init__.py

@@ -71,4 +71,4 @@ __all__ = (
     "users_service",
 )
 
-__version__ = "1.3.0"
+__version__ = "1.3.1"

{valentina_python_client-1.3.0 → valentina_python_client-1.3.1}/src/vclient/client.py

@@ -160,10 +160,7 @@ class VClient:
             base_url=self._config.base_url,
             timeout=self._config.timeout,
             max_retries=self._config.max_retries,
-        ).debug(
-            "Initialize VClient (base_url={base_url})",
-            base_url=self._config.base_url,
-        )
+        ).info("Initialize VClient")
 
     def _create_http_client(self) -> httpx.AsyncClient:
         """Create and configure the HTTP client."""
@@ -204,7 +201,7 @@ class VClient:
         """Close the HTTP client and release resources."""
         from vclient.registry import clear_default_client
 
-        logger.bind(base_url=self._config.base_url).debug("Close VClient")
+        logger.bind(base_url=self._config.base_url).info("Close VClient")
         await self._http.aclose()
         clear_default_client(self)
 

{valentina_python_client-1.3.0 → valentina_python_client-1.3.1}/src/vclient/models/campaigns.py

@@ -1,6 +1,7 @@
 """Pydantic models for Campaign API responses and requests."""
 
 from datetime import datetime
+from typing import Annotated
 
 from pydantic import BaseModel, Field
 
@@ -39,7 +40,7 @@ class CampaignCreate(BaseModel):
     """
 
     name: str = Field(min_length=3, max_length=50)
-    description: str | None = Field(default=None, min_length=3)
+    description: Annotated[str, Field(min_length=3)] | None = None
     desperation: int = Field(default=0, ge=0, le=5)
     danger: int = Field(default=0, ge=0, le=5)
 
@@ -50,10 +51,10 @@ class CampaignUpdate(BaseModel):
     Only include fields that need to be changed; omitted fields remain unchanged.
     """
 
-    name: str | None = Field(default=None, min_length=3, max_length=50)
-    description: str | None = Field(default=None, min_length=3)
-    desperation: int | None = Field(default=None, ge=0, le=5)
-    danger: int | None = Field(default=None, ge=0, le=5)
+    name: Annotated[str, Field(min_length=3, max_length=50)] | None = None
+    description: Annotated[str, Field(min_length=3)] | None = None
+    desperation: Annotated[int, Field(ge=0, le=5)] | None = None
+    danger: Annotated[int, Field(ge=0, le=5)] | None = None
 
 
 __all__ = [

{valentina_python_client-1.3.0 → valentina_python_client-1.3.1}/src/vclient/models/characters.py

@@ -1,6 +1,7 @@
 """Pydantic models for Character API responses and requests."""
 
 from datetime import datetime
+from typing import Annotated
 
 from pydantic import BaseModel, Field
 
@@ -155,20 +156,22 @@ class Character(BaseModel):
     # Identity
     name_first: str = Field(..., min_length=3, description="Character's first name.")
     name_last: str = Field(..., min_length=3, description="Character's last name.")
-    name_nick: str | None = Field(
-        default=None, min_length=3, max_length=50, description="Character's nickname."
+    name_nick: Annotated[str, Field(min_length=3, max_length=50)] | None = Field(
+        default=None, description="Character's nickname."
     )
     name: str = Field(..., description="Character's display name.")
     name_full: str = Field(..., description="Character's full name.")
 
     # Biography
     age: int | None = Field(default=None, description="Character's age.")
-    biography: str | None = Field(default=None, min_length=3, description="Character biography.")
-    demeanor: str | None = Field(
-        default=None, min_length=3, max_length=50, description="Character's demeanor."
+    biography: Annotated[str, Field(min_length=3)] | None = Field(
+        default=None, description="Character biography."
     )
-    nature: str | None = Field(
-        default=None, min_length=3, max_length=50, description="Character's nature."
+    demeanor: Annotated[str, Field(min_length=3, max_length=50)] | None = Field(
+        default=None, description="Character's demeanor."
+    )
+    nature: Annotated[str, Field(min_length=3, max_length=50)] | None = Field(
+        default=None, description="Character's nature."
     )
     concept_id: str | None = Field(default=None, description="ID of the character concept.")
 
@@ -220,16 +223,18 @@ class CharacterCreate(BaseModel):
 
     # Optional fields
     type: CharacterType | None = Field(default=None, description="Character type.")
-    name_nick: str | None = Field(
-        default=None, min_length=3, max_length=50, description="Character's nickname."
+    name_nick: Annotated[str, Field(min_length=3, max_length=50)] | None = Field(
+        default=None, description="Character's nickname."
     )
     age: int | None = Field(default=None, description="Character's age.")
-    biography: str | None = Field(default=None, min_length=3, description="Character biography.")
-    demeanor: str | None = Field(
-        default=None, min_length=3, max_length=50, description="Character's demeanor."
+    biography: Annotated[str, Field(min_length=3)] | None = Field(
+        default=None, description="Character biography."
+    )
+    demeanor: Annotated[str, Field(min_length=3, max_length=50)] | None = Field(
+        default=None, description="Character's demeanor."
     )
-    nature: str | None = Field(
-        default=None, min_length=3, max_length=50, description="Character's nature."
+    nature: Annotated[str, Field(min_length=3, max_length=50)] | None = Field(
+        default=None, description="Character's nature."
     )
     concept_id: str | None = Field(default=None, description="ID of the character concept.")
     user_player_id: str | None = Field(
@@ -263,21 +268,25 @@ class CharacterUpdate(BaseModel):
     game_version: GameVersion | None = None
     status: CharacterStatus | None = None
 
-    name_first: str | None = Field(
-        default=None, min_length=3, description="Character's first name."
+    name_first: Annotated[str, Field(min_length=3)] | None = Field(
+        default=None, description="Character's first name."
     )
-    name_last: str | None = Field(default=None, min_length=3, description="Character's last name.")
-    name_nick: str | None = Field(
-        default=None, min_length=3, max_length=50, description="Character's nickname."
+    name_last: Annotated[str, Field(min_length=3)] | None = Field(
+        default=None, description="Character's last name."
+    )
+    name_nick: Annotated[str, Field(min_length=3, max_length=50)] | None = Field(
+        default=None, description="Character's nickname."
     )
 
     age: int | None = None
-    biography: str | None = Field(default=None, min_length=3, description="Character biography.")
-    demeanor: str | None = Field(
-        default=None, min_length=3, max_length=50, description="Character's demeanor."
+    biography: Annotated[str, Field(min_length=3)] | None = Field(
+        default=None, description="Character biography."
+    )
+    demeanor: Annotated[str, Field(min_length=3, max_length=50)] | None = Field(
+        default=None, description="Character's demeanor."
     )
-    nature: str | None = Field(
-        default=None, min_length=3, max_length=50, description="Character's nature."
+    nature: Annotated[str, Field(min_length=3, max_length=50)] | None = Field(
+        default=None, description="Character's nature."
     )
     concept_id: str | None = Field(default=None, description="ID of the character concept.")
 

{valentina_python_client-1.3.0 → valentina_python_client-1.3.1}/src/vclient/models/companies.py

@@ -1,6 +1,7 @@
 """Pydantic models for Company API responses."""
 
 from datetime import datetime
+from typing import Annotated
 
 from pydantic import BaseModel, Field
 
@@ -77,7 +78,7 @@ class CompanyCreate(BaseModel):
 
     name: str = Field(min_length=3, max_length=50)
     email: str
-    description: str | None = Field(default=None, min_length=3)
+    description: Annotated[str, Field(min_length=3)] | None = None
     settings: CompanySettings | None = None
 
 
@@ -87,9 +88,9 @@ class CompanyUpdate(BaseModel):
     Only include fields that need to be changed; omitted fields remain unchanged.
     """
 
-    name: str | None = Field(default=None, min_length=3, max_length=50)
+    name: Annotated[str, Field(min_length=3, max_length=50)] | None = None
     email: str | None = None
-    description: str | None = Field(default=None, min_length=3)
+    description: Annotated[str, Field(min_length=3)] | None = None
     settings: CompanySettings | None = None
 
 

{valentina_python_client-1.3.0 → valentina_python_client-1.3.1}/src/vclient/models/shared.py

@@ -1,7 +1,7 @@
 """Shared Pydantic models used across multiple services."""
 
 from datetime import datetime
-from typing import Any
+from typing import Annotated, Any
 
 from pydantic import BaseModel, Field
 
@@ -84,8 +84,8 @@ class NoteUpdate(BaseModel):
     Only include fields that need to be changed; omitted fields remain unchanged.
     """
 
-    title: str | None = Field(default=None, min_length=3, max_length=50)
-    content: str | None = Field(default=None, min_length=3)
+    title: Annotated[str, Field(min_length=3, max_length=50)] | None = None
+    content: Annotated[str, Field(min_length=3)] | None = None
 
 
 # -----------------------------------------------------------------------------

{valentina_python_client-1.3.0 → valentina_python_client-1.3.1}/src/vclient/models/users.py

@@ -1,6 +1,7 @@
 """Pydantic models for User API responses and requests."""
 
 from datetime import datetime
+from typing import Annotated
 
 from pydantic import BaseModel, Field
 
@@ -89,7 +90,7 @@ class UserUpdate(BaseModel):
     Only include fields that need to be changed; omitted fields remain unchanged.
     """
 
-    name: str | None = Field(default=None, min_length=3, max_length=50)
+    name: Annotated[str, Field(min_length=3, max_length=50)] | None = None
     email: str | None = None
     role: UserRole | None = None
     discord_profile: DiscordProfile | None = None
@@ -124,7 +125,7 @@ class QuickrollCreate(BaseModel):
     """
 
     name: str = Field(min_length=3, max_length=50)
-    description: str | None = Field(default=None, min_length=3)
+    description: Annotated[str, Field(min_length=3)] | None = None
     trait_ids: list[str] = Field(default_factory=list)
 
 
@@ -134,8 +135,8 @@ class QuickrollUpdate(BaseModel):
     Only include fields that need to be changed; omitted fields remain unchanged.
     """
 
-    name: str | None = Field(default=None, min_length=3, max_length=50)
-    description: str | None = Field(default=None, min_length=3)
+    name: Annotated[str, Field(min_length=3, max_length=50)] | None = None
+    description: Annotated[str, Field(min_length=3)] | None = None
     trait_ids: list[str] | None = None
 
 

{valentina_python_client-1.3.0 → valentina_python_client-1.3.1}/src/vclient/services/base.py

@@ -173,7 +173,7 @@ class BaseService:
         retry_statuses = config.retry_statuses
         request_logger = logger.bind(method=method, url=path)
 
-        request_logger.debug("Send {method} {url}", method=method, url=path)
+        request_logger.debug("Send request")
 
         last_error: RateLimitError | ServerError | None = None
 
@@ -199,14 +199,7 @@ class BaseService:
                     attempt=attempt + 1,
                     max_attempts=max_attempts,
                     delay=delay,
-                ).warning(
-                    "Retry {method} {url} after {error_type} (attempt {attempt}/{max_attempts})",
-                    method=method,
-                    url=path,
-                    error_type=error_type,
-                    attempt=attempt + 1,
-                    max_attempts=max_attempts,
-                )
+                ).warning("Retry after network error")
                 await asyncio.sleep(delay)
                 continue
 
@@ -217,13 +210,7 @@ class BaseService:
                 request_logger.bind(
                     status=response.status_code,
                     elapsed_ms=elapsed_ms,
-                ).debug(
-                    "Receive {status} from {method} {url} ({elapsed_ms}ms)",
-                    status=response.status_code,
-                    method=method,
-                    url=path,
-                    elapsed_ms=f"{elapsed_ms:.0f}",
-                )
+                ).debug("Receive response")
                 return response  # noqa: TRY300
             except RateLimitError as e:
                 last_error = e
@@ -236,14 +223,7 @@ class BaseService:
                     attempt=attempt + 1,
                     max_attempts=max_attempts,
                     delay=delay,
-                ).warning(
-                    "Retry {method} {url} after rate limit (attempt {attempt}/{max_attempts}, delay {delay}s)",
-                    method=method,
-                    url=path,
-                    attempt=attempt + 1,
-                    max_attempts=max_attempts,
-                    delay=f"{delay:.1f}",
-                )
+                ).warning("Retry after rate limit")
                 await asyncio.sleep(delay)
             except ServerError as e:
                 if e.status_code not in retry_statuses or not self._is_retryable_method(
@@ -262,24 +242,11 @@ class BaseService:
                     attempt=attempt + 1,
                     max_attempts=max_attempts,
                     delay=delay,
-                ).warning(
-                    "Retry {method} {url} after {status} error (attempt {attempt}/{max_attempts}, delay {delay}s)",
-                    method=method,
-                    url=path,
-                    status=e.status_code,
-                    attempt=attempt + 1,
-                    max_attempts=max_attempts,
-                    delay=f"{delay:.1f}",
-                )
+                ).warning("Retry after server error")
                 await asyncio.sleep(delay)
 
         if last_error is not None:
-            request_logger.bind(attempts=max_attempts).error(
-                "Exhaust retries for {method} {url} after {attempts} attempts",
-                method=method,
-                url=path,
-                attempts=max_attempts,
-            )
+            request_logger.bind(attempts=max_attempts).error("Exhaust retries")
             raise last_error
 
         msg = "Unexpected state: no response or error"
@@ -324,45 +291,23 @@ class BaseService:
             )
 
         if status_code == 401:  # noqa: PLR2004
-            error_logger.error(
-                "Fail authentication for {method} {url} ({status})",
-                method=method,
-                url=url,
-                status=status_code,
-            )
+            error_logger.error("Fail authentication")
             raise AuthenticationError(message, status_code, response_data)
 
         if status_code == 403:  # noqa: PLR2004
-            error_logger.error(
-                "Deny authorization for {method} {url} ({status})",
-                method=method,
-                url=url,
-                status=status_code,
-            )
+            error_logger.error("Deny authorization")
             raise AuthorizationError(message, status_code, response_data)
 
         if status_code == 404:  # noqa: PLR2004
-            error_logger.debug(
-                "Return 404 for {method} {url}",
-                method=method,
-                url=url,
-            )
+            error_logger.debug("Return 404")
             raise NotFoundError(message, status_code, response_data)
 
         if status_code == 400:  # noqa: PLR2004
-            error_logger.warning(
-                "Reject {method} {url} with validation error",
-                method=method,
-                url=url,
-            )
+            error_logger.warning("Reject with validation error")
             raise ValidationError(message, status_code, response_data)
 
         if status_code == 409:  # noqa: PLR2004
-            error_logger.warning(
-                "Return 409 conflict for {method} {url}",
-                method=method,
-                url=url,
-            )
+            error_logger.warning("Return 409 conflict")
             raise ConflictError(message, status_code, response_data)
 
         if HTTP_500_INTERNAL_SERVER_ERROR <= status_code < HTTP_600_UPPER_BOUND: