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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: valentina-python-client
-Version: 3.3.0
+Version: 3.4.0
 Summary: Async Python client library for the Valentina Noir API
 Author: Nate Landau
 Author-email: Nate Landau <github@natenate.org>
@@ -15,11 +15,12 @@ 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.2,<5.0.0
-Requires-Dist: httpx2>=2.9.1
+Classifier: Programming Language :: Python :: 3.15
+Requires-Dist: anyio>=4.15.1,<5.0.0
+Requires-Dist: httpx2>=2.13.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
+Requires-Dist: pydantic[email]>=2.14.1,<3.0.0
 Requires-Dist: polyfactory>=3.3.0 ; extra == 'testing'
 Requires-Python: >=3.13
 Project-URL: Homepage, https://docs.valentina-noir.com/python-api-client/

{valentina_python_client-3.3.0 → valentina_python_client-3.4.0}/pyproject.toml

@@ -2,19 +2,20 @@
 classifiers = [
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
 ]
 dependencies = [
-    "anyio>=4.14.2,<5.0.0",
-    "httpx2>=2.9.1",
+    "anyio>=4.15.1,<5.0.0",
+    "httpx2>=2.13.1",
     "loguru>=0.7.3",
     "polyfactory>=3.3.0, <4.0.0",
-    "pydantic[email]>=2.13.4, <3.0.0",
+    "pydantic[email]>=2.14.1,<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"
+version = "3.4.0"
 
 [[project.authors]]
 name = "Nate Landau"
@@ -32,7 +33,7 @@ Repository = "https://github.com/natelandau/valentina-python-client"
 
 [build-system]
 build-backend = "uv_build"
-requires = ["uv_build>=0.11.15,<0.13.0"]
+requires = ["uv_build>=0.13.0,<0.14"]
 
 [tool.uv.build-backend]
 module-name = "vclient"
@@ -216,27 +217,28 @@ error-on-warning = true
 
 [dependency-groups]
 dev = [
-    "commitizen>=4.17.0",
-    "coverage>=7.15.3",
-    "duty>=1.9.0",
+    "commitizen>=4.19.2",
+    "coverage>=7.16.2",
+    "duty>=1.10.1",
+    "gate-cache>=0.6.0",
     "httpx>=0.28.1",
-    "prek>=0.4.12",
+    "prek>=0.5.5",
     "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-mock>=3.16.0",
     "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",
+    "ruff>=0.17.0",
     "shellcheck-py>=0.11.0.1",
-    "ty>=0.0.65",
-    "typos>=1.48.0",
+    "ty>=0.0.86",
+    "typos>=1.51.1",
     "vulture>=2.16",
     "yamllint>=1.38.0",
 ]
-docs = ["zensical>=0.0.52"]
+docs = ["zensical>=0.0.70"]

{valentina_python_client-3.3.0 → valentina_python_client-3.4.0}/pyproject.toml.orig

@@ -3,20 +3,21 @@
     classifiers = [
         "Programming Language :: Python :: 3.13",
         "Programming Language :: Python :: 3.14",
+        "Programming Language :: Python :: 3.15",
     ]
     dependencies = [
-        "anyio>=4.14.2,<5.0.0",
-        "httpx2>=2.9.1",
+        "anyio>=4.15.1,<5.0.0",
+        "httpx2>=2.13.1",
         "loguru>=0.7.3",
         "polyfactory>=3.3.0, <4.0.0",
-        "pydantic[email]>=2.13.4, <3.0.0",
+        "pydantic[email]>=2.14.1,<3.0.0",
     ]
     description = "Async Python client library for the Valentina Noir API"
     license = { file = "LICENSE" }
     name = "valentina-python-client"
     readme = "README.md"
     requires-python = ">=3.13"
-    version = "3.3.0"
+    version = "3.4.0"
 
     [project.optional-dependencies]
         testing = ["polyfactory>=3.3.0"]
@@ -27,37 +28,38 @@
 
 [build-system]
     build-backend = "uv_build"
-    requires      = ["uv_build>=0.11.15,<0.13.0"]
+    requires      = ["uv_build>=0.13.0,<0.14"]
 
 [tool.uv.build-backend]
     module-name = "vclient"
 
 [dependency-groups]
     dev = [
-        "commitizen>=4.17.0",
-        "coverage>=7.15.3",
-        "duty>=1.9.0",
+        "commitizen>=4.19.2",
+        "coverage>=7.16.2",
+        "duty>=1.10.1",
+        "gate-cache>=0.6.0",
         "httpx>=0.28.1",
-        "prek>=0.4.12",
+        "prek>=0.5.5",
         "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-mock>=3.16.0",
         "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",
+        "ruff>=0.17.0",
         "shellcheck-py>=0.11.0.1",
-        "ty>=0.0.65",
-        "typos>=1.48.0",
+        "ty>=0.0.86",
+        "typos>=1.51.1",
         "vulture>=2.16",
         "yamllint>=1.38.0",
-    ]
-    docs = ["zensical>=0.0.52"]
+]
+    docs = ["zensical>=0.0.70"]
 
 [tool.commitizen]
     bump_message               = "bump(release): v$current_version → v$new_version"

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

