valentina-python-client 3.0.0__tar.gz → 3.2.0__tar.gz

{valentina_python_client-3.0.0 → valentina_python_client-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: valentina-python-client
-Version: 3.0.0
+Version: 3.2.0
 Summary: Async Python client library for the Valentina Noir API
 Author: Nate Landau
 Author-email: Nate Landau <github@natenate.org>
@@ -15,8 +15,8 @@ License: MIT License
          THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Dist: anyio>=4.13.0,<5.0.0
-Requires-Dist: httpx2>=2.4.0
+Requires-Dist: anyio>=4.14.1,<5.0.0
+Requires-Dist: httpx2>=2.5.0
 Requires-Dist: loguru>=0.7.3
 Requires-Dist: polyfactory>=3.3.0,<4.0.0
 Requires-Dist: pydantic[email]>=2.13.4,<3.0.0

{valentina_python_client-3.0.0 → valentina_python_client-3.2.0}/pyproject.toml

@@ -5,8 +5,8 @@
         "Programming Language :: Python :: 3.14",
     ]
     dependencies = [
-        "anyio>=4.13.0, <5.0.0",
-        "httpx2>=2.4.0",
+        "anyio>=4.14.1,<5.0.0",
+        "httpx2>=2.5.0",
         "loguru>=0.7.3",
         "polyfactory>=3.3.0, <4.0.0",
         "pydantic[email]>=2.13.4, <3.0.0",
@@ -16,7 +16,7 @@
     name = "valentina-python-client"
     readme = "README.md"
     requires-python = ">=3.13"
-    version = "3.0.0"
+    version = "3.2.0"
 
     [project.optional-dependencies]
         testing = ["polyfactory>=3.3.0"]
@@ -34,11 +34,11 @@
 
 [dependency-groups]
     dev = [
-        "commitizen>=4.16.3",
-        "coverage>=7.14.1",
+        "commitizen>=4.16.4",
+        "coverage>=7.15.0",
         "duty>=1.9.0",
         "httpx>=0.28.1",
-        "prek>=0.4.4",
+        "prek>=0.4.8",
         "pytest-anyio>=0.0.0",
         "pytest-clarity>=1.0.1",
         "pytest-cov>=7.1.0",
@@ -48,16 +48,16 @@
         "pytest-repeat>=0.9.4",
         "pytest-sugar>=1.1.1",
         "pytest-xdist>=3.8.0",
-        "pytest>=9.1.0",
+        "pytest>=9.1.1",
         "respx>=0.23.1",
-        "ruff>=0.15.17",
+        "ruff>=0.15.20",
         "shellcheck-py>=0.11.0.1",
-        "ty>=0.0.49",
-        "typos>=1.47.2",
+        "ty>=0.0.56",
+        "typos>=1.48.0",
         "vulture>=2.16",
         "yamllint>=1.38.0",
     ]
-    docs = ["zensical>=0.0.45"]
+    docs = ["zensical>=0.0.47"]
 
 [tool.commitizen]
     bump_message               = "bump(release): v$current_version → v$new_version"

{valentina_python_client-3.0.0 → valentina_python_client-3.2.0}/src/vclient/__init__.py

@@ -116,4 +116,4 @@ __all__ = (
     "users_service",
 )
 
-__version__ = "3.0.0"
+__version__ = "3.2.0"

{valentina_python_client-3.0.0 → valentina_python_client-3.2.0}/src/vclient/_sync/services/campaign_book_chapters.py

@@ -114,7 +114,7 @@ class SyncChaptersService(SyncBaseService):
         Args:
             request: A ChapterCreate model, OR pass fields as keyword arguments.
             **kwargs: Fields for ChapterCreate if request is not provided.
-                Accepts: name (str, required), description (str | None).
+                Accepts: name (str, required), description (str | None), character_ids (list[str] | None).
         """
         body = request if request is not None else ChapterCreate(**kwargs)
         response = self._post(
@@ -132,7 +132,7 @@ class SyncChaptersService(SyncBaseService):
             chapter_id: The ID of the chapter to update.
             request: A ChapterUpdate model, OR pass fields as keyword arguments.
             **kwargs: Fields for ChapterUpdate if request is not provided.
-                Accepts: name (str | None), description (str | None).
+                Accepts: name (str | None), description (str | None), character_ids (list[str] | None).
         """
         body = request if request is not None else ChapterUpdate(**kwargs)
         response = self._patch(

{valentina_python_client-3.0.0 → valentina_python_client-3.2.0}/src/vclient/_sync/services/character_traits.py

@@ -211,15 +211,19 @@ class SyncCharacterTraitsService(SyncBaseService):
         return BulkAssignTraitResponse.model_validate(response.json())
 
     def create(self, request: TraitCreate | None = None, **kwargs) -> CharacterTrait:
-        """Create a new character trait.
+        """Create a new custom character trait.
+
+        The trait is always created at a value of ``1``; the supplied ``currency`` pays
+        for that first dot. ``NPC`` and ``STORYTELLER`` characters accept only
+        ``"NO_COST"``.
 
         Args:
             request: A TraitCreate model, OR pass fields as keyword arguments.
             **kwargs: Fields for TraitCreate if request is not provided.
-                Required: name (str), category_id (str).
+                Required: name (str), category_id (str), currency (TraitModifyCurrency).
                 Optional: description (str | None), max_value (int), min_value (int),
                 show_when_zero (bool), initial_cost (int | None),
-                upgrade_cost (int | None), value (int | None).
+                upgrade_cost (int | None).
         """
         body = request if request is not None else self._validate_request(TraitCreate, **kwargs)
         response = self._post(

{valentina_python_client-3.0.0 → valentina_python_client-3.2.0}/src/vclient/models/__init__.py

@@ -134,7 +134,6 @@ from .users import (
     AppleProfile,
     CampaignExperience,
     DiscordProfile,
-    DiscordProfileUpdate,
     GitHubProfile,
     GoogleProfile,
     IdentityResolution,
@@ -207,7 +206,6 @@ __all__ = [
     "DictionaryTermCreate",
     "DictionaryTermUpdate",
     "DiscordProfile",
-    "DiscordProfileUpdate",
     "FullSheetTraitCategory",
     "FullSheetTraitSection",
     "FullSheetTraitSubcategory",

{valentina_python_client-3.0.0 → valentina_python_client-3.2.0}/src/vclient/models/books.py

@@ -20,6 +20,10 @@ class CampaignBook(BaseModel):
     name: str = Field(..., description="Book name (3-50 characters).")
     description: str | None = Field(default=None, description="Book description.")
     asset_ids: list[str] = Field(default_factory=list, description="List of associated asset IDs.")
+    character_ids: list[str] = Field(
+        default_factory=list,
+        description="Read-only union of character IDs across the book's chapters.",
+    )
     number: int = Field(..., description="Book number within the campaign.")
     campaign_id: str = Field(..., description="ID of the parent campaign.")
     num_chapters: int = Field(default=0, description="Number of active chapters in the book.")

{valentina_python_client-3.0.0 → valentina_python_client-3.2.0}/src/vclient/models/chapters.py

@@ -21,6 +21,9 @@ class CampaignChapter(BaseModel):
     name: str = Field(..., description="Chapter name (3-50 characters).")
     description: str | None = Field(default=None, description="Chapter description.")
     asset_ids: list[str] = Field(default_factory=list, description="List of associated asset IDs.")
+    character_ids: list[str] = Field(
+        default_factory=list, description="List of associated character IDs."
+    )
     number: int = Field(..., description="Chapter number within the book.")
     book_id: str = Field(..., description="ID of the parent book.")
     num_notes: int = Field(default=0, description="Number of active notes on the chapter.")
@@ -48,6 +51,10 @@ class ChapterCreate(BaseModel):
 
     name: str = Field(..., description="Chapter name (3-50 characters).")
     description: str | None = Field(default=None, description="Chapter description.")
+    character_ids: list[str] | None = Field(
+        default=None,
+        description="Character IDs to associate. Each must be an active character in the same campaign.",
+    )
 
 
 class ChapterUpdate(BaseModel):
@@ -55,6 +62,10 @@ class ChapterUpdate(BaseModel):
 
     name: str | None = Field(default=None, description="Chapter name (3-50 characters).")
     description: str | None = Field(default=None, description="Chapter description.")
+    character_ids: list[str] | None = Field(
+        default=None,
+        description="Replacement character ID list. Omit to leave unchanged; send [] to clear.",
+    )
 
 
 class _ChapterRenumber(BaseModel):

{valentina_python_client-3.0.0 → valentina_python_client-3.2.0}/src/vclient/models/character_trait.py

@@ -34,21 +34,22 @@ class CharacterTraitAdd(BaseModel):
 
 
 class TraitCreate(BaseModel):
-    """Request model for creating a character trait.
+    """Request model for creating a custom character trait.
 
-    Used to construct the JSON payload for character trait creation.
+    Used to construct the JSON payload for character trait creation. The trait is
+    always created at a value of ``1``; the supplied ``currency`` pays for that first dot.
     """
 
     name: str
+    category_id: str
+    currency: TraitModifyCurrency
     description: str | None = None
     max_value: Annotated[int, Field(ge=0, le=100, default=5)] = 5
     min_value: Annotated[int, Field(ge=0, le=100, default=0)] = 0
     show_when_zero: bool | None = True
-    category_id: str
     initial_cost: int | None = None
     upgrade_cost: int | None = None
     count_based_cost_multiplier: int | None = None
-    value: int | None = None
 
 
 class _TraitModify(BaseModel):

{valentina_python_client-3.0.0 → valentina_python_client-3.2.0}/src/vclient/models/characters.py

@@ -204,6 +204,10 @@ class Character(BaseModel):
     character_trait_ids: list[str] = Field(
         default_factory=list, description="List of character trait IDs."
     )
+    chapter_ids: list[str] = Field(
+        default_factory=list,
+        description="Read-only IDs of non-archived chapters this character is associated with.",
+    )
     specialties: list[CharacterSpecialty] = Field(
         default_factory=list, description="List of character specialties."
     )

{valentina_python_client-3.0.0 → valentina_python_client-3.2.0}/src/vclient/models/users.py

@@ -168,22 +168,6 @@ class IdentityResolution(BaseModel):
 # -----------------------------------------------------------------------------
 
 
-class DiscordProfileUpdate(BaseModel):
-    """Request body for creating or updating a user's Discord profile.
-
-    Contains Discord account details for integration with Discord bots.
-    All fields are optional as not all users have Discord linked.
-    """
-
-    id: str | None = None
-    username: str | None = None
-    global_name: str | None = None
-    avatar_id: str | None = None
-    discriminator: str | None = None
-    email: str | None = None
-    verified: bool | None = None
-
-
 class UserMergeDTO(BaseModel):
     """Merge an UNAPPROVED user into an existing primary user."""
 
@@ -244,15 +228,11 @@ class AdminUserCreate(UserCreate):
     the target company. The server rejects ``UNAPPROVED``/``DEACTIVATED`` roles
     on create, so no client-side role restriction is applied here.
 
-    Unlike the tenant-scoped surface, the global-admin endpoints still accept
-    provider profile writes, so the four profile fields are declared here.
+    Provider-identity profiles cannot be written here; associate a verified
+    provider identity through the ``identify`` or link endpoints instead.
     """
 
     company_id: str
-    discord_profile: DiscordProfileUpdate | None = None
-    google_profile: GoogleProfile | None = None
-    github_profile: GitHubProfile | None = None
-    apple_profile: AppleProfile | None = None
 
 
 class AdminUserUpdate(UserUpdate):
@@ -261,15 +241,11 @@ class AdminUserUpdate(UserUpdate):
     Extends the tenant-scoped ``UserUpdate`` with ``is_archived``. Set it to
     ``False`` to restore a soft-deleted user.
 
-    Unlike the tenant-scoped surface, the global-admin endpoints still accept
-    provider profile writes, so the four profile fields are declared here.
+    Provider-identity profiles cannot be written here; associate a verified
+    provider identity through the ``identify`` or link endpoints instead.
     """
 
     is_archived: bool | None = None
-    discord_profile: DiscordProfileUpdate | None = None
-    google_profile: GoogleProfile | None = None
-    github_profile: GitHubProfile | None = None
-    apple_profile: AppleProfile | None = None
 
 
 class UserApproveDTO(BaseModel):

{valentina_python_client-3.0.0 → valentina_python_client-3.2.0}/src/vclient/services/campaign_book_chapters.py

@@ -132,7 +132,7 @@ class ChaptersService(BaseService):
         Args:
             request: A ChapterCreate model, OR pass fields as keyword arguments.
             **kwargs: Fields for ChapterCreate if request is not provided.
-                Accepts: name (str, required), description (str | None).
+                Accepts: name (str, required), description (str | None), character_ids (list[str] | None).
         """
         body = request if request is not None else ChapterCreate(**kwargs)
         response = await self._post(
@@ -153,7 +153,7 @@ class ChaptersService(BaseService):
             chapter_id: The ID of the chapter to update.
             request: A ChapterUpdate model, OR pass fields as keyword arguments.
             **kwargs: Fields for ChapterUpdate if request is not provided.
-                Accepts: name (str | None), description (str | None).
+                Accepts: name (str | None), description (str | None), character_ids (list[str] | None).
         """
         body = request if request is not None else ChapterUpdate(**kwargs)
         response = await self._patch(

{valentina_python_client-3.0.0 → valentina_python_client-3.2.0}/src/vclient/services/character_traits.py

@@ -243,15 +243,19 @@ class CharacterTraitsService(BaseService):
         request: TraitCreate | None = None,
         **kwargs,
     ) -> CharacterTrait:
-        """Create a new character trait.
+        """Create a new custom character trait.
+
+        The trait is always created at a value of ``1``; the supplied ``currency`` pays
+        for that first dot. ``NPC`` and ``STORYTELLER`` characters accept only
+        ``"NO_COST"``.
 
         Args:
             request: A TraitCreate model, OR pass fields as keyword arguments.
             **kwargs: Fields for TraitCreate if request is not provided.
-                Required: name (str), category_id (str).
+                Required: name (str), category_id (str), currency (TraitModifyCurrency).
                 Optional: description (str | None), max_value (int), min_value (int),
                 show_when_zero (bool), initial_cost (int | None),
-                upgrade_cost (int | None), value (int | None).
+                upgrade_cost (int | None).
         """
         body = request if request is not None else self._validate_request(TraitCreate, **kwargs)
         response = await self._post(