aioe621 0.1.0__py3-none-any.whl

aioe621/__init__.py

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

aioe621/client.py

@@ -0,0 +1,61 @@
+import base64
+import typing
+
+import httpx
+from pydantic import BaseModel
+
+from .endpoints.posts import Posts
+
+if typing.TYPE_CHECKING:
+    from .schemas import Auth
+
+
+class Client:
+    E621_BASE_URL = "https://e621.net"
+    E926_BASE_URL = "https://e926.net"
+
+    def __init__(
+        self,
+        auth: "Auth",
+        base_url: str = E621_BASE_URL,
+        user_agent: str | None = None,
+        session: httpx.AsyncClient | None = None,
+        **session_kwargs,
+    ) -> None:
+        self.auth = auth
+        self.user_agent = user_agent or "penggrin12/aioe621@github penggrin@telegram"
+        self.session = session or httpx.AsyncClient(base_url=base_url, **session_kwargs)
+
+        self.posts = Posts(self)
+
+    def _get_auth_header_value(self) -> str:
+        return base64.b64encode(
+            f"{self.auth.username}:{self.auth.api_key}".encode()
+        ).decode()
+
+    async def _request(
+        self, method: str, url: str, *, authorized: bool = False, **params
+    ) -> str:
+        response = await self.session.request(
+            method,
+            url,
+            params={k: v for k, v in params.items() if v is not None},
+            headers={
+                "User-Agent": self.user_agent,
+                **(
+                    {"Authorization": self._get_auth_header_value()}
+                    if authorized
+                    else {}
+                ),
+            },
+        )
+        return response.text
+
+    _MT = typing.TypeVar("_MT", bound="BaseModel")
+
+    async def _request_model(
+        self, model: type[_MT], method: str, url: str, **kwargs
+    ) -> _MT:
+        return model.model_validate_json(
+            await self._request(method=method, url=url, **kwargs)
+        )

aioe621/endpoints/endpoint.py

@@ -0,0 +1,12 @@
+import typing
+
+if typing.TYPE_CHECKING:
+    from ..client import Client
+
+
+class Endpoint:
+    def __init__(self, client: "Client") -> None:
+        self._client = client
+
+        self._request = client._request
+        self._request_model = self._client._request_model

aioe621/endpoints/posts.py

@@ -0,0 +1,47 @@
+from ..schemas import Post, _PostsListResponse, _PostsOnePostResponse
+from .endpoint import Endpoint
+
+
+class Posts(Endpoint):
+    async def list(
+        self,
+        tags: list[str] | str,
+        limit: int | None = None,
+        page: int | None = None,
+    ) -> list[Post]:
+        if isinstance(tags, list):
+            tags = " ".join(tags)
+
+        return (
+            await self._request_model(
+                _PostsListResponse,
+                "GET",
+                "/posts.json",
+                tags=tags,
+                limit=limit,
+                page=page,
+            )
+        ).posts
+
+    async def get(
+        self,
+        id: int,
+    ) -> Post:
+        return (
+            await self._request_model(
+                _PostsOnePostResponse,
+                "GET",
+                f"/posts/{id}.json",
+            )
+        ).post
+
+    async def random(
+        self,
+    ) -> Post:
+        return (
+            await self._request_model(
+                _PostsOnePostResponse,
+                "GET",
+                "/posts/random.json",
+            )
+        ).post

aioe621/schemas.py

