valentina-python-client 1.7.4__tar.gz → 1.9.0__tar.gz

{valentina_python_client-1.7.4 → valentina_python_client-1.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: valentina-python-client
-Version: 1.7.4
+Version: 1.9.0
 Summary: Async Python client library for the Valentina Noir API
 Author: Nate Landau
 Author-email: Nate Landau <github@natenate.org>
@@ -19,9 +19,11 @@ Requires-Dist: anyio>=4.12.1
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: loguru>=0.7.3
 Requires-Dist: pydantic[email]>=2.12.5
+Requires-Dist: polyfactory>=2.21.0 ; extra == 'testing'
 Requires-Python: >=3.13
 Project-URL: Homepage, https://docs.valentina-noir.com/python-api-client/
 Project-URL: Repository, https://github.com/natelandau/valentina-python-client
+Provides-Extra: testing
 Description-Content-Type: text/markdown
 
 # Valentina Python Client

{valentina_python_client-1.7.4 → valentina_python_client-1.9.0}/pyproject.toml

@@ -10,7 +10,10 @@
     name = "valentina-python-client"
     readme = "README.md"
     requires-python = ">=3.13"
-    version = "1.7.4"
+    version = "1.9.0"
+
+    [project.optional-dependencies]
+        testing = ["polyfactory>=2.21.0"]
 
     [project.urls]
         Homepage   = "https://docs.valentina-noir.com/python-api-client/"
@@ -39,11 +42,11 @@
         "pytest-xdist>=3.8.0",
         "pytest>=9.0.2",
         "respx>=0.22.0",
-        "ruff>=0.15.4",
+        "ruff>=0.15.5",
         "shellcheck-py>=0.11.0.1",
-        "ty>=0.0.19",
+        "ty>=0.0.21",
         "typos>=1.44.0",
-        "vulture>=2.14",
+        "vulture>=2.15",
         "yamllint>=1.38.0",
     ]
     docs = ["zensical>=0.0.24"]

{valentina_python_client-1.7.4 → valentina_python_client-1.9.0}/src/vclient/__init__.py

@@ -105,4 +105,4 @@ __all__ = (
     "users_service",
 )
 
-__version__ = "1.7.4"
+__version__ = "1.9.0"

{valentina_python_client-1.7.4 → valentina_python_client-1.9.0}/src/vclient/_codegen.py

