valentina-python-client 1.23.0__tar.gz → 2.0.0__tar.gz

{valentina_python_client-1.23.0 → valentina_python_client-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: valentina-python-client
-Version: 1.23.0
+Version: 2.0.0
 Summary: Async Python client library for the Valentina Noir API
 Author: Nate Landau
 Author-email: Nate Landau <github@natenate.org>
@@ -19,7 +19,7 @@ Requires-Dist: anyio>=4.13.0
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: loguru>=0.7.3
 Requires-Dist: polyfactory>=3.3.0
-Requires-Dist: pydantic[email]>=2.12.5
+Requires-Dist: pydantic[email]>=2.13.1
 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-1.23.0 → valentina_python_client-2.0.0}/pyproject.toml

@@ -9,14 +9,14 @@
         "httpx>=0.28.1",
         "loguru>=0.7.3",
         "polyfactory>=3.3.0",
-        "pydantic[email]>=2.12.5",
+        "pydantic[email]>=2.13.1",
     ]
     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 = "1.23.0"
+    version = "2.0.0"
 
     [project.optional-dependencies]
         testing = ["polyfactory>=3.3.0"]
@@ -34,10 +34,10 @@
 
 [dependency-groups]
     dev = [
-        "commitizen>=4.13.9",
+        "commitizen>=4.13.10",
         "coverage>=7.13.5",
         "duty>=1.9.0",
-        "prek>=0.3.8",
+        "prek>=0.3.9",
         "pytest-anyio>=0.0.0",
         "pytest-clarity>=1.0.1",
         "pytest-cov>=7.1.0",
@@ -46,16 +46,16 @@
         "pytest-repeat>=0.9.4",
         "pytest-sugar>=1.1.1",
         "pytest-xdist>=3.8.0",
-        "pytest>=9.0.2",
-        "respx>=0.22.0",
-        "ruff>=0.15.9",
+        "pytest>=9.0.3",
+        "respx>=0.23.1",
+        "ruff>=0.15.10",
         "shellcheck-py>=0.11.0.1",
-        "ty>=0.0.29",
-        "typos>=1.45.0",
+        "ty>=0.0.31",
+        "typos>=1.45.1",
         "vulture>=2.16",
         "yamllint>=1.38.0",
     ]
-    docs = ["zensical>=0.0.31"]
+    docs = ["zensical>=0.0.33"]
 
 [tool.commitizen]
     bump_message               = "bump(release): v$current_version → v$new_version"

{valentina_python_client-1.23.0 → valentina_python_client-2.0.0}/src/vclient/__init__.py

@@ -113,4 +113,4 @@ __all__ = (
     "users_service",
 )
 
-__version__ = "1.23.0"
+__version__ = "2.0.0"

{valentina_python_client-1.23.0 → valentina_python_client-2.0.0}/src/vclient/_sync/services/companies.py

@@ -115,7 +115,7 @@ class SyncCompaniesService(SyncBaseService):
             request: A CompanyCreate model, OR pass fields as keyword arguments.
             **kwargs: Fields for CompanyCreate if request is not provided.
                 Accepts: name (str, required), email (str, required),
-                description (str | None), settings (CompanySettings | None).
+                description (str | None), settings (CompanySettingsCreate | None).
 
         Returns:
             The newly created NewCompanyResponse object containing the company and admin user.
@@ -141,7 +141,7 @@ class SyncCompaniesService(SyncBaseService):
             request: A CompanyUpdate model, OR pass fields as keyword arguments.
             **kwargs: Fields for CompanyUpdate if request is not provided.
                 Accepts: name (str | None), email (str | None),
-                description (str | None), settings (CompanySettings | None).
+                description (str | None), settings (CompanySettingsUpdate | None).
 
         Returns:
             The updated Company object.

{valentina_python_client-1.23.0 → valentina_python_client-2.0.0}/src/vclient/models/__init__.py