@@ -116,4 +116,4 @@ __all__ = (
     "users_service",
 )
 
-__version__ = "3.3.0"
+__version__ = "3.4.0"

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

@@ -5,15 +5,21 @@ from collections.abc import Iterator
 from typing import TYPE_CHECKING
 
 from vclient._sync.services.base import SyncBaseService
-from vclient.constants import DEFAULT_PAGE_LIMIT, TraitModifyCurrency
+from vclient.constants import DEFAULT_PAGE_LIMIT, DamageType, TrackerAction, TraitModifyCurrency
 from vclient.endpoints import Endpoints
 from vclient.models import (
+    _TRACKER_ADAPTER,
     BulkAssignTraitResponse,
     CharacterTrait,
     CharacterTraitAdd,
+    CharacterTraitSpecialtyCreate,
+    CharacterTraitSpecialtyUpdate,
     CharacterTraitValueOptionsResponse,
     PaginatedResponse,
+    Tracker,
+    TrackerStateSet,
     TraitCreate,
+    _TrackerAction,
     _TraitModify,
 )
 
@@ -140,6 +146,8 @@ class SyncCharacterTraitsService(SyncBaseService):
     def delete(self, character_trait_id: str, currency: TraitModifyCurrency | None = None) -> None:
         """Delete a character trait.
 
+        Any specialties on the trait are removed with it and the cost of each is refunded.
+
         Args:
             character_trait_id: The ID of the trait to delete.
             currency: The currency to use to recoup the cost of the trait.
@@ -152,6 +160,8 @@ class SyncCharacterTraitsService(SyncBaseService):
             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.
+            ConflictError: If recouping ``XP`` or ``STARTING_POINTS`` and another request
+                changed the trait's value first. Refetch the trait and retry.
         """
         params: dict[str, str | int] = {}
         if currency is not None:
@@ -177,6 +187,8 @@ class SyncCharacterTraitsService(SyncBaseService):
             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.
+            ConflictError: If paying with ``XP`` or ``STARTING_POINTS`` and another request
+                changed the trait's value first. Refetch the trait and retry.
         """
         body = self._validate_request(
             CharacterTraitAdd, trait_id=trait_id, value=value, currency=currency
@@ -225,6 +237,13 @@ class SyncCharacterTraitsService(SyncBaseService):
                 show_when_zero (bool), is_rollable (bool, default True),
                 initial_cost (int | None), upgrade_cost (int | None),
                 count_based_cost_multiplier (int | None).
+
+        Returns:
+            The newly created CharacterTrait object.
+
+        Raises:
+            ConflictError: If paying with ``XP`` or ``STARTING_POINTS`` and another request
+                changed the trait's value first. Refetch the trait and retry.
         """
         body = request if request is not None else self._validate_request(TraitCreate, **kwargs)
         response = self._post(
@@ -260,10 +279,20 @@ class SyncCharacterTraitsService(SyncBaseService):
     ) -> CharacterTrait:
         """Change the value of a character trait.
 
+        Lowering an ability to ``0`` also removes its specialties and refunds the cost of
+        each. The value change and the refunds are applied together or not at all.
+
         Args:
             character_trait_id: The ID of the trait to change the value of.
             new_value: The new value of the trait.
             currency: The currency to use for the modification.
+
+        Returns:
+            The updated CharacterTrait object.
+
+        Raises:
+            ConflictError: If another request changed the trait's value after this request
+                read it. Nothing is spent or refunded. Refetch the trait and retry.
         """
         body = self._validate_request(_TraitModify, target_value=new_value, currency=currency)
         response = self._put(
@@ -273,3 +302,197 @@ class SyncCharacterTraitsService(SyncBaseService):
             json=body.model_dump(exclude_none=True, exclude_unset=True, mode="json"),
         )
         return CharacterTrait.model_validate(response.json())
