valentina-python-client 1.0.2__tar.gz → 1.1.0__tar.gz

{valentina_python_client-1.0.2 → valentina_python_client-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: valentina-python-client
-Version: 1.0.2
+Version: 1.1.0
 Summary: Async Python client library for the Valentina Noir API
 Author: Nate Landau
 Author-email: Nate Landau <github@natenate.org>

{valentina_python_client-1.0.2 → valentina_python_client-1.1.0}/pyproject.toml

@@ -10,7 +10,7 @@
     name = "valentina-python-client"
     readme = "README.md"
     requires-python = ">=3.13"
-    version = "1.0.2"
+    version = "1.1.0"
 
     [project.urls]
         Homepage   = "https://docs.valentina-noir.com/python-api-client/"

{valentina_python_client-1.0.2 → valentina_python_client-1.1.0}/src/vclient/services/character_blueprint.py

@@ -3,7 +3,13 @@
 from collections.abc import AsyncIterator
 from typing import TYPE_CHECKING
 
-from vclient.constants import DEFAULT_PAGE_LIMIT, BlueprintTraitOrderBy, CharacterClass, GameVersion
+from vclient.constants import (
+    DEFAULT_PAGE_LIMIT,
+    BlueprintTraitOrderBy,
+    CharacterClass,
+    GameVersion,
+    HunterEdgeType,
+)
 from vclient.endpoints import Endpoints
 from vclient.models import (
     CharacterConcept,
@@ -63,7 +69,7 @@ class CharacterBlueprintService(BaseService):
             SheetSection,
             limit=limit,
             offset=offset,
-            params={"character_class": character_class} if character_class else None,
+            params=self._build_params(character_class=character_class),
         )
 
     async def list_all_sections(
@@ -83,7 +89,7 @@ class CharacterBlueprintService(BaseService):
         """Iterate through all character blueprint sections."""
         async for section in self._iter_all_pages(
             self._format_endpoint(Endpoints.BLUEPRINT_SECTIONS, game_version=game_version),
-            params={"character_class": character_class} if character_class else None,
+            params=self._build_params(character_class=character_class),
         ):
             yield SheetSection.model_validate(section)
 
@@ -118,7 +124,7 @@ class CharacterBlueprintService(BaseService):
             TraitCategory,
             limit=limit,
             offset=offset,
-            params={"character_class": character_class} if character_class else None,
+            params=self._build_params(character_class=character_class),
         )
 
     async def list_all_categories(
@@ -150,7 +156,7 @@ class CharacterBlueprintService(BaseService):
             self._format_endpoint(
                 Endpoints.BLUEPRINT_CATEGORIES, game_version=game_version, section_id=section_id
             ),
-            params={"character_class": character_class} if character_class else None,
+            params=self._build_params(character_class=character_class),
         ):
             yield TraitCategory.model_validate(category)
 
@@ -184,12 +190,6 @@ class CharacterBlueprintService(BaseService):
         character_id: str | None = None,
     ) -> PaginatedResponse[Trait]:
         """Get a paginated page of character blueprint category traits."""
-        params: dict[str, str | int] = {}
-        if character_class is not None:
-            params["character_class"] = character_class
-        if character_id is not None:
-            params["character_id"] = character_id
-
         return await self._get_paginated_as(
             self._format_endpoint(
                 Endpoints.BLUEPRINT_CATEGORY_TRAITS,
@@ -200,7 +200,7 @@ class CharacterBlueprintService(BaseService):
             Trait,
             limit=limit,
             offset=offset,
-            params=params or None,
+            params=self._build_params(character_class=character_class, character_id=character_id),
         )
 
     async def list_all_category_traits(
@@ -234,12 +234,6 @@ class CharacterBlueprintService(BaseService):
         character_id: str | None = None,
     ) -> AsyncIterator[Trait]:
         """Iterate through all character blueprint category traits."""
-        params: dict[str, str | int] = {}
-        if character_class is not None:
-            params["character_class"] = character_class
-        if character_id is not None:
-            params["character_id"] = character_id
-
         async for trait in self._iter_all_pages(
             self._format_endpoint(
                 Endpoints.BLUEPRINT_CATEGORY_TRAITS,
@@ -247,7 +241,7 @@ class CharacterBlueprintService(BaseService):
                 section_id=section_id,
                 category_id=category_id,
             ),
-            params=params or None,
+            params=self._build_params(character_class=character_class, character_id=character_id),
         ):
             yield Trait.model_validate(trait)
 
@@ -265,22 +259,17 @@ class CharacterBlueprintService(BaseService):
         order_by: BlueprintTraitOrderBy | None = None,
     ) -> PaginatedResponse[Trait]:
         """Get a paginated page of all character blueprint traits."""
