valentina-python-client 1.4.0__tar.gz → 1.4.1__tar.gz

{valentina_python_client-1.4.0 → valentina_python_client-1.4.1}/PKG-INFO

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

{valentina_python_client-1.4.0 → valentina_python_client-1.4.1}/pyproject.toml

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

{valentina_python_client-1.4.0 → valentina_python_client-1.4.1}/src/vclient/__init__.py

@@ -71,4 +71,4 @@ __all__ = (
     "users_service",
 )
 
-__version__ = "1.4.0"
+__version__ = "1.4.1"

{valentina_python_client-1.4.0 → valentina_python_client-1.4.1}/src/vclient/constants.py

@@ -55,10 +55,10 @@ HunterEdgeType = Literal["ASSETS", "APTITUDES", "ENDOWMENTS"]
 ManageCampaignPermission = Literal["UNRESTRICTED", "STORYTELLER"]
 PermissionLevel = Literal["USER", "ADMIN", "OWNER", "REVOKE"]
 RollResultType = Literal["SUCCESS", "FAILURE", "BOTCH", "CRITICAL", "OTHER"]
-S3AssetParentType = Literal[
+AssetParentType = Literal[
     "character", "campaign", "campaignbook", "campaignchapter", "user", "company", "unknown"
 ]
-S3AssetType = Literal["image", "text", "audio", "video", "document", "archive", "other"]
+AssetType = Literal["image", "text", "audio", "video", "document", "archive", "other"]
 SpecialtyType = Literal["ACTION", "OTHER", "PASSIVE", "RITUAL", "SPELL"]
 UserRole = Literal["ADMIN", "STORYTELLER", "PLAYER"]
 WerewolfRenown = Literal["HONOR", "GLORY", "WISDOM"]

{valentina_python_client-1.4.0 → valentina_python_client-1.4.1}/src/vclient/models/__init__.py

@@ -95,13 +95,13 @@ from .global_admin import (
 )
 from .pagination import PaginatedResponse
 from .shared import (
+    Asset,
     CharacterSpecialty,
     NameDescriptionSubDocument,
     Note,
     NoteCreate,
     NoteUpdate,
     RollStatistics,
-    S3Asset,
     Trait,
     WerewolfGift,
     WerewolfRite,
@@ -120,6 +120,7 @@ from .users import (
 )
 
 __all__ = [
+    "Asset",
     "BookCreate",
     "BookUpdate",
     "Campaign",
@@ -183,7 +184,6 @@ __all__ = [
     "QuickrollCreate",
     "QuickrollUpdate",
     "RollStatistics",
-    "S3Asset",
     "SheetSection",
     "SystemHealth",
     "Trait",

{valentina_python_client-1.4.0 → valentina_python_client-1.4.1}/src/vclient/models/shared.py

@@ -6,10 +6,10 @@ from typing import Annotated, Any
 from pydantic import BaseModel, Field
 
 from vclient.constants import (
+    AssetParentType,
+    AssetType,
     CharacterClass,
     GameVersion,
-    S3AssetParentType,
-    S3AssetType,
     SpecialtyType,
     WerewolfRenown,
 )
@@ -31,7 +31,7 @@ class NameDescriptionSubDocument(BaseModel):
 # -----------------------------------------------------------------------------
 
 
-class S3Asset(BaseModel):
+class Asset(BaseModel):
     """Response model for an S3 asset.
 
     Represents a file asset stored in S3, including its URL and metadata.
@@ -40,13 +40,13 @@ class S3Asset(BaseModel):
     id: str
     date_created: datetime
     date_modified: datetime
-    asset_type: S3AssetType
+    asset_type: AssetType
     mime_type: str
     original_filename: str
     public_url: str
     uploaded_by: str
     company_id: str
-    parent_type: S3AssetParentType | None = None
+    parent_type: AssetParentType | None = None
     parent_id: str | None = None
 
 
@@ -197,13 +197,13 @@ class CharacterSpecialty(BaseModel):
 
 
 __all__ = [
+    "Asset",
     "CharacterSpecialty",
     "NameDescriptionSubDocument",
     "Note",
     "NoteCreate",
     "NoteUpdate",
     "RollStatistics",
-    "S3Asset",
     "Trait",
     "WerewolfGift",
     "WerewolfRite",

{valentina_python_client-1.4.0 → valentina_python_client-1.4.1}/src/vclient/services/campaign_book_chapters.py

@@ -7,6 +7,7 @@ from typing import TYPE_CHECKING
 from vclient.constants import DEFAULT_PAGE_LIMIT
 from vclient.endpoints import Endpoints
 from vclient.models import (
+    Asset,
     CampaignChapter,
     ChapterCreate,
     ChapterUpdate,
@@ -14,7 +15,6 @@ from vclient.models import (
     NoteCreate,
     NoteUpdate,
     PaginatedResponse,
-    S3Asset,
     _ChapterRenumber,
 )
 from vclient.services.base import BaseService
@@ -348,7 +348,7 @@ class ChaptersService(BaseService):
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
-    ) -> PaginatedResponse[S3Asset]:
+    ) -> PaginatedResponse[Asset]:
         """Retrieve a paginated list of assets for a chapter.
 
         Args:
@@ -357,7 +357,7 @@ class ChaptersService(BaseService):
             offset: Number of items to skip from the beginning (default 0).
 
         Returns:
-            A PaginatedResponse containing S3Asset objects and pagination metadata.
+            A PaginatedResponse containing Asset objects and pagination metadata.
 
         Raises:
             NotFoundError: If the chapter does not exist.
@@ -365,7 +365,7 @@ class ChaptersService(BaseService):
         """
         return await self._get_paginated_as(
             self._format_endpoint(Endpoints.BOOK_CHAPTER_ASSETS, chapter_id=chapter_id),
-            S3Asset,
+            Asset,
             limit=limit,
             offset=offset,
         )
@@ -374,7 +374,7 @@ class ChaptersService(BaseService):
         self,
         chapter_id: str,
         asset_id: str,
-    ) -> S3Asset:
+    ) -> Asset:
         """Retrieve details of a specific asset including its URL and metadata.
 
         Args:
@@ -382,7 +382,7 @@ class ChaptersService(BaseService):
             asset_id: The ID of the asset to retrieve.
 
         Returns:
-            The S3Asset object with full details.
+            The Asset object with full details.
 
         Raises:
             NotFoundError: If the asset does not exist.
@@ -393,7 +393,7 @@ class ChaptersService(BaseService):
                 Endpoints.BOOK_CHAPTER_ASSET, chapter_id=chapter_id, asset_id=asset_id
             )
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def upload_asset(
         self,
@@ -401,7 +401,7 @@ class ChaptersService(BaseService):
         filename: str,
         content: bytes,
         content_type: str | None = None,
-    ) -> S3Asset:
+    ) -> Asset:
         """Upload a new asset for a chapter.
 
         Uploads a file to S3 storage and associates it with the chapter.
@@ -413,7 +413,7 @@ class ChaptersService(BaseService):
             content_type: The MIME type of the file. If not provided, inferred from filename.
 
         Returns:
-            The created S3Asset object with the public URL and metadata.
+            The created Asset object with the public URL and metadata.
 
         Raises:
             NotFoundError: If the chapter does not exist.
@@ -427,7 +427,7 @@ class ChaptersService(BaseService):
             self._format_endpoint(Endpoints.BOOK_CHAPTER_ASSET_UPLOAD, chapter_id=chapter_id),
             file=(filename, content, content_type),
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def delete_asset(
         self,

{valentina_python_client-1.4.0 → valentina_python_client-1.4.1}/src/vclient/services/campaign_books.py

@@ -7,6 +7,7 @@ from typing import TYPE_CHECKING
 from vclient.constants import DEFAULT_PAGE_LIMIT
 from vclient.endpoints import Endpoints
 from vclient.models import (
+    Asset,
     BookCreate,
     BookUpdate,
     CampaignBook,
@@ -14,7 +15,6 @@ from vclient.models import (
     NoteCreate,
     NoteUpdate,
     PaginatedResponse,
-    S3Asset,
     _BookRenumber,
 )
 from vclient.services.base import BaseService
@@ -444,7 +444,7 @@ class BooksService(BaseService):
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
-    ) -> PaginatedResponse[S3Asset]:
+    ) -> PaginatedResponse[Asset]:
         """Retrieve a paginated list of assets for a book.
 
         Args:
@@ -453,7 +453,7 @@ class BooksService(BaseService):
             offset: Number of items to skip from the beginning (default 0).
 
         Returns:
-            A PaginatedResponse containing S3Asset objects and pagination metadata.
+            A PaginatedResponse containing Asset objects and pagination metadata.
 
         Raises:
             NotFoundError: If the book does not exist.
@@ -461,7 +461,7 @@ class BooksService(BaseService):
         """
         return await self._get_paginated_as(
             self._format_endpoint(Endpoints.BOOK_ASSETS, book_id=book_id),
-            S3Asset,
+            Asset,
             limit=limit,
             offset=offset,
         )
@@ -470,7 +470,7 @@ class BooksService(BaseService):
         self,
         book_id: str,
         asset_id: str,
-    ) -> S3Asset:
+    ) -> Asset:
         """Retrieve details of a specific asset including its URL and metadata.
 
         Args:
@@ -478,7 +478,7 @@ class BooksService(BaseService):
             asset_id: The ID of the asset to retrieve.
 
         Returns:
-            The S3Asset object with full details.
+            The Asset object with full details.
 
         Raises:
             NotFoundError: If the asset does not exist.
@@ -487,7 +487,7 @@ class BooksService(BaseService):
         response = await self._get(
             self._format_endpoint(Endpoints.BOOK_ASSET, book_id=book_id, asset_id=asset_id)
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def upload_asset(
         self,
@@ -495,7 +495,7 @@ class BooksService(BaseService):
         filename: str,
         content: bytes,
         content_type: str | None = None,
-    ) -> S3Asset:
+    ) -> Asset:
         """Upload a new asset for a book.
 
         Uploads a file to S3 storage and associates it with the book.
@@ -507,7 +507,7 @@ class BooksService(BaseService):
             content_type: The MIME type of the file. If not provided, inferred from filename.
 
         Returns:
-            The created S3Asset object with the public URL and metadata.
+            The created Asset object with the public URL and metadata.
 
         Raises:
             NotFoundError: If the book does not exist.
@@ -521,7 +521,7 @@ class BooksService(BaseService):
             self._format_endpoint(Endpoints.BOOK_ASSET_UPLOAD, book_id=book_id),
             file=(filename, content, content_type),
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def delete_asset(
         self,

{valentina_python_client-1.4.0 → valentina_python_client-1.4.1}/src/vclient/services/campaigns.py

@@ -7,6 +7,7 @@ from typing import TYPE_CHECKING
 from vclient.constants import DEFAULT_PAGE_LIMIT
 from vclient.endpoints import Endpoints
 from vclient.models import (
+    Asset,
     Campaign,
     CampaignCreate,
     CampaignUpdate,
@@ -15,7 +16,6 @@ from vclient.models import (
     NoteUpdate,
     PaginatedResponse,
     RollStatistics,
-    S3Asset,
 )
 from vclient.services.base import BaseService
 
@@ -255,7 +255,7 @@ class CampaignsService(BaseService):
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
-    ) -> PaginatedResponse[S3Asset]:
+    ) -> PaginatedResponse[Asset]:
         """Retrieve a paginated list of assets for a campaign.
 
         Args:
@@ -264,7 +264,7 @@ class CampaignsService(BaseService):
             offset: Number of items to skip from the beginning (default 0).
 
         Returns:
-            A PaginatedResponse containing S3Asset objects and pagination metadata.
+            A PaginatedResponse containing Asset objects and pagination metadata.
 
         Raises:
             NotFoundError: If the campaign does not exist.
@@ -272,7 +272,7 @@ class CampaignsService(BaseService):
         """
         return await self._get_paginated_as(
             self._format_endpoint(Endpoints.CAMPAIGN_ASSETS, campaign_id=campaign_id),
-            S3Asset,
+            Asset,
             limit=limit,
             offset=offset,
         )
@@ -281,7 +281,7 @@ class CampaignsService(BaseService):
         self,
         campaign_id: str,
         asset_id: str,
-    ) -> S3Asset:
+    ) -> Asset:
         """Retrieve details of a specific asset including its URL and metadata.
 
         Args:
@@ -289,7 +289,7 @@ class CampaignsService(BaseService):
             asset_id: The ID of the asset to retrieve.
 
         Returns:
-            The S3Asset object with full details.
+            The Asset object with full details.
 
         Raises:
             NotFoundError: If the asset does not exist.
@@ -300,7 +300,7 @@ class CampaignsService(BaseService):
                 Endpoints.CAMPAIGN_ASSET, campaign_id=campaign_id, asset_id=asset_id
             )
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def delete_asset(
         self,
@@ -331,7 +331,7 @@ class CampaignsService(BaseService):
         filename: str,
         content: bytes,
         content_type: str | None = None,
-    ) -> S3Asset:
+    ) -> Asset:
         """Upload a new asset for a campaign.
 
         Uploads a file to S3 storage and associates it with the campaign.
@@ -343,7 +343,7 @@ class CampaignsService(BaseService):
             content_type: The MIME type of the file. If not provided, inferred from filename.
 
         Returns:
-            The created S3Asset object with the public URL and metadata.
+            The created Asset object with the public URL and metadata.
 
         Raises:
             NotFoundError: If the campaign does not exist.
@@ -357,7 +357,7 @@ class CampaignsService(BaseService):
             self._format_endpoint(Endpoints.CAMPAIGN_ASSET_UPLOAD, campaign_id=campaign_id),
             file=(filename, content, content_type),
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     # -------------------------------------------------------------------------
     # Notes Methods

{valentina_python_client-1.4.0 → valentina_python_client-1.4.1}/src/vclient/services/characters.py

@@ -12,6 +12,7 @@ from vclient.constants import (
 )
 from vclient.endpoints import Endpoints
 from vclient.models import (
+    Asset,
     Character,
     CharacterCreate,
     CharacterUpdate,
@@ -25,7 +26,6 @@ from vclient.models import (
     PaginatedResponse,
     Perk,
     RollStatistics,
-    S3Asset,
     WerewolfGift,
     WerewolfRite,
 )
@@ -339,7 +339,7 @@ class CharactersService(BaseService):
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
-    ) -> PaginatedResponse[S3Asset]:
+    ) -> PaginatedResponse[Asset]:
         """Retrieve a paginated list of assets for a campaign.
 
         Args:
@@ -348,7 +348,7 @@ class CharactersService(BaseService):
             offset: Number of items to skip from the beginning (default 0).
 
         Returns:
-            A PaginatedResponse containing S3Asset objects and pagination metadata.
+            A PaginatedResponse containing Asset objects and pagination metadata.
 
         Raises:
             NotFoundError: If the campaign does not exist.
@@ -356,7 +356,7 @@ class CharactersService(BaseService):
         """
         return await self._get_paginated_as(
             self._format_endpoint(Endpoints.CHARACTER_ASSETS, character_id=character_id),
-            S3Asset,
+            Asset,
             limit=limit,
             offset=offset,
         )
@@ -365,7 +365,7 @@ class CharactersService(BaseService):
         self,
         character_id: str,
         asset_id: str,
-    ) -> S3Asset:
+    ) -> Asset:
         """Retrieve details of a specific asset including its URL and metadata.
 
         Args:
@@ -373,7 +373,7 @@ class CharactersService(BaseService):
             asset_id: The ID of the asset to retrieve.
 
         Returns:
-            The S3Asset object with full details.
+            The Asset object with full details.
 
         Raises:
             NotFoundError: If the asset does not exist.
@@ -384,7 +384,7 @@ class CharactersService(BaseService):
                 Endpoints.CHARACTER_ASSET, character_id=character_id, asset_id=asset_id
             )
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def delete_asset(
         self,
@@ -415,7 +415,7 @@ class CharactersService(BaseService):
         filename: str,
         content: bytes,
         content_type: str | None = None,
-    ) -> S3Asset:
+    ) -> Asset:
         """Upload a new asset for a campaign.
 
         Uploads a file to S3 storage and associates it with the campaign.
@@ -427,7 +427,7 @@ class CharactersService(BaseService):
             content_type: The MIME type of the file. If not provided, inferred from filename.
 
         Returns:
-            The created S3Asset object with the public URL and metadata.
+            The created Asset object with the public URL and metadata.
 
         Raises:
             NotFoundError: If the character does not exist.
@@ -441,7 +441,7 @@ class CharactersService(BaseService):
             self._format_endpoint(Endpoints.CHARACTER_ASSET_UPLOAD, character_id=character_id),
             file=(filename, content, content_type),
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     # -------------------------------------------------------------------------
     # Notes Methods

{valentina_python_client-1.4.0 → valentina_python_client-1.4.1}/src/vclient/services/users.py

@@ -7,6 +7,7 @@ from typing import TYPE_CHECKING
 from vclient.constants import DEFAULT_PAGE_LIMIT, UserRole
 from vclient.endpoints import Endpoints
 from vclient.models import (
+    Asset,
     CampaignExperience,
     Note,
     NoteCreate,
@@ -16,7 +17,6 @@ from vclient.models import (
     QuickrollCreate,
     QuickrollUpdate,
     RollStatistics,
-    S3Asset,
     User,
     UserCreate,
     UserUpdate,
@@ -281,7 +281,7 @@ class UsersService(BaseService):
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
-    ) -> PaginatedResponse[S3Asset]:
+    ) -> PaginatedResponse[Asset]:
         """Retrieve a paginated list of assets for a user.
 
         Args:
