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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: valentina-python-client
-Version: 1.7.4
+Version: 1.8.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.8.0}/pyproject.toml

@@ -10,7 +10,10 @@
     name = "valentina-python-client"
     readme = "README.md"
     requires-python = ">=3.13"
-    version = "1.7.4"
+    version = "1.8.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.8.0}/src/vclient/__init__.py

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

{valentina_python_client-1.7.4 → valentina_python_client-1.8.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.8.0}/src/vclient/_sync/services/character_traits.py

@@ -137,14 +137,28 @@ 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:

valentina_python_client-1.8.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.8.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.8.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.8.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)

valentina_python_client-1.8.0/src/vclient/testing/_factories.py

@@ -0,0 +1,271 @@
+"""Polyfactory model factories for all vclient response models."""
+
+from polyfactory.factories.pydantic_factory import ModelFactory
+
+from vclient.models import (
+    Asset,
+    Campaign,
+    CampaignBook,
+    CampaignChapter,
+    Character,
+    CharacterConcept,
+    CharacterTrait,
+    CharacterTraitValueOptionsResponse,
+    Company,
+    CompanyPermissions,
+    Developer,
+    DeveloperWithApiKey,
+    Diceroll,
+    DictionaryTerm,
+    EdgeAndPerks,
+    HunterEdge,
+    HunterEdgePerk,
+    InventoryItem,
+    MeDeveloper,
+    MeDeveloperWithApiKey,
+    NewCompanyResponse,
+    Note,
+    Perk,
+    Quickroll,
+    RollStatistics,
+    SheetSection,
+    SystemHealth,
+    Trait,
+    TraitCategory,
+    User,
+    VampireClan,
+    WerewolfAuspice,
+    WerewolfGift,
+    WerewolfRite,
+    WerewolfTribe,
+)
+from vclient.models.character_autogen import ChargenSessionResponse
+from vclient.models.users import CampaignExperience
+
+
+class AssetFactory(ModelFactory[Asset]):
+    __model__ = Asset
+    __use_defaults__ = True
+
+
+class CampaignFactory(ModelFactory[Campaign]):
+    __model__ = Campaign
+    __use_defaults__ = True
+
+
+class CampaignBookFactory(ModelFactory[CampaignBook]):
+    __model__ = CampaignBook
+    __use_defaults__ = True
+
+
+class CampaignChapterFactory(ModelFactory[CampaignChapter]):
+    __model__ = CampaignChapter
+    __use_defaults__ = True
+
+
+class CampaignExperienceFactory(ModelFactory[CampaignExperience]):
+    __model__ = CampaignExperience
+    __use_defaults__ = True
+
+
+class CharacterFactory(ModelFactory[Character]):
+    __model__ = Character
+    __use_defaults__ = True
+
+
+class CharacterConceptFactory(ModelFactory[CharacterConcept]):
+    __model__ = CharacterConcept
+    __use_defaults__ = True
+
+
+class CharacterTraitFactory(ModelFactory[CharacterTrait]):
+    __model__ = CharacterTrait
+    __use_defaults__ = True
+
+
+class CharacterTraitValueOptionsResponseFactory(
+    ModelFactory[CharacterTraitValueOptionsResponse],
+):
+    __model__ = CharacterTraitValueOptionsResponse
+    __use_defaults__ = True
+
+
+class ChargenSessionResponseFactory(ModelFactory[ChargenSessionResponse]):
+    __model__ = ChargenSessionResponse
+    __use_defaults__ = True
+
+
+class CompanyFactory(ModelFactory[Company]):
+    __model__ = Company
+    __use_defaults__ = True
+
+
+class CompanyPermissionsFactory(ModelFactory[CompanyPermissions]):
+    __model__ = CompanyPermissions
+    __use_defaults__ = True
+
+
+class DeveloperFactory(ModelFactory[Developer]):
+    __model__ = Developer
+    __use_defaults__ = True
+
+
+class DeveloperWithApiKeyFactory(ModelFactory[DeveloperWithApiKey]):
+    __model__ = DeveloperWithApiKey
+    __use_defaults__ = True
+
+
+class DicerollFactory(ModelFactory[Diceroll]):
+    __model__ = Diceroll
+    __use_defaults__ = True
+
+
+class DictionaryTermFactory(ModelFactory[DictionaryTerm]):
+    __model__ = DictionaryTerm
+    __use_defaults__ = True
+
+
+class EdgeAndPerksFactory(ModelFactory[EdgeAndPerks]):
+    __model__ = EdgeAndPerks
+    __use_defaults__ = True
+
+
+class HunterEdgeFactory(ModelFactory[HunterEdge]):
+    __model__ = HunterEdge
+    __use_defaults__ = True
+
+
+class HunterEdgePerkFactory(ModelFactory[HunterEdgePerk]):
+    __model__ = HunterEdgePerk
+    __use_defaults__ = True
+
+
+class InventoryItemFactory(ModelFactory[InventoryItem]):
+    __model__ = InventoryItem
+    __use_defaults__ = True
+
+
+class MeDeveloperFactory(ModelFactory[MeDeveloper]):
+    __model__ = MeDeveloper
+    __use_defaults__ = True
+
+
+class MeDeveloperWithApiKeyFactory(ModelFactory[MeDeveloperWithApiKey]):
+    __model__ = MeDeveloperWithApiKey
+    __use_defaults__ = True
+
+
+class NewCompanyResponseFactory(ModelFactory[NewCompanyResponse]):
+    __model__ = NewCompanyResponse
+    __use_defaults__ = True
+
+
+class NoteFactory(ModelFactory[Note]):
+    __model__ = Note
+    __use_defaults__ = True
+
+
+class PerkFactory(ModelFactory[Perk]):
+    __model__ = Perk
+    __use_defaults__ = True
+
+
+class QuickrollFactory(ModelFactory[Quickroll]):
+    __model__ = Quickroll
+    __use_defaults__ = True
+
+
+class RollStatisticsFactory(ModelFactory[RollStatistics]):
+    __model__ = RollStatistics
+    __use_defaults__ = True
+
+
+class SheetSectionFactory(ModelFactory[SheetSection]):
+    __model__ = SheetSection
+    __use_defaults__ = True
+
+
+class SystemHealthFactory(ModelFactory[SystemHealth]):
+    __model__ = SystemHealth
+    __use_defaults__ = True
+
+
+class TraitCategoryFactory(ModelFactory[TraitCategory]):
+    __model__ = TraitCategory
+    __use_defaults__ = True
+
+
+class TraitFactory(ModelFactory[Trait]):
+    __model__ = Trait
+    __use_defaults__ = True
+
+
+class UserFactory(ModelFactory[User]):
+    __model__ = User
+    __use_defaults__ = True
+
+
+class VampireClanFactory(ModelFactory[VampireClan]):
+    __model__ = VampireClan
+    __use_defaults__ = True
+
+
+class WerewolfAuspiceFactory(ModelFactory[WerewolfAuspice]):
+    __model__ = WerewolfAuspice
+    __use_defaults__ = True
+
+
+class WerewolfGiftFactory(ModelFactory[WerewolfGift]):
+    __model__ = WerewolfGift
+    __use_defaults__ = True
+
+
+class WerewolfRiteFactory(ModelFactory[WerewolfRite]):
+    __model__ = WerewolfRite
+    __use_defaults__ = True
+
+
+class WerewolfTribeFactory(ModelFactory[WerewolfTribe]):
+    __model__ = WerewolfTribe
+    __use_defaults__ = True
+
+
+__all__ = [
+    "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",
+]