-        params: dict[str, str | int] = {}
-        if character_class is not None:
-            params["character_class"] = character_class
-        if parent_category_id is not None:
-            params["parent_category_id"] = parent_category_id
-        if order_by is not None:
-            params["order_by"] = order_by
-        if game_version is not None:
-            params["game_version"] = game_version
-
         return await self._get_paginated_as(
             self._format_endpoint(Endpoints.BLUEPRINT_TRAITS),
             Trait,
             limit=limit,
             offset=offset,
-            params=params or None,
+            params=self._build_params(
+                character_class=character_class,
+                parent_category_id=parent_category_id,
+                order_by=order_by,
+                game_version=game_version,
+            ),
         )
 
     async def list_all_traits(
@@ -311,19 +300,14 @@ class CharacterBlueprintService(BaseService):
         order_by: BlueprintTraitOrderBy | None = None,
     ) -> AsyncIterator[Trait]:
         """Iterate through all character blueprint traits."""
-        params: dict[str, str | int] = {}
-        if character_class is not None:
-            params["character_class"] = character_class
-        if parent_category_id is not None:
-            params["parent_category_id"] = parent_category_id
-        if order_by is not None:
-            params["order_by"] = order_by
-        if game_version is not None:
-            params["game_version"] = game_version
-
         async for trait in self._iter_all_pages(
             self._format_endpoint(Endpoints.BLUEPRINT_TRAITS),
-            params=params or None,
+            params=self._build_params(
+                character_class=character_class,
+                parent_category_id=parent_category_id,
+                order_by=order_by,
+                game_version=game_version,
+            ),
         ):
             yield Trait.model_validate(trait)
 
@@ -377,6 +361,7 @@ class CharacterBlueprintService(BaseService):
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
+        game_version: GameVersion | None = None,
     ) -> PaginatedResponse[VampireClan]:
         """Get a paginated page of vampire clans."""
         return await self._get_paginated_as(
@@ -384,16 +369,22 @@ class CharacterBlueprintService(BaseService):
             VampireClan,
             limit=limit,
             offset=offset,
+            params=self._build_params(game_version=game_version),
         )
 
-    async def list_all_vampire_clans(self) -> list[VampireClan]:
+    async def list_all_vampire_clans(
+        self, *, game_version: GameVersion | None = None
+    ) -> list[VampireClan]:
         """List all vampire clans."""
-        return [clan async for clan in self.iter_all_vampire_clans()]
+        return [clan async for clan in self.iter_all_vampire_clans(game_version=game_version)]
 
-    async def iter_all_vampire_clans(self) -> AsyncIterator[VampireClan]:
+    async def iter_all_vampire_clans(
+        self, *, game_version: GameVersion | None = None
+    ) -> AsyncIterator[VampireClan]:
         """Iterate through all vampire clans."""
         async for clan in self._iter_all_pages(
             self._format_endpoint(Endpoints.VAMPIRE_CLANS),
+            params=self._build_params(game_version=game_version),
         ):
             yield VampireClan.model_validate(clan)
 
@@ -412,6 +403,7 @@ class CharacterBlueprintService(BaseService):
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
+        game_version: GameVersion | None = None,
     ) -> PaginatedResponse[WerewolfAuspice]:
         """Get a paginated page of werewolf auspices."""
         return await self._get_paginated_as(
@@ -419,16 +411,24 @@ class CharacterBlueprintService(BaseService):
             WerewolfAuspice,
             limit=limit,
             offset=offset,
+            params=self._build_params(game_version=game_version),
         )
 
-    async def list_all_werewolf_auspices(self) -> list[WerewolfAuspice]:
+    async def list_all_werewolf_auspices(
+        self, *, game_version: GameVersion | None = None
+    ) -> list[WerewolfAuspice]:
         """List all werewolf auspices."""
-        return [auspice async for auspice in self.iter_all_werewolf_auspices()]
+        return [
+            auspice async for auspice in self.iter_all_werewolf_auspices(game_version=game_version)
+        ]
 
-    async def iter_all_werewolf_auspices(self) -> AsyncIterator[WerewolfAuspice]:
+    async def iter_all_werewolf_auspices(
+        self, *, game_version: GameVersion | None = None
+    ) -> AsyncIterator[WerewolfAuspice]:
         """Iterate through all werewolf auspices."""
         async for auspice in self._iter_all_pages(
             self._format_endpoint(Endpoints.WEREWOLF_AUSPICES),
+            params=self._build_params(game_version=game_version),
         ):
             yield WerewolfAuspice.model_validate(auspice)
 
@@ -449,6 +449,7 @@ class CharacterBlueprintService(BaseService):
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
+        game_version: GameVersion | None = None,
     ) -> PaginatedResponse[WerewolfTribe]:
         """Get a paginated page of werewolf tribes."""
         return await self._get_paginated_as(
@@ -456,16 +457,22 @@ class CharacterBlueprintService(BaseService):
             WerewolfTribe,
             limit=limit,
             offset=offset,
+            params=self._build_params(game_version=game_version),
         )
 