@@ -30,6 +30,7 @@ RENAME_CLASSES: dict[str, str] = {
     "SystemService": "SyncSystemService",
     "UsersService": "SyncUsersService",
     "VClient": "SyncVClient",
+    "FakeVClient": "SyncFakeVClient",
 }
 
 FACTORY_RENAMES: dict[str, str] = {
@@ -73,6 +74,7 @@ IMPORT_REWRITES: dict[str, str] = {
     "vclient.services.options": "vclient._sync.services.options",
     "vclient.services.character_autogen": "vclient._sync.services.character_autogen",
     "vclient.registry": "vclient._sync.registry",
+    "vclient.testing._client": "vclient._sync.testing._client",
 }
 
 # Combined lookup for renaming any identifier (class or factory function)
@@ -334,6 +336,22 @@ def _write_sync_init(path: Path) -> None:
     path.write_text("\n".join(lines))
 
 
+def _write_sync_testing_init(path: Path) -> None:
+    """Write the _sync/testing/__init__.py that re-exports public names.
+
+    Args:
+        path: Path to the ``_sync/testing/__init__.py`` file to write.
+    """
+    lines = [
+        HEADER_COMMENT,
+        "from vclient._sync.testing._client import SyncFakeVClient",
+        "",
+        '__all__ = ["SyncFakeVClient"]',
+        "",
+    ]
+    path.write_text("\n".join(lines))
+
+
 def generate_sync(src_dir: Path) -> None:
     """Transform all async source files and write them into the ``_sync/`` package.
 
@@ -362,6 +380,17 @@ def generate_sync(src_dir: Path) -> None:
     # Write the _sync/__init__.py
     _write_sync_init(sync_dir / "__init__.py")
 
+    # Transform testing module
+    testing_src = src_dir / "testing"
+    testing_dst = sync_dir / "testing"
+    if testing_src.exists():
+        testing_dst.mkdir(exist_ok=True)
+        client_source = testing_src / "_client.py"
+        if client_source.exists():
+            output_path = testing_dst / "_client.py"
+            output_path.write_text(transform_file(client_source))
+        _write_sync_testing_init(testing_dst / "__init__.py")
+
 
 if __name__ == "__main__":
     project_root = Path(sys.argv[1]) if len(sys.argv) > 1 else Path("src/vclient")

{valentina_python_client-1.7.4 → valentina_python_client-1.9.0}/src/vclient/_sync/services/character_traits.py

@@ -8,8 +8,8 @@ from vclient._sync.services.base import SyncBaseService
 from vclient.constants import DEFAULT_PAGE_LIMIT, TraitModifyCurrency
 from vclient.endpoints import Endpoints
 from vclient.models import (
-    CharacterCreateTraitAssign,
     CharacterTrait,
+    CharacterTraitAdd,
     CharacterTraitValueOptionsResponse,
     PaginatedResponse,
     TraitCreate,
@@ -137,22 +137,37 @@ class SyncCharacterTraitsService(SyncBaseService):
         )
         return CharacterTrait.model_validate(response.json())
 
-    def delete(self, character_trait_id: str) -> None:
+    def delete(self, character_trait_id: str, currency: TraitModifyCurrency | None = None) -> None:
         """Delete a character trait.
 
         Args:
             character_trait_id: The ID of the trait to delete.
+            currency: The currency to use to recoup the cost of the trait.
+
+        Returns:
+            None
+
+        Raises:
+            NotFoundError: If the trait does not exist.
+            AuthorizationError: If you don't have access to the character.
+            RequestValidationError: If the input parameters fail client-side validation.
+            ValidationError: If the request data is invalid.
         """
+        params: dict[str, str | int] = {}
+        if currency is not None:
+            params["currency"] = currency
         self._delete(
-            self._format_endpoint(Endpoints.CHARACTER_TRAIT, character_trait_id=character_trait_id)
+            self._format_endpoint(Endpoints.CHARACTER_TRAIT, character_trait_id=character_trait_id),
+            params=params or None,
         )
 
-    def assign(self, trait_id: str, value: int) -> CharacterTrait:
+    def assign(self, trait_id: str, value: int, currency: TraitModifyCurrency) -> CharacterTrait:
         """Assign a trait to a character.
 
         Args:
             trait_id: The ID of the trait to assign.
             value: The value of the trait to assign.
+            currency: The currency to use to pay for the trait.
 
         Returns:
             The newly assigned CharacterTrait object.
@@ -163,7 +178,9 @@ class SyncCharacterTraitsService(SyncBaseService):
             RequestValidationError: If the input parameters fail client-side validation.
             ValidationError: If the request data is invalid.
         """
-        body = self._validate_request(CharacterCreateTraitAssign, trait_id=trait_id, value=value)
+        body = self._validate_request(
+            CharacterTraitAdd, trait_id=trait_id, value=value, currency=currency
+        )
         response = self._post(
             self._format_endpoint(Endpoints.CHARACTER_TRAIT_ASSIGN),
             json=body.model_dump(exclude_none=True, exclude_unset=True, mode="json"),

valentina_python_client-1.9.0/src/vclient/_sync/testing/__init__.py

@@ -0,0 +1,5 @@
+# AUTO-GENERATED — do not edit. Run 'uv run duty generate_sync' to regenerate.
+
+from vclient._sync.testing._client import SyncFakeVClient
+
+__all__ = ["SyncFakeVClient"]

valentina_python_client-1.9.0/src/vclient/_sync/testing/_client.py

@@ -0,0 +1,70 @@
+# AUTO-GENERATED — do not edit. Run 'uv run duty generate_sync' to regenerate.
+"""Fake async API client for testing downstream applications.
+
+FakeSyncVClient is a drop-in replacement for SyncVClient that uses httpx.MockTransport
+instead of real HTTP. All real service classes work unmodified.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+
+from vclient._sync.client import SyncVClient
+from vclient.testing._router import _FakeRouter
+
+
+class SyncFakeVClient(SyncVClient):
+    """A fake SyncVClient for testing that uses mock HTTP transport.
+
+    Drop-in replacement for SyncVClient that returns auto-generated responses
+    for all endpoints. Registers itself as the default client so factory
+    functions like sync_campaigns_service() work without configuration.
+
+    Example:
+        ```python
+        from vclient.testing import FakeSyncVClient
+        from vclient import sync_campaigns_service
+
+        async with FakeSyncVClient() as client:
+            campaigns = sync_campaigns_service("user123")
+            result = await campaigns.list_all()
+        ```
+    """
+
+    def __init__(
+        self,
+        *,
+        default_company_id: str = "fake-company",
+        set_as_default: bool = True,
+        **kwargs: Any,
+    ) -> None:
+        self._router = _FakeRouter()
+        super().__init__(
+            base_url="https://fake.valentina-api.test",
+            api_key="fake-api-key",
+            default_company_id=default_company_id,
+            set_as_default=set_as_default,
+            **kwargs,
+        )
+
+    def _create_http_client(self) -> httpx.Client:
+        """Create an HTTP client backed by the fake router."""
+        return httpx.Client(
+            transport=httpx.MockTransport(self._router.handle),
+            base_url="https://fake.valentina-api.test",
+        )
+
+    def add_route(
+        self, method: str, pattern: str, *, json: dict[str, Any], status_code: int = 200
+    ) -> None:
+        """Add a custom route override.
+
+        Args:
+            method: HTTP method (GET, POST, PATCH, DELETE, PUT).
+            pattern: Endpoint pattern from vclient.endpoints.Endpoints.
+            json: The JSON response body to return.
+            status_code: HTTP status code to return (default 200).
+        """
+        self._router.add_route(method, pattern, json=json, status_code=status_code)

{valentina_python_client-1.7.4 → valentina_python_client-1.9.0}/src/vclient/models/__init__.py

@@ -36,6 +36,7 @@ from .character_blueprint import (
 from .character_trait import (
     CharacterCreateTraitAssign,
     CharacterTrait,
+    CharacterTraitAdd,
     CharacterTraitValueOptionsResponse,
     TraitCreate,
     _TraitModify as _TraitModify,
@@ -138,6 +139,7 @@ __all__ = [
     "CharacterHunterEdge",
     "CharacterSpecialty",
     "CharacterTrait",
+    "CharacterTraitAdd",
     "CharacterTraitValueOptionsResponse",
     "CharacterUpdate",
     "ChargenSessionFinalizeDTO",

{valentina_python_client-1.7.4 → valentina_python_client-1.9.0}/src/vclient/models/character_trait.py

@@ -25,6 +25,14 @@ class CharacterCreateTraitAssign(BaseModel):
     value: int
 
 
+class CharacterTraitAdd(BaseModel):
+    """Request model for adding a character trait to an already created character."""
+
+    trait_id: str
+    value: int
+    currency: TraitModifyCurrency
+
+
 class TraitCreate(BaseModel):
     """Request model for creating a character trait.
 

{valentina_python_client-1.7.4 → valentina_python_client-1.9.0}/src/vclient/services/character_traits.py

@@ -6,8 +6,8 @@ from typing import TYPE_CHECKING
 from vclient.constants import DEFAULT_PAGE_LIMIT, TraitModifyCurrency
 from vclient.endpoints import Endpoints
 from vclient.models import (
-    CharacterCreateTraitAssign,
     CharacterTrait,
+    CharacterTraitAdd,
     CharacterTraitValueOptionsResponse,
     PaginatedResponse,
     TraitCreate,
@@ -173,12 +173,15 @@ class CharacterTraitsService(BaseService):
             params=params or None,
         )
 
-    async def assign(self, trait_id: str, value: int) -> CharacterTrait:
+    async def assign(
+        self, trait_id: str, value: int, currency: TraitModifyCurrency
+    ) -> CharacterTrait:
         """Assign a trait to a character.
 
         Args:
             trait_id: The ID of the trait to assign.
             value: The value of the trait to assign.
+            currency: The currency to use to pay for the trait.
 
         Returns:
             The newly assigned CharacterTrait object.
@@ -190,9 +193,10 @@ class CharacterTraitsService(BaseService):
             ValidationError: If the request data is invalid.
         """
         body = self._validate_request(
-            CharacterCreateTraitAssign,
+            CharacterTraitAdd,
             trait_id=trait_id,
             value=value,
+            currency=currency,
         )
         response = await self._post(
             self._format_endpoint(Endpoints.CHARACTER_TRAIT_ASSIGN),

valentina_python_client-1.9.0/src/vclient/testing/__init__.py

@@ -0,0 +1,97 @@
+"""Testing utilities for downstream applications using vclient.
+
+Requires the 'testing' extra: pip install vclient[testing]
+"""
+
+try:
+    import polyfactory  # noqa: F401
+except ImportError as e:
+    msg = (
+        "vclient.testing requires the 'testing' extra. "
+        "Install it with: pip install vclient[testing]"
+    )
+    raise ImportError(msg) from e
+
+from vclient._sync.testing import SyncFakeVClient
+from vclient.testing._client import FakeVClient
+from vclient.testing._factories import (
+    AssetFactory,
+    CampaignBookFactory,
+    CampaignChapterFactory,
+    CampaignExperienceFactory,
+    CampaignFactory,
+    CharacterConceptFactory,
+    CharacterFactory,
+    CharacterTraitFactory,
+    CharacterTraitValueOptionsResponseFactory,
+    ChargenSessionResponseFactory,
+    CompanyFactory,
+    CompanyPermissionsFactory,
+    DeveloperFactory,
+    DeveloperWithApiKeyFactory,
+    DicerollFactory,
+    DictionaryTermFactory,
+    EdgeAndPerksFactory,
+    HunterEdgeFactory,
+    HunterEdgePerkFactory,
+    InventoryItemFactory,
+    MeDeveloperFactory,
+    MeDeveloperWithApiKeyFactory,
+    NewCompanyResponseFactory,
+    NoteFactory,
+    PerkFactory,
+    QuickrollFactory,
+    RollStatisticsFactory,
+    SheetSectionFactory,
+    SystemHealthFactory,
+    TraitCategoryFactory,
+    TraitFactory,
+    UserFactory,
+    VampireClanFactory,
+    WerewolfAuspiceFactory,
+    WerewolfGiftFactory,
+    WerewolfRiteFactory,
+    WerewolfTribeFactory,
+)
+
+__all__ = [
+    "AssetFactory",
+    "CampaignBookFactory",
+    "CampaignChapterFactory",
+    "CampaignExperienceFactory",
+    "CampaignFactory",
+    "CharacterConceptFactory",
+    "CharacterFactory",
+    "CharacterTraitFactory",
+    "CharacterTraitValueOptionsResponseFactory",
+    "ChargenSessionResponseFactory",
+    "CompanyFactory",
+    "CompanyPermissionsFactory",
+    "DeveloperFactory",
+    "DeveloperWithApiKeyFactory",
+    "DicerollFactory",
+    "DictionaryTermFactory",
+    "EdgeAndPerksFactory",
+    "FakeVClient",
+    "HunterEdgeFactory",
+    "HunterEdgePerkFactory",
+    "InventoryItemFactory",
+    "MeDeveloperFactory",
+    "MeDeveloperWithApiKeyFactory",
+    "NewCompanyResponseFactory",
+    "NoteFactory",
+    "PerkFactory",
+    "QuickrollFactory",
+    "RollStatisticsFactory",
+    "SheetSectionFactory",
+    "SyncFakeVClient",
+    "SystemHealthFactory",
+    "TraitCategoryFactory",
+    "TraitFactory",
+    "UserFactory",
+    "VampireClanFactory",
+    "WerewolfAuspiceFactory",
+    "WerewolfGiftFactory",
+    "WerewolfRiteFactory",
+    "WerewolfTribeFactory",
+]

valentina_python_client-1.9.0/src/vclient/testing/_client.py

@@ -0,0 +1,74 @@
+"""Fake async API client for testing downstream applications.
+
+FakeVClient is a drop-in replacement for VClient that uses httpx.MockTransport
+instead of real HTTP. All real service classes work unmodified.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+
+from vclient.client import VClient
+from vclient.testing._router import _FakeRouter
+
+
+class FakeVClient(VClient):
+    """A fake VClient for testing that uses mock HTTP transport.
+
+    Drop-in replacement for VClient that returns auto-generated responses
+    for all endpoints. Registers itself as the default client so factory
+    functions like campaigns_service() work without configuration.
+
+    Example:
+        ```python
+        from vclient.testing import FakeVClient
+        from vclient import campaigns_service
+
+        async with FakeVClient() as client:
+            campaigns = campaigns_service("user123")
+            result = await campaigns.list_all()
+        ```
+    """
+
+    def __init__(
+        self,
+        *,
+        default_company_id: str = "fake-company",
+        set_as_default: bool = True,
+        **kwargs: Any,
+    ) -> None:
+        self._router = _FakeRouter()
+        super().__init__(
+            base_url="https://fake.valentina-api.test",
+            api_key="fake-api-key",
+            default_company_id=default_company_id,
+            set_as_default=set_as_default,
+            **kwargs,
+        )
+
+    def _create_http_client(self) -> httpx.AsyncClient:
+        """Create an HTTP client backed by the fake router."""
+        return httpx.AsyncClient(
+            transport=httpx.MockTransport(self._router.handle),
+            base_url="https://fake.valentina-api.test",
+        )
+
+    def add_route(
+        self,
+        method: str,
+        pattern: str,
+        *,
+        json: dict[str, Any],
+        status_code: int = 200,
+    ) -> None:
+        """Add a custom route override.
+
+        Args:
+            method: HTTP method (GET, POST, PATCH, DELETE, PUT).
+            pattern: Endpoint pattern from vclient.endpoints.Endpoints.
+            json: The JSON response body to return.
+            status_code: HTTP status code to return (default 200).
+        """
+        self._router.add_route(method, pattern, json=json, status_code=status_code)