+
+    def add_specialty(
+        self, character_trait_id: str, name: str, currency: TraitModifyCurrency = "NO_COST"
+    ) -> CharacterTrait:
+        """Add a specialty to an ability trait.
+
+        Specialties are only available on abilities with a value of 1 or higher. When the
+        company's ``specialty_xp_cost_enabled`` setting is on, a specialty paid with ``XP``
+        or ``STARTING_POINTS`` costs 3 points, and ``NO_COST`` follows the company's
+        ``permission_free_trait_changes`` setting. When the setting is off, specialties are free.
+
+        Args:
+            character_trait_id: The ID of the ability trait.
+            name: The specialty name (3-50 characters), unique on the trait ignoring case.
+            currency: The currency to use to pay for the specialty.
+
+        Returns:
+            The updated CharacterTrait object, including its specialties.
+
+        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 trait is not an ability, has a value of 0, already has a
+                specialty with this name, the character cannot afford the cost, or an
+                ``NPC`` or ``STORYTELLER`` character pays with anything but ``NO_COST``.
+        """
+        body = self._validate_request(CharacterTraitSpecialtyCreate, name=name, currency=currency)
+        response = self._post(
+            self._format_endpoint(
+                Endpoints.CHARACTER_TRAIT_SPECIALTIES, character_trait_id=character_trait_id
+            ),
+            json=body.model_dump(exclude_none=True, mode="json"),
+        )
+        return CharacterTrait.model_validate(response.json())
+
+    def update_specialty(
+        self, character_trait_id: str, specialty_id: str, name: str
+    ) -> CharacterTrait:
+        """Rename a specialty on an ability trait.
+
+        Renaming never changes the cost paid or the currency used.
+
+        Args:
+            character_trait_id: The ID of the ability trait.
+            specialty_id: The ID of the specialty to rename.
+            name: The new specialty name (3-50 characters), unique on the trait ignoring case.
+
+        Returns:
+            The updated CharacterTrait object, including its specialties.
+
+        Raises:
+            NotFoundError: If the trait or specialty does not exist, or the specialty
+                belongs to a different trait.
+            AuthorizationError: If you don't have access to the character.
+            RequestValidationError: If the input parameters fail client-side validation.
+            ValidationError: If the trait already has a specialty with this name.
+        """
+        body = self._validate_request(CharacterTraitSpecialtyUpdate, name=name)
+        response = self._patch(
+            self._format_endpoint(
+                Endpoints.CHARACTER_TRAIT_SPECIALTY,
+                character_trait_id=character_trait_id,
+                specialty_id=specialty_id,
+            ),
+            json=body.model_dump(exclude_none=True, mode="json"),
+        )
+        return CharacterTrait.model_validate(response.json())
+
+    def delete_specialty(self, character_trait_id: str, specialty_id: str) -> None:
+        """Remove a specialty from an ability trait.
+
+        The cost paid is refunded in the currency used to buy it. An ``XP`` refund follows
+        the company's ``permission_recoup_xp`` setting; starting points are always refunded.
+
+        Args:
+            character_trait_id: The ID of the ability trait.
+            specialty_id: The ID of the specialty to remove.
+
+        Returns:
+            None
+
+        Raises:
+            NotFoundError: If the trait or specialty does not exist, or the specialty
+                belongs to a different trait.
+            AuthorizationError: If you don't have access to the character.
+        """
+        self._delete(
+            self._format_endpoint(
+                Endpoints.CHARACTER_TRAIT_SPECIALTY,
+                character_trait_id=character_trait_id,
+                specialty_id=specialty_id,
+            )
+        )
+
+    def get_tracker(self, character_trait_id: str) -> Tracker:
+        """Get the in-play tracker state of a character trait.
+
+        The same object appears as ``CharacterTrait.tracker``. Use this to refresh one
+        tracker without fetching the whole trait.
+
+        Args:
+            character_trait_id: The ID of the character trait.
+
+        Returns:
+            A CounterTracker, DamageTracker, or StainsTracker. Switch on ``type``.
+
+        Raises:
+            NotFoundError: If the trait has no tracker for the character's game version.
+            AuthorizationError: If you don't have access to the character.
+        """
+        response = self._get(
+            self._format_endpoint(
+                Endpoints.CHARACTER_TRAIT_TRACKER, character_trait_id=character_trait_id
+            )
+        )
+        return _TRACKER_ADAPTER.validate_python(response.json())
+
+    def set_tracker(
+        self, character_trait_id: str, request: TrackerStateSet | None = None, **kwargs
+    ) -> Tracker:
+        """Replace the full state of a trait tracker, such as to correct a mistake.
+
+        Send only the fields for the tracker's type: ``current`` for counters (required),
+        ``superficial`` and ``aggravated`` for damage tracks, ``stains`` for stains. Omitted
+        fields reset to 0, so an empty request clears a damage or stains tracker. Use
+        ``apply_tracker_action`` for in-play changes instead.
+
+        Args:
+            character_trait_id: The ID of the character trait.
+            request: A TrackerStateSet model, OR pass fields as keyword arguments.
+            **kwargs: Fields for TrackerStateSet if request is not provided.
+                Accepts: current, superficial, aggravated, stains (int >= 0).
+
+        Returns:
+            The updated tracker.
+
+        Raises:
+            NotFoundError: If the trait has no tracker for the character's game version.
+            AuthorizationError: If you are not the character's player or a storyteller.
+            RequestValidationError: If a value is negative.
+            ValidationError: If a field does not fit the tracker type, a counter has no
+                ``current``, or a value exceeds the tracker size.
+        """
+        body = request if request is not None else self._validate_request(TrackerStateSet, **kwargs)
+        response = self._put(
+            self._format_endpoint(
+                Endpoints.CHARACTER_TRAIT_TRACKER, character_trait_id=character_trait_id
+            ),
+            json=body.model_dump(exclude_none=True, mode="json"),
+        )
+        return _TRACKER_ADAPTER.validate_python(response.json())
+
+    def apply_tracker_action(
+        self,
+        character_trait_id: str,
+        action: TrackerAction,
+        *,
+        amount: int = 1,
+        damage_type: DamageType | None = None,
+    ) -> Tracker:
+        """Apply one in-play action to a trait tracker, such as spending Willpower.
+
+        The server applies the game rules for the character's game version. Which actions
+        and damage types fit each tracker is listed in ``characters.TrackerRules`` from
+        ``options.get_options()``. A STAINS response reports overflow into Willpower in
+        ``willpower_damage_applied``.
+
+        Args:
+            character_trait_id: The ID of the character trait.
+            action: The action to apply.
+            amount: How many points to apply. Must be at least 1.
+            damage_type: The damage type for ``damage`` and ``heal`` on damage tracks.
+
+        Returns:
+            The updated tracker.
+
+        Raises:
+            NotFoundError: If the trait has no tracker for the character's game version.
+            AuthorizationError: If you are not the character's player or a storyteller.
+            RequestValidationError: If ``amount`` is less than 1.
+            ValidationError: If the action or damage type does not fit the tracker, a
+                damage type is missing or not allowed, or a spend exceeds the current value.
+        """
+        body = self._validate_request(
+            _TrackerAction, action=action, amount=amount, damage_type=damage_type
+        )
+        response = self._post(
+            self._format_endpoint(
+                Endpoints.CHARACTER_TRAIT_TRACKER_ACTIONS, character_trait_id=character_trait_id
+            ),
+            json=body.model_dump(exclude_none=True, mode="json"),
+        )
+        return _TRACKER_ADAPTER.validate_python(response.json())

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

