aioe621 0.2.0__tar.gz → 0.2.2__tar.gz

{aioe621-0.2.0 → aioe621-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: aioe621
-Version: 0.2.0
+Version: 0.2.2
 Summary: A simple asynchronous httpx+pydantic wrapper over the E621's API
 Keywords: async,httpx,e621
 Author: penggrin12
@@ -40,3 +40,47 @@ Requires-Dist: httpx>=0.28.1
 Requires-Dist: pydantic>=2.13.4
 Requires-Python: >=3.10
 Project-URL: Homepage, https://github.com/penggrin12/aioe621
+Description-Content-Type: text/markdown
+
+# aioe621 ![uv](https://img.shields.io/badge/uv-261230.svg?logo=uv&logoColor=#de5fe9)
+
+![PyPI Python Version](https://img.shields.io/pypi/pyversions/aioe621)
+
+![GitHub License](https://img.shields.io/github/license/penggrin12/aioe621)
+![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/penggrin12/aioe621/release.yml)
+
+A simple asynchronous httpx+pydantic wrapper over the E621's API
+
+## Quickstart
+
+```python
+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 other Client parameters are also optional
+client = Client(
+    auth=auth,
+    user_agent="MyProject/1.0 (by username on e621)"
+)
+
+
+async def main() -> None:
+    post: Post = await client.posts.get(id=5937863)
+    print(f"i love {post.tags.artist[0]}!!!")
+
+
+asyncio.run(main())
+```
+
+## Currently implemented
+
+- [x] `GET /posts.json` via `.posts.list`
+- [x] `GET /posts/{id}.json` via `.posts.get`
+- [x] `GET /posts/random.json` via `.posts.random`

aioe621-0.2.2/README.md

@@ -0,0 +1,42 @@
+# aioe621 ![uv](https://img.shields.io/badge/uv-261230.svg?logo=uv&logoColor=#de5fe9)
+
+![PyPI Python Version](https://img.shields.io/pypi/pyversions/aioe621)
+
+![GitHub License](https://img.shields.io/github/license/penggrin12/aioe621)
+![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/penggrin12/aioe621/release.yml)
+
+A simple asynchronous httpx+pydantic wrapper over the E621's API
+
+## Quickstart
+
+```python
+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 other Client parameters are also optional
+client = Client(
+    auth=auth,
+    user_agent="MyProject/1.0 (by username on e621)"
+)
+
+
+async def main() -> None:
+    post: Post = await client.posts.get(id=5937863)
+    print(f"i love {post.tags.artist[0]}!!!")
+
+
+asyncio.run(main())
+```
+
+## Currently implemented
+
+- [x] `GET /posts.json` via `.posts.list`
+- [x] `GET /posts/{id}.json` via `.posts.get`
+- [x] `GET /posts/random.json` via `.posts.random`

{aioe621-0.2.0 → aioe621-0.2.2}/pyproject.toml

@@ -1,8 +1,9 @@
 [project]
 name = "aioe621"
-version = "0.2.0"
+version = "0.2.2"
 description = "A simple asynchronous httpx+pydantic wrapper over the E621's API"
 license = { file = "LICENSE" }
+readme = "README.md"
 keywords = ["async", "httpx", "e621"]
 authors = [
     { name = "penggrin12", email = "miner.sidor@gmail.com" }
@@ -35,4 +36,5 @@ build-backend = "uv_build"
 dev = [
     "ruff>=0.15.21",
     "pyrefly>=0.60.0",
+    "respx>=0.23.1",
 ]

aioe621-0.2.2/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.0 → aioe621-0.2.2}/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.2/src/aioe621/endpoints/__init__.py

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

{aioe621-0.2.0 → aioe621-0.2.2}/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.0 → aioe621-0.2.2}/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.0 → aioe621-0.2.2}/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.0/src/aioe621/__init__.py

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