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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: valentina-python-client
-Version: 3.2.0
+Version: 3.3.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.14.1,<5.0.0
-Requires-Dist: httpx2>=2.5.0
+Requires-Dist: anyio>=4.14.2,<5.0.0
+Requires-Dist: httpx2>=2.9.1
 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.3.0/pyproject.toml

@@ -0,0 +1,242 @@
+[project]
+classifiers = [
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = [
+    "anyio>=4.14.2,<5.0.0",
+    "httpx2>=2.9.1",
+    "loguru>=0.7.3",
+    "polyfactory>=3.3.0, <4.0.0",
+    "pydantic[email]>=2.13.4, <3.0.0",
+]
+description = "Async Python client library for the Valentina Noir API"
+name = "valentina-python-client"
+readme = "README.md"
+requires-python = ">=3.13"
+version = "3.3.0"
+
+[[project.authors]]
+name = "Nate Landau"
+email = "github@natenate.org"
+
+[project.license]
+file = "LICENSE"
+
+[project.optional-dependencies]
+testing = ["polyfactory>=3.3.0"]
+
+[project.urls]
+Homepage = "https://docs.valentina-noir.com/python-api-client/"
+Repository = "https://github.com/natelandau/valentina-python-client"
+
+[build-system]
+build-backend = "uv_build"
+requires = ["uv_build>=0.11.15,<0.13.0"]
+
+[tool.uv.build-backend]
+module-name = "vclient"
+
+[tool.commitizen]
+bump_message = "bump(release): v$current_version → v$new_version"
+changelog_merge_prerelease = true
+tag_format = "v$version"
+update_changelog_on_bump = true
+version_files = ["src/vclient/__init__.py:__version__"]
+version_provider = "uv"
+
+[tool.coverage.report]
+exclude_lines = [
+    "def __repr__",
+    'except [\w\s\._]+ as .*:',
+    "if TYPE_CHECKING",
+    "pragma: no cover",
+    "raise Abort",
+    "raise Exit",
+]
+fail_under = 0
+precision = 1
+show_missing = true
+skip_covered = true
+skip_empty = true
+
+[tool.coverage.run]
+branch = true
+command_line = "--module pytest"
+data_file = ".cache/coverage"
+omit = ["tests/*"]
+source = ["src"]
+
+[tool.coverage.xml]
+output = ".cache/coverage.xml"
+
+[tool.pytest.ini_options]
+addopts = "--color=yes --doctest-modules --strict-config --strict-markers -n auto --dist loadfile"
+cache_dir = ".cache/pytest"
+filterwarnings = [
+    "error",
+    "ignore:.*Pydantic.*:UserWarning",
+    "ignore::DeprecationWarning:",
+]
+markers = ["serial"]
+testpaths = ["tests"]
+xfail_strict = true
+
+[tool.ruff]
+exclude = [
+    ".cache",
+    ".dev",
+    ".git",
+    ".venv",
+    ".worktrees",
+    "_build",
+    "_site",
+    "build",
+    "dist",
+]
+fix = true
+line-length = 100
+output-format = "grouped"
+src = [
+    "src",
+    "tests",
+]
+target-version = "py313"
+
+[tool.ruff.lint]
+ignore = [
+    "ANN002",
+    "ANN003",
+    "ANN204",
+    "ANN401",
+    "B006",
+    "B008",
+    "COM812",
+    "CPY001",
+    "D107",
+    "E501",
+    "PLC0415",
+    "E711",
+    "E712",
+    "FIX002",
+    "S311",
+    "TD001",
+    "TD002",
+    "TD003",
+]
+select = ["ALL"]
+unfixable = [
+    "ERA001",
+    "F401",
+    "F841",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"src/vclient/_sync/**" = [
+    "C416",
+    "C901",
+    "D",
+    "E501",
+    "ERA001",
+    "PLR0913",
+    "PLR2004",
+    "PLW0603",
+    "SLF001",
+    "TRY300",
+    "UP028",
+]
+"scripts/*.py" = [
+    "INP001",
+    "T201",
+]
+"src/vclient/services/*.py" = ["PLR0913"]
+"src/vclient/validate_constants.py" = ["T201"]
+"tests/**/*.py" = [
+    "A002",
+    "A003",
+    "ANN001",
+    "ANN002",
+    "ANN003",
+    "ANN201",
+    "ARG001",
+    "ARG002",
+    "ARG005",
+    "D102",
+    "ERA001",
+    "F403",
+    "F405",
+    "FBT001",
+    "PGH003",
+    "PLC0415",
+    "PLR0913",
+    "PLR0917",
+    "PLR2004",
+    "PT011",
+    "S101",
+    "SLF001",
+    "W292",
+]
+
+[tool.ruff.lint.mccabe]
+max-complexity = 10
+
+[tool.ruff.lint.isort]
+combine-as-imports = true
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.pylint]
+max-args = 6
+
+[tool.ruff.format]
+exclude = ["src/vclient/_sync"]
+indent-style = "space"
+line-ending = "auto"
+quote-style = "double"
+skip-magic-trailing-comma = false
+
+[tool.vulture]
+exclude = [
+    "duties.py",
+    "scripts/",
+    "tests/",
+    "tmp/",
+]
+ignore_decorators = []
+ignore_names = []
+make_whitelist = false
+min_confidence = 100
+paths = ["src/"]
+sort_by_size = true
+verbose = false
+
+[tool.ty.terminal]
+error-on-warning = true
+
+[dependency-groups]
+dev = [
+    "commitizen>=4.17.0",
+    "coverage>=7.15.3",
+    "duty>=1.9.0",
+    "httpx>=0.28.1",
+    "prek>=0.4.12",
+    "pytest-anyio>=0.0.0",
+    "pytest-clarity>=1.0.1",
+    "pytest-cov>=7.1.0",
+    "pytest-devtools>=1.3.0",
+    "pytest-httpx2>=1.0.0",
+    "pytest-mock>=3.15.1",
+    "pytest-repeat>=0.9.4",
+    "pytest-sugar>=1.1.1",
+    "pytest-xdist>=3.8.0",
+    "pytest>=9.1.1",
+    "respx>=0.23.1",
+    "ruff>=0.16.1",
+    "shellcheck-py>=0.11.0.1",
+    "ty>=0.0.65",
+    "typos>=1.48.0",
+    "vulture>=2.16",
+    "yamllint>=1.38.0",
+]
+docs = ["zensical>=0.0.52"]

valentina_python_client-3.2.0/pyproject.toml → valentina_python_client-3.3.0/pyproject.toml.orig

@@ -5,8 +5,8 @@
         "Programming Language :: Python :: 3.14",
     ]
     dependencies = [
-        "anyio>=4.14.1,<5.0.0",
-        "httpx2>=2.5.0",
+        "anyio>=4.14.2,<5.0.0",
+        "httpx2>=2.9.1",
         "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.2.0"
+    version = "3.3.0"
 
     [project.optional-dependencies]
         testing = ["polyfactory>=3.3.0"]
@@ -27,22 +27,22 @@
 
 [build-system]
     build-backend = "uv_build"
-    requires      = ["uv_build>=0.11.15,<0.12.0"]
+    requires      = ["uv_build>=0.11.15,<0.13.0"]
 
 [tool.uv.build-backend]
     module-name = "vclient"
 
 [dependency-groups]
     dev = [
-        "commitizen>=4.16.4",
-        "coverage>=7.15.0",
+        "commitizen>=4.17.0",
+        "coverage>=7.15.3",
         "duty>=1.9.0",
         "httpx>=0.28.1",
-        "prek>=0.4.8",
+        "prek>=0.4.12",
         "pytest-anyio>=0.0.0",
         "pytest-clarity>=1.0.1",
         "pytest-cov>=7.1.0",
-        "pytest-devtools>=1.2.0",
+        "pytest-devtools>=1.3.0",
         "pytest-httpx2>=1.0.0",
         "pytest-mock>=3.15.1",
         "pytest-repeat>=0.9.4",
@@ -50,14 +50,14 @@
         "pytest-xdist>=3.8.0",
         "pytest>=9.1.1",
         "respx>=0.23.1",
-        "ruff>=0.15.20",
+        "ruff>=0.16.1",
         "shellcheck-py>=0.11.0.1",
-        "ty>=0.0.56",
+        "ty>=0.0.65",
         "typos>=1.48.0",
         "vulture>=2.16",
         "yamllint>=1.38.0",
     ]
-    docs = ["zensical>=0.0.47"]
+    docs = ["zensical>=0.0.52"]
 
 [tool.commitizen]
     bump_message               = "bump(release): v$current_version → v$new_version"
@@ -168,7 +168,8 @@
             "FBT001",  # Boolean-typed positional argument in function definition
             "PGH003",  # Use specific rule codes when ignoring type issues
             "PLC0415", # Imports should be at top of file
-            "PLR0913",
+            "PLR0913", # Too many positional arguments
+            "PLR0917", # Too many positional arguments
             "PLR2004",
             "PT011",   # set the `match` parameter or use a more specific exception
             "S101",

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

@@ -31,7 +31,7 @@ _logger.add(
     # Forward TRACE too (e.g. the "Send request" line) and let the consumer's
     # stdlib logging level decide what to show; the sink must not pre-filter it.
     level="TRACE",
-    filter=lambda record: record["name"].startswith("vclient"),
+    filter=lambda record: record["name"].startswith("vclient"),  # ty: ignore[unresolved-attribute]
 )
 
 _logger.disable("vclient")
@@ -116,4 +116,4 @@ __all__ = (
     "users_service",
 )
 
-__version__ = "3.2.0"
+__version__ = "3.3.0"

{valentina_python_client-3.2.0 → valentina_python_client-3.3.0}/src/vclient/_sync/services/campaigns.py

@@ -127,6 +127,7 @@ class SyncCampaignsService(SyncBaseService):
             request: A CampaignCreate model, OR pass fields as keyword arguments.
             **kwargs: Fields for CampaignCreate if request is not provided.
                 Accepts: name (str, required), description (str | None),
+                in_game_date (datetime.date | None, ISO 8601 calendar date),
                 desperation (int, default 0), danger (int, default 0).
 
         Returns:
@@ -154,7 +155,8 @@ class SyncCampaignsService(SyncBaseService):
             request: A CampaignUpdate model, OR pass fields as keyword arguments.
             **kwargs: Fields for CampaignUpdate if request is not provided.
                 Accepts: name (str | None), description (str | None),
-                desperation (int | None), danger (int | None).
+                in_game_date (datetime.date | None, ISO 8601 calendar date;
+                pass None to clear it), desperation (int | None), danger (int | None).
 
         Returns:
             The updated Campaign object.
@@ -166,9 +168,11 @@ class SyncCampaignsService(SyncBaseService):
             ValidationError: If the request data is invalid.
         """
         body = request if request is not None else self._validate_request(CampaignUpdate, **kwargs)
+        payload = body.model_dump(exclude_none=True, exclude_unset=True, mode="json")
+        if "in_game_date" in body.model_fields_set and body.in_game_date is None:
+            payload["in_game_date"] = None
         response = self._patch(
-            self._format_endpoint(Endpoints.CAMPAIGN, campaign_id=campaign_id),
-            json=body.model_dump(exclude_none=True, exclude_unset=True, mode="json"),
+            self._format_endpoint(Endpoints.CAMPAIGN, campaign_id=campaign_id), json=payload
         )
         return Campaign.model_validate(response.json())
 

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

@@ -222,8 +222,9 @@ class SyncCharacterTraitsService(SyncBaseService):
             **kwargs: Fields for TraitCreate if request is not provided.
                 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).
+                show_when_zero (bool), is_rollable (bool, default True),
+                initial_cost (int | None), upgrade_cost (int | None),
+                count_based_cost_multiplier (int | None).
         """
         body = request if request is not None else self._validate_request(TraitCreate, **kwargs)
         response = self._post(

{valentina_python_client-3.2.0 → valentina_python_client-3.3.0}/src/vclient/_sync/services/characters.py

@@ -241,6 +241,7 @@ class SyncCharactersService(SyncBaseService):
                 Required: campaign_id (str), character_class (CharacterClass),
                 game_version (GameVersion), name_first (str), name_last (str).
                 Optional: type (CharacterType), name_nick (str), age (int),
+                date_of_birth (datetime.date | None, ISO 8601 calendar date),
                 biography (str), demeanor (str), nature (str), concept_id (str),
                 user_player_id (str), traits (list), vampire_attributes, etc.
 
@@ -274,7 +275,8 @@ class SyncCharactersService(SyncBaseService):
             request: A CharacterUpdate model, OR pass fields as keyword arguments.
             **kwargs: Fields for CharacterUpdate if request is not provided.
                 All fields are optional: character_class, type, game_version, status,
-                name_first, name_last, name_nick, age, biography, demeanor, nature,
+                name_first, name_last, name_nick, age, date_of_birth (datetime.date | None,
+                ISO 8601 calendar date; pass None to clear it), biography, demeanor, nature,
                 concept_id, user_player_id, vampire_attributes, werewolf_attributes, etc.
 
         Returns:
@@ -287,9 +289,11 @@ class SyncCharactersService(SyncBaseService):
             ValidationError: If the request data is invalid.
         """
         body = request if request is not None else self._validate_request(CharacterUpdate, **kwargs)
+        payload = body.model_dump(exclude_none=True, exclude_unset=True, mode="json")
+        if "date_of_birth" in body.model_fields_set and body.date_of_birth is None:
+            payload["date_of_birth"] = None
         response = self._patch(
-            self._format_endpoint(Endpoints.CHARACTER, character_id=character_id),
-            json=body.model_dump(exclude_none=True, exclude_unset=True, mode="json"),
+            self._format_endpoint(Endpoints.CHARACTER, character_id=character_id), json=payload
         )
         return Character.model_validate(response.json())
 

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

@@ -122,6 +122,7 @@ from .shared import (
     ProviderAudiences,
     RollStatistics,
     Trait,
+    TraitPower,
 )
 from .system import SystemHealth
 from .user_lookup import (
@@ -242,6 +243,7 @@ __all__ = [
     "Trait",
     "TraitCategory",
     "TraitCreate",
+    "TraitPower",
     "TraitSubcategory",
     "User",
     "UserApproveDTO",

{valentina_python_client-3.2.0 → valentina_python_client-3.3.0}/src/vclient/models/campaigns.py

@@ -1,6 +1,6 @@
 """Pydantic models for Campaign API responses and requests."""
 
-from datetime import datetime
+from datetime import date, datetime
 from typing import Annotated
 
 from pydantic import BaseModel, Field
@@ -22,6 +22,7 @@ class Campaign(BaseModel):
     date_modified: datetime
     name: str
     description: str | None = None
+    in_game_date: date | None = None
     asset_ids: list[str] = Field(default_factory=list)
     desperation: int = 0
     danger: int = 0
@@ -47,6 +48,7 @@ class CampaignCreate(BaseModel):
 
     name: str = Field(min_length=3, max_length=50)
     description: Annotated[str, Field(min_length=3)] | None = None
+    in_game_date: date | None = None
     desperation: int = Field(default=0, ge=0, le=5)
     danger: int = Field(default=0, ge=0, le=5)
 
@@ -59,6 +61,7 @@ class CampaignUpdate(BaseModel):
 
     name: Annotated[str, Field(min_length=3, max_length=50)] | None = None
     description: Annotated[str, Field(min_length=3)] | None = None
+    in_game_date: date | None = None
     desperation: Annotated[int, Field(ge=0, le=5)] | None = None
     danger: Annotated[int, Field(ge=0, le=5)] | None = None
 

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

@@ -47,6 +47,7 @@ class TraitCreate(BaseModel):
     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
+    is_rollable: bool = True
     initial_cost: int | None = None
     upgrade_cost: int | None = None
     count_based_cost_multiplier: int | None = None

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

@@ -1,6 +1,6 @@
 """Pydantic models for Character API responses and requests."""
 
-from datetime import datetime
+from datetime import date, datetime
 from typing import Annotated
 
 from pydantic import BaseModel, Field
@@ -177,6 +177,9 @@ class Character(BaseModel):
 
     # Biography
     age: int | None = Field(default=None, description="Character's age.")
+    date_of_birth: date | None = Field(
+        default=None, description="Character's date of birth (ISO 8601 calendar date)."
+    )
     biography: Annotated[str, Field(min_length=3)] | None = Field(
         default=None, description="Character biography."
     )
@@ -280,6 +283,9 @@ class CharacterCreate(BaseModel):
         default=None, description="Character's nickname."
     )
     age: int | None = Field(default=None, description="Character's age.")
+    date_of_birth: date | None = Field(
+        default=None, description="Character's date of birth (ISO 8601 calendar date)."
+    )
     biography: Annotated[str, Field(min_length=3)] | None = Field(
         default=None, description="Character biography."
     )
@@ -333,6 +339,7 @@ class CharacterUpdate(BaseModel):
     )
 
     age: int | None = None
+    date_of_birth: date | None = None
     biography: Annotated[str, Field(min_length=3)] | None = Field(
         default=None, description="Character biography."
     )

{valentina_python_client-3.2.0 → valentina_python_client-3.3.0}/src/vclient/models/dictionary.py

@@ -4,6 +4,8 @@ from datetime import datetime
 
 from pydantic import BaseModel, Field
 
+from .shared import TraitPower
+
 
 class DictionaryTerm(BaseModel):
     """Response model for a dictionary term."""
@@ -19,6 +21,9 @@ class DictionaryTerm(BaseModel):
     source_type: str | None = None
     source_id: str | None = None
 
+    # Populated only for terms with source_type "trait", resolved from that trait's powers.
+    powers: list[TraitPower] = Field(default_factory=list)
+
 
 class DictionaryTermCreate(BaseModel):
     """Request body for creating a dictionary term."""

{valentina_python_client-3.2.0 → valentina_python_client-3.3.0}/src/vclient/models/shared.py

@@ -146,6 +146,22 @@ class GiftAttributes(BaseModel):
     auspice_name: str | None = None
 
 
+class TraitPower(BaseModel):
+    """A power a trait grants at a specific dot level.
+
+    Named powers (Disciplines and Thaumaturgy/Necromancy paths) carry a name and usually a
+    system. Nameless per-dot descriptors on Attributes and Skills describe what each dot
+    rating means and have `name` set to None.
+    """
+
+    id: str
+    level: int
+    name: str | None = None
+    description: str | None = None
+    system: str | None = None
+    link: str | None = None
+
+
 class Trait(BaseModel):
     """Response model for a trait.
 
@@ -161,7 +177,6 @@ class Trait(BaseModel):
     show_when_zero: bool = True
     max_value: int = 5
     min_value: int = 0
-    is_custom: bool = False
     initial_cost: int = 1
     upgrade_cost: int = 2
     count_based_cost_multiplier: int | None = None
@@ -171,6 +186,7 @@ class Trait(BaseModel):
     sheet_section_id: str
     category_name: str | None = None
     category_id: str
+    # Non-null marks a custom trait owned by that character, which is deleted along with it.
     custom_for_character_id: str | None = None
     subcategory_id: str | None = None
     subcategory_name: str | None = None
@@ -179,6 +195,9 @@ class Trait(BaseModel):
     system: str | None = None
     gift_attributes: GiftAttributes | None = None
 
+    # Ordered by level ascending, then name. A single level may grant several powers.
+    powers: list[TraitPower] = Field(default_factory=list)
+
     character_classes: list[CharacterClass] = Field(default_factory=list)
     game_versions: list[GameVersion] = Field(default_factory=list)
 
@@ -202,4 +221,5 @@ __all__ = [
     "ProviderAudiences",
     "RollStatistics",
     "Trait",
+    "TraitPower",
 ]

{valentina_python_client-3.2.0 → valentina_python_client-3.3.0}/src/vclient/services/campaigns.py

@@ -152,6 +152,7 @@ class CampaignsService(BaseService):
             request: A CampaignCreate model, OR pass fields as keyword arguments.
             **kwargs: Fields for CampaignCreate if request is not provided.
                 Accepts: name (str, required), description (str | None),
+                in_game_date (datetime.date | None, ISO 8601 calendar date),
                 desperation (int, default 0), danger (int, default 0).
 
         Returns:
@@ -184,7 +185,8 @@ class CampaignsService(BaseService):
             request: A CampaignUpdate model, OR pass fields as keyword arguments.
             **kwargs: Fields for CampaignUpdate if request is not provided.
                 Accepts: name (str | None), description (str | None),
-                desperation (int | None), danger (int | None).
+                in_game_date (datetime.date | None, ISO 8601 calendar date;
+                pass None to clear it), desperation (int | None), danger (int | None).
 
         Returns:
             The updated Campaign object.
@@ -196,9 +198,14 @@ class CampaignsService(BaseService):
             ValidationError: If the request data is invalid.
         """
         body = request if request is not None else self._validate_request(CampaignUpdate, **kwargs)
+        payload = body.model_dump(exclude_none=True, exclude_unset=True, mode="json")
+        # The API distinguishes an omitted key (leave unchanged) from an explicit null (clear).
+        # exclude_none drops None, so re-add in_game_date when the caller set it to None to clear it.
+        if "in_game_date" in body.model_fields_set and body.in_game_date is None:
+            payload["in_game_date"] = None
         response = await self._patch(
             self._format_endpoint(Endpoints.CAMPAIGN, campaign_id=campaign_id),
-            json=body.model_dump(exclude_none=True, exclude_unset=True, mode="json"),
+            json=payload,
         )
         return Campaign.model_validate(response.json())
 

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

@@ -254,8 +254,9 @@ class CharacterTraitsService(BaseService):
             **kwargs: Fields for TraitCreate if request is not provided.
                 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).
+                show_when_zero (bool), is_rollable (bool, default True),
+                initial_cost (int | None), upgrade_cost (int | None),
+                count_based_cost_multiplier (int | None).
         """
         body = request if request is not None else self._validate_request(TraitCreate, **kwargs)
         response = await self._post(

{valentina_python_client-3.2.0 → valentina_python_client-3.3.0}/src/vclient/services/characters.py

@@ -252,6 +252,7 @@ class CharactersService(BaseService):
                 Required: campaign_id (str), character_class (CharacterClass),
                 game_version (GameVersion), name_first (str), name_last (str).
                 Optional: type (CharacterType), name_nick (str), age (int),
+                date_of_birth (datetime.date | None, ISO 8601 calendar date),
                 biography (str), demeanor (str), nature (str), concept_id (str),
                 user_player_id (str), traits (list), vampire_attributes, etc.
 
@@ -288,7 +289,8 @@ class CharactersService(BaseService):
             request: A CharacterUpdate model, OR pass fields as keyword arguments.
             **kwargs: Fields for CharacterUpdate if request is not provided.
                 All fields are optional: character_class, type, game_version, status,
-                name_first, name_last, name_nick, age, biography, demeanor, nature,
+                name_first, name_last, name_nick, age, date_of_birth (datetime.date | None,
+                ISO 8601 calendar date; pass None to clear it), biography, demeanor, nature,
                 concept_id, user_player_id, vampire_attributes, werewolf_attributes, etc.
 
         Returns:
@@ -301,9 +303,14 @@ class CharactersService(BaseService):
             ValidationError: If the request data is invalid.
         """
         body = request if request is not None else self._validate_request(CharacterUpdate, **kwargs)
+        payload = body.model_dump(exclude_none=True, exclude_unset=True, mode="json")
+        # The API distinguishes an omitted key (leave unchanged) from an explicit null (clear).
+        # exclude_none drops None, so re-add date_of_birth when the caller set it to None to clear it.
+        if "date_of_birth" in body.model_fields_set and body.date_of_birth is None:
+            payload["date_of_birth"] = None
         response = await self._patch(
             self._format_endpoint(Endpoints.CHARACTER, character_id=character_id),
-            json=body.model_dump(exclude_none=True, exclude_unset=True, mode="json"),
+            json=payload,
         )
         return Character.model_validate(response.json())