@@ -12,6 +12,8 @@ from vclient.constants import (
     CharacterInclude,
     CharacterStatus,
     CharacterType,
+    DamageType,
+    TrackerAction,
 )
 from vclient.endpoints import Endpoints
 from vclient.models import (
@@ -22,6 +24,8 @@ from vclient.models import (
     CharacterFullSheet,
     CharacterUpdate,
     FullSheetTraitCategory,
+    Health,
+    HealthStateSet,
     InventoryItem,
     InventoryItemCreate,
     InventoryItemUpdate,
@@ -30,6 +34,7 @@ from vclient.models import (
     NoteUpdate,
     PaginatedResponse,
     RollStatistics,
+    _TrackerAction,
 )
 
 if TYPE_CHECKING:
@@ -873,3 +878,94 @@ class SyncCharactersService(SyncBaseService):
                 Endpoints.CHARACTER_INVENTORY_ITEM, character_id=character_id, item_id=item_id
             )
         )
+
+    def get_health(self, character_id: str) -> Health:
+        """Get a character's health track.
+
+        The same object appears as ``Character.health``. Re-fetch it after changing V5
+        Stamina, which sets the track size.
+
+        Args:
+            character_id: The ID of the character.
+
+        Returns:
+            The character's Health.
+
+        Raises:
+            NotFoundError: If the character does not exist or has no health track.
+            AuthorizationError: If you don't have access to the character.
+        """
+        response = self._get(
+            self._format_endpoint(Endpoints.CHARACTER_HEALTH, character_id=character_id)
+        )
+        return Health.model_validate(response.json())
+
+    def set_health(
+        self, character_id: str, request: HealthStateSet | None = None, **kwargs
+    ) -> Health:
+        """Replace a character's full health state, such as to correct a mistake.
+
+        Every field is sent, so omitted fields reset to 0. V4 uses ``bashing``,
+        ``lethal``, and ``aggravated``; V5 uses ``superficial`` and ``aggravated``.
+        ``extra_levels`` applies to both. Use ``apply_health_action`` for in-play changes.
+
+        Args:
+            character_id: The ID of the character.
+            request: A HealthStateSet model, OR pass fields as keyword arguments.
+            **kwargs: Fields for HealthStateSet if request is not provided.
+                Accepts: extra_levels, superficial, aggravated, bashing, lethal (int >= 0).
+
+        Returns:
+            The updated Health.
+
+        Raises:
+            NotFoundError: If the character does not exist or has no health track.
+            AuthorizationError: If you are not the character's player or a storyteller.
+            RequestValidationError: If a value is negative.
+            ValidationError: If a nonzero field is not used by the game version, or the
+                marks exceed the track size.
+        """
+        body = request if request is not None else self._validate_request(HealthStateSet, **kwargs)
+        response = self._put(
+            self._format_endpoint(Endpoints.CHARACTER_HEALTH, character_id=character_id),
+            json=body.model_dump(mode="json"),
+        )
+        return Health.model_validate(response.json())
+
+    def apply_health_action(
+        self,
+        character_id: str,
+        action: TrackerAction,
+        *,
+        amount: int = 1,
+        damage_type: DamageType | None = None,
+    ) -> Health:
+        """Apply one in-play action to a character's health, such as taking damage.
+
+        Health accepts ``damage``, ``heal``, and ``reset``. V4 damage types are
+        ``BASHING``, ``LETHAL``, and ``AGGRAVATED``; V5 damage types are ``SUPERFICIAL``
+        and ``AGGRAVATED``. The server applies overflow and upgrade rules.
+
+        Args:
+            character_id: The ID of the character.
+            action: The action to apply.
+            amount: How many points to apply. Must be at least 1.
+            damage_type: The damage type for ``damage`` and ``heal``.
+
+        Returns:
+            The updated Health.
+
+        Raises:
+            NotFoundError: If the character does not exist or has no health track.
+            AuthorizationError: If you are not the character's player or a storyteller.
+            RequestValidationError: If ``amount`` is less than 1.
+            ValidationError: If the action or damage type does not fit the game version.
+        """
+        body = self._validate_request(
+            _TrackerAction, action=action, amount=amount, damage_type=damage_type
+        )
+        response = self._post(
+            self._format_endpoint(Endpoints.CHARACTER_HEALTH_ACTIONS, character_id=character_id),
+            json=body.model_dump(exclude_none=True, mode="json"),
+        )
+        return Health.model_validate(response.json())