-    async def list_all_werewolf_tribes(self) -> list[WerewolfTribe]:
+    async def list_all_werewolf_tribes(
+        self, *, game_version: GameVersion | None = None
+    ) -> list[WerewolfTribe]:
         """List all werewolf tribes."""
-        return [tribe async for tribe in self.iter_all_werewolf_tribes()]
+        return [tribe async for tribe in self.iter_all_werewolf_tribes(game_version=game_version)]
 
-    async def iter_all_werewolf_tribes(self) -> AsyncIterator[WerewolfTribe]:
+    async def iter_all_werewolf_tribes(
+        self, *, game_version: GameVersion | None = None
+    ) -> AsyncIterator[WerewolfTribe]:
         """Iterate through all werewolf tribes."""
         async for tribe in self._iter_all_pages(
             self._format_endpoint(Endpoints.WEREWOLF_TRIBES),
+            params=self._build_params(game_version=game_version),
         ):
             yield WerewolfTribe.model_validate(tribe)
 
@@ -486,6 +493,9 @@ class CharacterBlueprintService(BaseService):
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
+        game_version: GameVersion | None = None,
+        auspice_id: str | None = None,
+        tribe_id: str | None = None,
     ) -> PaginatedResponse[WerewolfGift]:
         """Get a paginated page of werewolf gifts."""
         return await self._get_paginated_as(
@@ -493,16 +503,39 @@ class CharacterBlueprintService(BaseService):
             WerewolfGift,
             limit=limit,
             offset=offset,
+            params=self._build_params(
+                game_version=game_version, auspice_id=auspice_id, tribe_id=tribe_id
+            ),
         )
 
-    async def list_all_werewolf_gifts(self) -> list[WerewolfGift]:
+    async def list_all_werewolf_gifts(
+        self,
+        *,
+        game_version: GameVersion | None = None,
+        auspice_id: str | None = None,
+        tribe_id: str | None = None,
+    ) -> list[WerewolfGift]:
         """List all werewolf gifts."""
-        return [gift async for gift in self.iter_all_werewolf_gifts()]
+        return [
+            gift
+            async for gift in self.iter_all_werewolf_gifts(
+                game_version=game_version, auspice_id=auspice_id, tribe_id=tribe_id
+            )
+        ]
 
-    async def iter_all_werewolf_gifts(self) -> AsyncIterator[WerewolfGift]:
+    async def iter_all_werewolf_gifts(
+        self,
+        *,
+        game_version: GameVersion | None = None,
+        auspice_id: str | None = None,
+        tribe_id: str | None = None,
+    ) -> AsyncIterator[WerewolfGift]:
         """Iterate through all werewolf gifts."""
         async for gift in self._iter_all_pages(
             self._format_endpoint(Endpoints.WEREWOLF_GIFTS),
+            params=self._build_params(
+                game_version=game_version, auspice_id=auspice_id, tribe_id=tribe_id
+            ),
         ):
             yield WerewolfGift.model_validate(gift)
 
@@ -560,6 +593,7 @@ class CharacterBlueprintService(BaseService):
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
+        edge_type: HunterEdgeType | None = None,
     ) -> PaginatedResponse[HunterEdge]:
         """Get a paginated page of hunter edges."""
         return await self._get_paginated_as(
@@ -567,16 +601,22 @@ class CharacterBlueprintService(BaseService):
             HunterEdge,
             limit=limit,
             offset=offset,
+            params=self._build_params(edge_type=edge_type),
         )
 
-    async def list_all_hunter_edges(self) -> list[HunterEdge]:
+    async def list_all_hunter_edges(
+        self, *, edge_type: HunterEdgeType | None = None
+    ) -> list[HunterEdge]:
         """List all hunter edges."""
-        return [edge async for edge in self.iter_all_hunter_edges()]
+        return [edge async for edge in self.iter_all_hunter_edges(edge_type=edge_type)]
 
-    async def iter_all_hunter_edges(self) -> AsyncIterator[HunterEdge]:
+    async def iter_all_hunter_edges(
+        self, *, edge_type: HunterEdgeType | None = None
+    ) -> AsyncIterator[HunterEdge]:
         """Iterate through all hunter edges."""
         async for edge in self._iter_all_pages(
             self._format_endpoint(Endpoints.HUNTER_EDGES),
+            params=self._build_params(edge_type=edge_type),
         ):
             yield HunterEdge.model_validate(edge)
 

{valentina_python_client-1.0.2 → valentina_python_client-1.1.0}/src/vclient/services/dicerolls.py

@@ -126,7 +126,7 @@ class DicerollService(BaseService):
         )
         return Diceroll.model_validate(response.json())
 
-    async def create_quickroll(
+    async def create_from_quickroll(
         self,
         *,
         quickroll_id: str,