aioe621 0.2.1__tar.gz → 0.2.3__tar.gz

{aioe621-0.2.1 → aioe621-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: aioe621
-Version: 0.2.1
+Version: 0.2.3
 Summary: A simple asynchronous httpx+pydantic wrapper over the E621's API
 Keywords: async,httpx,e621
 Author: penggrin12
@@ -58,12 +58,13 @@ from aioe621 import Client, Auth
 from aioe621.schemas import Post
 import asyncio
 
+# authentication is only needed for some endpoints
 auth = Auth(
     username="hexerade",
     api_key="1nHrmzmsvJf26EhU1F7CjnjC",
 )
 
-# all parameters are optional
+# all other Client parameters are also optional
 client = Client(
     auth=auth,
     user_agent="MyProject/1.0 (by username on e621)"

{aioe621-0.2.1 → aioe621-0.2.3}/README.md

@@ -14,12 +14,13 @@ from aioe621 import Client, Auth
 from aioe621.schemas import Post
 import asyncio
 
+# authentication is only needed for some endpoints
 auth = Auth(
     username="hexerade",
     api_key="1nHrmzmsvJf26EhU1F7CjnjC",
 )
 
-# all parameters are optional
+# all other Client parameters are also optional
 client = Client(
     auth=auth,
     user_agent="MyProject/1.0 (by username on e621)"

{aioe621-0.2.1 → aioe621-0.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "aioe621"
-version = "0.2.1"
+version = "0.2.3"
 description = "A simple asynchronous httpx+pydantic wrapper over the E621's API"
 license = { file = "LICENSE" }
 readme = "README.md"
@@ -36,4 +36,5 @@ build-backend = "uv_build"
 dev = [
     "ruff>=0.15.21",
     "pyrefly>=0.60.0",
+    "respx>=0.23.1",
 ]

aioe621-0.2.3/src/aioe621/__init__.py

@@ -0,0 +1,11 @@
+from aioe621 import client, exceptions, schemas
+from aioe621.client import Client
+from aioe621.schemas import Auth
+
+__all__: tuple[str, ...] = (
+    "client",
+    "exceptions",
+    "schemas",
+    "Client",
+    "Auth",
+)

{aioe621-0.2.1 → aioe621-0.2.3}/src/aioe621/client.py

@@ -3,11 +3,14 @@
 import httpx
 from pydantic import BaseModel
 
-from aioe621.exceptions import AccessDeniedError
-
-from .endpoints.posts import Posts
-from .exceptions import APIError, AuthenticationError, NotFoundError
-from .schemas import _ErrorResponse
+from aioe621 import endpoints
+from aioe621.exceptions import (
+    AccessDeniedError,
+    APIError,
+    AuthenticationError,
+    NotFoundError,
+)
+from aioe621.schemas import _ErrorResponse
 
 if typing.TYPE_CHECKING:
     from .schemas import Auth
@@ -35,7 +38,7 @@ class Client:
             **session_kwargs,
         )
 
-        self.posts = Posts(self)
+        self.posts = endpoints.Posts(self)
 
     def _get_headers(self) -> dict[str, str]:
         return {"User-Agent": self.user_agent}

aioe621-0.2.3/src/aioe621/endpoints/__init__.py

@@ -0,0 +1,3 @@
+from .posts import Posts
+
+__all__: tuple[str, ...] = ("Posts",)

{aioe621-0.2.1 → aioe621-0.2.3}/src/aioe621/endpoints/endpoint.py

@@ -1,7 +1,7 @@
 import typing
 
 if typing.TYPE_CHECKING:
-    from ..client import Client
+    from aioe621.client import Client
 
 
 class Endpoint:

{aioe621-0.2.1 → aioe621-0.2.3}/src/aioe621/endpoints/posts.py

@@ -1,15 +1,17 @@
-from ..schemas import Post, _PostsListResponse, _PostsOnePostResponse
-from .endpoint import Endpoint
+from typing import Iterable
+
+from aioe621.endpoints.endpoint import Endpoint
+from aioe621.schemas import Post, _PostsListResponse, _PostsOnePostResponse
 
 
 class Posts(Endpoint):
     async def list(
         self,
-        tags: list[str] | str,
+        tags: Iterable[str] | str,
         limit: int | None = None,
         page: int | None = None,
-    ) -> list[Post]:
-        if isinstance(tags, list):
+    ) -> tuple[Post, ...]:
+        if not isinstance(tags, str):
             tags = " ".join(tags)
 
         return (
@@ -23,6 +25,8 @@ class Posts(Endpoint):
             )
         ).posts
 
+    search = list
+
     async def get(
         self,
         id: int,

{aioe621-0.2.1 → aioe621-0.2.3}/src/aioe621/exceptions.py

@@ -1,4 +1,15 @@
-import httpx
+import typing
+
+if typing.TYPE_CHECKING:
+    from httpx import Response
+
+__all__: list[str] = [
+    "WrapperError",
+    "AuthenticationError",
+    "APIError",
+    "NotFoundError",
+    "AccessDeniedError",
+]
 
 
 class WrapperError(Exception):
@@ -16,7 +27,7 @@ class AuthenticationError(WrapperError):
 
 
 class APIError(Exception):
-    def __init__(self, message: str, response: httpx.Response) -> None:
+    def __init__(self, message: str, response: "Response") -> None:
         self.method = response.request.method
         self.url = response.request.url
         super().__init__(
@@ -25,10 +36,10 @@ class APIError(Exception):
 
 
 class NotFoundError(APIError):
-    def __init__(self, response: httpx.Response) -> None:
+    def __init__(self, response: "Response") -> None:
         super().__init__("Not found.", response)
 
 
 class AccessDeniedError(APIError):
-    def __init__(self, response: httpx.Response) -> None:
+    def __init__(self, response: "Response") -> None:
         super().__init__("Access denied.", response)

{aioe621-0.2.1 → aioe621-0.2.3}/src/aioe621/schemas.py

@@ -32,7 +32,7 @@ class PreviewFile(BaseFile):
 
 
 class VideoAlternate(APIModel):
-    fps: int
+    fps: float
     codec: str
     size: int
     width: int

aioe621-0.2.1/src/aioe621/__init__.py

@@ -1,4 +0,0 @@
-from .client import Client
-from .schemas import Auth
-
-__all__ = ["Client", "Auth"]