@@ -0,0 +1,128 @@
+from datetime import datetime
+from enum import Enum
+from typing import NamedTuple
+
+from pydantic import BaseModel, Field
+
+
+class Auth(NamedTuple):
+    username: str
+    api_key: str
+
+
+class BaseFile(BaseModel):
+    width: int
+    height: int
+    url: str | None = None  # Safest to make URL optional (deleted posts hide URLs)
+
+
+class File(BaseFile):
+    ext: str
+    size: int
+    md5: str
+
+
+class PreviewFile(BaseFile):
+    alt: str | None = None
+
+
+class VideoAlternate(BaseModel):
+    fps: int
+    codec: str
+    size: int
+    width: int
+    height: int
+    url: str | None = None
+
+
+class Alternates(BaseModel):
+    has: bool = False
+    original: VideoAlternate | None = None
+    variants: dict[str, VideoAlternate] = Field(default_factory=dict)
+    samples: dict[str, VideoAlternate] = Field(default_factory=dict)
+
+
+class SampleFile(PreviewFile):
+    has: bool
+    alternates: Alternates
+
+
+class PostScore(BaseModel):
+    up: int
+    down: int
+    total: int
+
+
+class PostTags(BaseModel):
+    general: list[str]
+    artist: list[str]
+    contributor: list[str]
+    copyright: list[str]
+    character: list[str]
+    species: list[str]
+    invalid: list[str]
+    meta: list[str]
+    lore: list[str]
+
+
+class PostFlags(BaseModel):
+    pending: bool
+    flagged: bool
+    note_locked: bool
+    status_locked: bool
+    rating_locked: bool
+    deleted: bool
+
+
+class Rating(str, Enum):
+    SAFE = "s"
+    QUESTIONABLE = "q"
+    EXPLICIT = "e"
+
+
+class Relationships(BaseModel):
+    parent_id: int | None = None
+    has_children: bool
+    has_active_children: bool
+    children: list[int]
+
+
+class Post(BaseModel):
+    id: int
+    created_at: datetime
+    updated_at: datetime
+
+    file: File
+    preview: PreviewFile
+    sample: SampleFile
+
+    score: PostScore
+    tags: PostTags
+    locked_tags: list[str]
+    change_seq: int
+    flags: PostFlags
+    rating: Rating
+
+    fav_count: int
+    sources: list[str]
+    pools: list[int]
+    relationships: Relationships
+
+    approver_id: int | None = None
+    uploader_id: int
+    uploader_name: str
+    description: str
+    comment_count: int
+    is_favorited: bool
+
+    vote: int
+    has_notes: bool
+    duration: float | None = None
+
+
+class _PostsListResponse(BaseModel):
+    posts: list[Post]
+
+
+class _PostsOnePostResponse(BaseModel):
+    post: Post

aioe621-0.1.0.dist-info/METADATA

@@ -0,0 +1,42 @@
+Metadata-Version: 2.3
+Name: aioe621
+Version: 0.1.0
+Summary: A simple asynchronous httpx+pydantic wrapper over the E621's API
+Keywords: async,httpx,e621
+Author: penggrin12
+Author-email: penggrin12 <miner.sidor@gmail.com>
+License: MIT License
+         
+         Copyright (c) 2026 penggrin12
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         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: Framework :: AsyncIO
+Classifier: Framework :: Pydantic
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: orjson>=3.11.9
+Requires-Dist: pydantic>=2.13.4
+Requires-Python: >=3.10

aioe621-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+aioe621/__init__.py,sha256=PdoDRkoDn5K74gdkc5zHQ0CZYDE058_kGwqd4EnzrPk,83
+aioe621/client.py,sha256=-xmL4qYMB60gfeuKNl16bEZRoFYBAqsp4j_N0b4HBZU,1724
+aioe621/endpoints/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+aioe621/endpoints/endpoint.py,sha256=MbDkwfGk6TJZCXCCTvcDZyoQSN5y8r1aBh8vgzL6lXM,272
+aioe621/endpoints/posts.py,sha256=mqn3OcihXjX4YbcqUi9QfTl0iCt5zMxqw1MLWaG7x9g,1098
+aioe621/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+aioe621/schemas.py,sha256=xqeW0zYp9ECzah02g9c4qdobyyAZL9eP9cY2bCnnuiY,2295
+aioe621-0.1.0.dist-info/WHEEL,sha256=CoDSoyhtC_eO_tlxRYzsTraPv1fPJRXFx91k6ISeAvA,81
+aioe621-0.1.0.dist-info/METADATA,sha256=2fqQpDkbTNbkLbQD50GsAOE4yCUYPmF6HXg3cGJf--s,2032
+aioe621-0.1.0.dist-info/RECORD,,

aioe621-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.28
+Root-Is-Purelib: true
+Tag: py3-none-any