@@ -73,6 +73,8 @@ from .companies import (
     CompanyCreate,
     CompanyPermissions,
     CompanySettings,
+    CompanySettingsCreate,
+    CompanySettingsUpdate,
     CompanyUpdate,
     NewCompanyResponse,
     _GrantAccess as _GrantAccess,
@@ -177,6 +179,8 @@ __all__ = [
     "CompanyCreate",
     "CompanyPermissions",
     "CompanySettings",
+    "CompanySettingsCreate",
+    "CompanySettingsUpdate",
     "CompanyUpdate",
     "CreateAutogenerateDTO",
     "Developer",

{valentina_python_client-1.23.0 → valentina_python_client-2.0.0}/src/vclient/models/companies.py

@@ -16,14 +16,46 @@ from vclient.models.users import User
 
 
 class CompanySettings(BaseModel):
-    """Settings configuration for a company.
+    """Company configuration settings as returned by the API.
 
-    Controls various permissions and configuration options for the company.
-    Used in both response and request contexts; defaults support partial updates.
+    Strict response model — every field is always populated by the server.
+    For partial create/update payloads, use CompanySettingsCreate or
+    CompanySettingsUpdate instead.
+    """
+
+    character_autogen_xp_cost: int
+    character_autogen_num_choices: int
+    character_autogen_starting_points: int
+    permission_manage_campaign: ManageCampaignPermission
+    permission_grant_xp: GrantXPPermission
+    permission_free_trait_changes: FreeTraitChangesPermission
+    permission_recoup_xp: RecoupXPPermission
+
+
+class CompanySettingsCreate(BaseModel):
+    """Partial CompanySettings payload for POST /companies.
+
+    All fields optional — the server applies defaults for anything omitted.
+    """
+
+    character_autogen_xp_cost: int | None = None
+    character_autogen_num_choices: int | None = None
+    character_autogen_starting_points: int | None = None
+    permission_manage_campaign: ManageCampaignPermission | None = None
+    permission_grant_xp: GrantXPPermission | None = None
+    permission_free_trait_changes: FreeTraitChangesPermission | None = None
+    permission_recoup_xp: RecoupXPPermission | None = None
+
+
+class CompanySettingsUpdate(BaseModel):
+    """Partial CompanySettings payload for PATCH /companies/{id}.
+
+    All fields optional — omitted fields remain unchanged on the server.
     """
 
     character_autogen_xp_cost: int | None = None
     character_autogen_num_choices: int | None = None
+    character_autogen_starting_points: int | None = None
     permission_manage_campaign: ManageCampaignPermission | None = None
     permission_grant_xp: GrantXPPermission | None = None
     permission_free_trait_changes: FreeTraitChangesPermission | None = None
@@ -86,7 +118,7 @@ class CompanyCreate(BaseModel):
     name: str = Field(min_length=3, max_length=50)
     email: str
     description: Annotated[str, Field(min_length=3)] | None = None
-    settings: CompanySettings | None = None
+    settings: CompanySettingsCreate | None = None
 
 
 class CompanyUpdate(BaseModel):
@@ -98,7 +130,7 @@ class CompanyUpdate(BaseModel):
     name: Annotated[str, Field(min_length=3, max_length=50)] | None = None
     email: str | None = None
     description: Annotated[str, Field(min_length=3)] | None = None
-    settings: CompanySettings | None = None
+    settings: CompanySettingsUpdate | None = None
 
 
 class _GrantAccess(BaseModel):
@@ -113,6 +145,8 @@ __all__ = [
     "CompanyCreate",
     "CompanyPermissions",
     "CompanySettings",
+    "CompanySettingsCreate",
+    "CompanySettingsUpdate",
     "CompanyUpdate",
     "NewCompanyResponse",
     "_GrantAccess",

{valentina_python_client-1.23.0 → valentina_python_client-2.0.0}/src/vclient/models/system.py

@@ -7,9 +7,12 @@ class SystemHealth(BaseModel):
     """Response model for system health check.
 
     Represents the health status of the API and its dependencies including
-    database and cache connectivity.
+    database and cache connectivity, latency metrics, and uptime information.
     """
 
     database_status: str
     cache_status: str
+    database_latency_ms: float | None
+    cache_latency_ms: float | None
+    uptime: str
     version: str

{valentina_python_client-1.23.0 → valentina_python_client-2.0.0}/src/vclient/services/companies.py

@@ -126,7 +126,7 @@ class CompaniesService(BaseService):
             request: A CompanyCreate model, OR pass fields as keyword arguments.
             **kwargs: Fields for CompanyCreate if request is not provided.
                 Accepts: name (str, required), email (str, required),
-                description (str | None), settings (CompanySettings | None).
+                description (str | None), settings (CompanySettingsCreate | None).
 
         Returns:
             The newly created NewCompanyResponse object containing the company and admin user.
@@ -157,7 +157,7 @@ class CompaniesService(BaseService):
             request: A CompanyUpdate model, OR pass fields as keyword arguments.
             **kwargs: Fields for CompanyUpdate if request is not provided.
                 Accepts: name (str | None), email (str | None),
-                description (str | None), settings (CompanySettings | None).
+                description (str | None), settings (CompanySettingsUpdate | None).
 
         Returns:
             The updated Company object.

{valentina_python_client-1.23.0 → valentina_python_client-2.0.0}/src/vclient/services/users.py

@@ -63,9 +63,7 @@ class UsersService(BaseService):
         """Format an endpoint with the scoped company_id plus any extra params."""
         return endpoint.format(company_id=self._company_id, **kwargs)
 
-    # -------------------------------------------------------------------------
     # Unapproved User Methods
-    # -------------------------------------------------------------------------
 
     async def get_unapproved_page(
         self,
@@ -202,9 +200,7 @@ class UsersService(BaseService):
         )
         return User.model_validate(response.json())
 
-    # -------------------------------------------------------------------------
     # User CRUD Methods
-    # -------------------------------------------------------------------------
 
     async def get_page(
         self,
@@ -445,9 +441,7 @@ class UsersService(BaseService):
         )
         return RollStatistics.model_validate(response.json())
 
-    # -------------------------------------------------------------------------
     # Asset Methods
-    # -------------------------------------------------------------------------
 
     async def get_assets_page(
         self,
@@ -604,9 +598,7 @@ class UsersService(BaseService):
         )
         return Asset.model_validate(response.json())
 
-    # -------------------------------------------------------------------------
     # Experience Methods
-    # -------------------------------------------------------------------------
 
     async def get_experience(
         self,
@@ -740,9 +732,7 @@ class UsersService(BaseService):
         )
         return CampaignExperience.model_validate(response.json())
 
-    # -------------------------------------------------------------------------
     # Notes Methods
-    # -------------------------------------------------------------------------
 
     async def get_notes_page(
         self,
@@ -931,9 +921,7 @@ class UsersService(BaseService):
             self._format_endpoint(Endpoints.USER_NOTE, user_id=user_id, note_id=note_id)
         )
 
-    # -------------------------------------------------------------------------
     # Quickroll Methods
-    # -------------------------------------------------------------------------
 
     async def get_quickrolls_page(
         self,