@@ -290,7 +290,7 @@ class UsersService(BaseService):
             offset: Number of items to skip from the beginning (default 0).
 
         Returns:
-            A PaginatedResponse containing S3Asset objects and pagination metadata.
+            A PaginatedResponse containing Asset objects and pagination metadata.
 
         Raises:
             NotFoundError: If the user does not exist.
@@ -298,7 +298,7 @@ class UsersService(BaseService):
         """
         return await self._get_paginated_as(
             self._format_endpoint(Endpoints.USER_ASSETS, user_id=user_id),
-            S3Asset,
+            Asset,
             limit=limit,
             offset=offset,
         )
@@ -307,7 +307,7 @@ class UsersService(BaseService):
         self,
         user_id: str,
         asset_id: str,
-    ) -> S3Asset:
+    ) -> Asset:
         """Retrieve details of a specific asset including its URL and metadata.
 
         Args:
@@ -315,7 +315,7 @@ class UsersService(BaseService):
             asset_id: The ID of the asset to retrieve.
 
         Returns:
-            The S3Asset object with full details.
+            The Asset object with full details.
 
         Raises:
             NotFoundError: If the asset does not exist.
@@ -324,7 +324,7 @@ class UsersService(BaseService):
         response = await self._get(
             self._format_endpoint(Endpoints.USER_ASSET, user_id=user_id, asset_id=asset_id)
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def delete_asset(
         self,
@@ -353,7 +353,7 @@ class UsersService(BaseService):
         filename: str,
         content: bytes,
         content_type: str | None = None,
-    ) -> S3Asset:
+    ) -> Asset:
         """Upload a new asset for a user.
 
         Uploads a file to S3 storage and associates it with the user.
@@ -365,7 +365,7 @@ class UsersService(BaseService):
             content_type: The MIME type of the file. If not provided, inferred from filename.
 
         Returns:
-            The created S3Asset object with the public URL and metadata.
+            The created Asset object with the public URL and metadata.
 
         Raises:
             NotFoundError: If the user does not exist.
@@ -379,7 +379,7 @@ class UsersService(BaseService):
             self._format_endpoint(Endpoints.USER_ASSET_UPLOAD, user_id=user_id),
             file=(filename, content, content_type),
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     # -------------------------------------------------------------------------
     # Experience Methods

{valentina_python_client-1.4.0 → valentina_python_client-1.4.1}/src/vclient/validate_constants.py

@@ -77,8 +77,8 @@ CONSTANT_MAP: dict[str, ConstantMapping] = {
     "ManageCampaignPermission": ConstantMapping("companies", "PermissionManageCampaign"),
     "PermissionLevel": ConstantMapping("companies", "CompanyPermission"),
     "RollResultType": ConstantMapping("gameplay", "RollResultType"),
-    "S3AssetParentType": ConstantMapping("assets", "AssetParentType"),
-    "S3AssetType": ConstantMapping("assets", "AssetType"),
+    "AssetParentType": ConstantMapping("assets", "AssetParentType"),
+    "AssetType": ConstantMapping("assets", "AssetType"),
     "SpecialtyType": ConstantMapping("characters", "SpecialtyType"),
     "TraitModifyCurrency": ConstantMapping("characters", "TraitModifyCurrency"),
     "UserRole": ConstantMapping("users", "UserRole"),