{valentina_python_client-3.3.0 → valentina_python_client-3.4.0}/src/vclient/_sync/services/options.py

@@ -2,7 +2,7 @@
 """Options and enumerations service."""
 
 import json
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any
 
 from vclient._sync.services.base import SyncBaseService
 from vclient.endpoints import Endpoints
@@ -32,9 +32,14 @@ class SyncOptionsService(SyncBaseService):
         """Format an endpoint with the scoped company_id plus any extra params."""
         return endpoint.format(company_id=self._company_id, **kwargs)
 
-    def get_options(self) -> dict[str, dict[str, list[str] | dict[str, str]]]:
+    def get_options(self) -> dict[str, dict[str, Any]]:
         """Retrieve all options and enumerations for the api.
 
+        Most values are lists of enum values. ``characters.TrackerRules`` is a nested map
+        ``{game_version: {tracker_key: {"actions": [...], "damage_types": [...]}}}`` where
+        ``tracker_key`` is a tracker type or ``HEALTH``. Use it to choose which tracker
+        actions and damage types to offer instead of hardcoding them.
+
         Returns:
             A dictionary of options and enumerations for the api.
         """

{valentina_python_client-3.3.0 → valentina_python_client-3.4.0}/src/vclient/constants.py

@@ -50,8 +50,10 @@ AuditEntityType = Literal[
     "CAMPAIGN",
     "CHAPTER",
     "CHARACTER",
+    "CHARACTER_HEALTH",
     "CHARACTER_INVENTORY",
     "CHARACTER_TRAIT",
+    "CHARACTER_TRAIT_SPECIALTY",
     "CHARGEN_SESSION",
     "COMPANY",
     "DEVELOPER",
@@ -102,3 +104,6 @@ UserRole = Literal["ADMIN", "STORYTELLER", "PLAYER", "UNAPPROVED", "DEACTIVATED"
 WerewolfRenown = Literal["HONOR", "GLORY", "WISDOM"]
 BlueprintTraitOrderBy = Literal["NAME", "SHEET"]
 TraitModifyCurrency = Literal["XP", "STARTING_POINTS", "NO_COST"]
+TrackerType = Literal["COUNTER", "DAMAGE", "STAINS"]
+TrackerAction = Literal["spend", "gain", "damage", "heal", "add_stain", "remove_stain", "reset"]
+DamageType = Literal["SUPERFICIAL", "AGGRAVATED", "BASHING", "LETHAL"]

{valentina_python_client-3.3.0 → valentina_python_client-3.4.0}/src/vclient/endpoints.py

@@ -127,6 +127,12 @@ class Endpoints:
     CHARACTER_TRAIT = f"{CHARACTER_TRAITS}/{{character_trait_id}}"
     CHARACTER_TRAIT_VALUE_OPTIONS = f"{CHARACTER_TRAIT}/value-options"
     CHARACTER_TRAIT_VALUE = f"{CHARACTER_TRAIT}/value"
+    CHARACTER_TRAIT_SPECIALTIES = f"{CHARACTER_TRAIT}/specialties"
+    CHARACTER_TRAIT_SPECIALTY = f"{CHARACTER_TRAIT_SPECIALTIES}/{{specialty_id}}"
+    CHARACTER_TRAIT_TRACKER = f"{CHARACTER_TRAIT}/tracker"
+    CHARACTER_TRAIT_TRACKER_ACTIONS = f"{CHARACTER_TRAIT_TRACKER}/actions"
+    CHARACTER_HEALTH = f"{CHARACTER}/health"
+    CHARACTER_HEALTH_ACTIONS = f"{CHARACTER_HEALTH}/actions"
 
     # Character Blueprint endpoints
     BLUEPRINT_BASE = f"{COMPANY}/characterblueprint"

{valentina_python_client-3.3.0 → valentina_python_client-3.4.0}/src/vclient/exceptions.py

@@ -131,7 +131,9 @@ class NotFoundError(APIError):
 class ConflictError(APIError):
     """Raised when there is a conflict (409 Conflict).
 
-    Common cause is reusing an idempotency key with a different request body.
+    Common causes are reusing an idempotency key with a different request body, or
+    another request changing a character trait's value first. For the latter, refetch
+    the trait and retry.
     """