Merge pull request #36 from meower-community/async-cl3

Ver 3.0.0

.vscode/settings.json

@@ -3,6 +3,6 @@
     "python.linting.banditEnabled": true,
     "python.linting.enabled": true,
     "[python]": {
-        "editor.defaultFormatter": "ms-python.autopep8"
+        "editor.defaultFormatter": "ms-python.python"
     }
 }

MeowerBot/API.py

@@ -1,45 +1,355 @@
-import requests
-from urllib.parse import urljoin
 
+from urllib.parse import urljoin
+from httpx import AsyncClient, Auth
+import ujson as json
+from .types import generic
+from .types.api.reports import ReportRequest, Report, AdminNotesResponse, PagedRequest
+from .types.generic import Post
+from .types.api.chats import Chats, ChatGroup
+from .types.api.user import User, Relationship
+from typing import Literal
+from httpx import Response
 
 class MeowerAPI:
     base_uri = "https://api.meower.org/"
 
     def __init__(self, username):
+        self.headers = {"username": username, "user-agent": 'Mozilla/5.0 (Android 14; Mobile; rv:109.0) Gecko/118.0 Firefox/118.0'}
+        self.client = AsyncClient(headers=self.headers, base_url=self.base_uri, follow_redirects=True)
+
+
+
+
+    async def login(self, token):
+        self.client.headers.update({"token": token})
+
+    async def admin_get_reports(self, timeout=None) -> ReportRequest:
+        resp = await self.client.get("/admin/reports", timeout=timeout, params={"autoget": None})
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Not found") 
+
+        return ReportRequest.from_json(
+            resp.text
+        )
+
+    async def admin_get_report(self, uuid: generic.UUID) -> Report:
+        resp = await self.client.get(f"/admin/reports/{uuid}/", params={"autoget": None})
+
+        if resp.status_code == 403:
+            raise RuntimeError("[API] 403 Found: You are not allowed to look at reports")
+
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Not found") 
+
+        return Report.from_json(resp.text)
+
+    async def admin_edit_report(self, uuid: generic.UUID, status: Literal["no_action_taken", "action_taken"]) -> Report:
+        resp = await self.client.patch(f"/admin/reports/{uuid}", json={"status": status})
+
+        if resp.status_code == 403:
+            raise RuntimeError("[API] 403 Found: You are not allowed to edit reports")
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Not found") 
+
+        return Report.from_json(resp.text)
+
+    async def admin_escalate_report(self, uuid: generic.UUID) -> Report:
+        resp = await self.client.post(f"/admin/reports/{uuid}/escalate/")
+        if resp.status_code == 403:
+            raise RuntimeError("[API] 403 Found: You are not allowed to edit reports")
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Not found") 
+
+        return Report.from_json(resp.text)
+
+    async def admin_fetch_note(self, indentifier: str) -> AdminNotesResponse:
+        resp = await self.client.get(f"/admin/notes/{indentifier}", params={"autoget": None})
+
+        if resp.status_code == 403:
+            raise RuntimeError("[API] 403 Found: You are not allowed to look at notes")
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Not found") 
+
+        return AdminNotesResponse.from_json(resp.text)
+
+    async def admin_create_note(self, indentifier: str, notes: str) -> AdminNotesResponse:
+        resp = await self.client.put(f"/admin/notes/{indentifier}", json={"notes": notes})
+        if resp.status_code == 403:
+            raise RuntimeError("[API] 403 Found: You are not allowed to edit/create notes")
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Not found") 
+
+        return AdminNotesResponse.from_json(resp.text)
+
+    async def admin_get_post(self, uuid: generic.UUID) -> Post:
+        resp = await self.client.get(f"/admin/posts/{uuid}", params={"autoget": None})
+        if resp.status_code == 403:
+            raise RuntimeError("[API] 403 Found: You are not allowed to look at posts")
+
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Not found") 
+
+        return Post.from_json(resp.text)
+
+    async def admin_delete_post(self, uuid: generic.UUID) -> Post:
+        resp = await self.client.delete(f"/admin/posts/{uuid}")
+        if resp.status_code == 403:
+            raise RuntimeError("[API] 403 Found: You are not allowed to delete posts")
+
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Not found") 
+
+        return Post.from_json(resp.text)
+
+    async def admin_restore_deleted_post(self, uuid: generic.UUID) -> Post:
+        resp = await self.client.post(f"/admin/posts/{uuid}/restore")
+        if resp.status_code == 403:
+            raise RuntimeError("[API] 403 Found: You are not allowed to restore posts")
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Not found") 
+
+        return Post.from_json(resp.text)
+
+
+
+    async def get_chats(self) -> Chats:
+        resp = await self.client.get(f"/chats/", params={"autoget": None})
+
+        if resp.status_code == 401:
+            raise RuntimeError("[API] No Token or username supplied! This is required to send authenticated API requests")
+
+        return Chats.from_json(resp.text)
+
+    async def create_chat(self, nickname: str) -> ChatGroup:
+        resp = await self.client.post(f"/chats/", json={"nickname": nickname})
+
+        if resp.status_code == 401:
+            raise RuntimeError(json.parse(resp.text)["type"])
+
+        return ChatGroup.from_json(resp.text)
+
+    async def get_chat(self, uuid: generic.UUID) -> ChatGroup:
+        resp = await self.client.get(f"/chats/{uuid}", params={"autoget": None})
+
+        if resp.status_code == 401:
+            raise RuntimeError("[API] No Token or username supplied! This is required to send authenticated API requests")
+
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Chat Not found") 
+
+        return ChatGroup.from_json(resp.text)
+
+    async def update_chat(self, uuid: generic.UUID, nickname: str) -> ChatGroup:
+        resp = await self.client.patch(f"/chats/{uuid}", josn={"nickname": nickname})
+
+        if resp.status_code == 429:
+            raise RuntimeError("[API] Ratelimited: Updating chat")
+
+
+        if resp.status_code == 401:
+            raise RuntimeError("[API] No Auth to do this action")
+
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Chat Not found") 
+
+
+        return ChatGroup.from_json(resp.text)
+
+    async def leave_chat(self, uuid: generic.UUID) -> dict:
+        resp = await self.client.delete(f"/chats/{uuid}")
+
+
+        if resp.status_code == 429:
+            raise RuntimeError("[API] Ratelimited: Updating chat")
+
+
+        if resp.status_code == 401:
+            raise RuntimeError("[API] No Auth to do this action")
+
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Chat Not found") 
+
+        return {"error": False}
+
+    async def add_user_to_chat(self, uuid: generic.UUID, username: str) -> ChatGroup:
+        resp = await self.client.put(f"/chats/{uuid}/members/{username}")
+
+        if resp.status_code == 429:
+            raise RuntimeError("[API] Ratelimited: Updating chat")
+
+
+        if resp.status_code == 401:
+            raise RuntimeError("[API] No Auth to do this action")
+
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Chat Not found") 
+
+        return ChatGroup.from_json(resp.text)
+
+    async def transfer_chat_ownership(self, uuid: generic.UUID, username: str) -> ChatGroup:
+        resp = await self.client.post(f"/chats/{uuid}/members/{username}/transfer")
+
+        if resp.status_code == 429:
+            raise RuntimeError("[API] Ratelimited: Updating chat")
+
 
-        self.session = requests.session()
-        self.session.headers.update({"usename": username})
+        if resp.status_code == 401:
+            raise RuntimeError("[API] No Auth to do this action")
 
-    def login(self, token):
-        self.session.headers.update({"token": token})
 
-    def get_page(self, page=1, chatid="home"):
-        if chatid == "home":
-            return self.session.get(
-                urljoin(self.base_uri, "/home?autoget&page={0}".format(page))
-            ).json()
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Chat Not found") 
+
+        return ChatGroup.from_json(resp.text)
+
+    async def get_posts(self, chat: str | generic.UUID, page: int = 1) -> PagedRequest[Post]:
+        if chat == "home":
+            resp = await self.client.get(f"/home/", params={"page": page, "autoget": None})
+        else:
+            resp = await self.client.get(f"/posts/{chat}", params={"page": page, "autoget": None})
+
+        if resp.status_code == 401:
+            raise RuntimeError("[API] No Auth to do this action")
+
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Chat Not found") 
+
+
+        return PagedRequest[Post].from_json(resp.text)
+
+    async def send_post(self, chat: str | generic.UUID, content: str) -> Post:
+        if chat == "home":
+            resp = await self.client.post(f"/home/", json={"content": content})
         else:
-            return self.session.get(
-                urljoin(
-                    self.base_uri, "/posts/{0}?autoget&page={1}".format(chatid, page)
-                )
-            ).json()
-
-    def get_user(self, username):
-        return self.session.get(
-            urljoin(self.base_uri, "/users/{0}".format(username))
-        ).json()
-
-    def get_user_posts(self, username, page=1):
-        return self.session.get(
-            urljoin(
-                self.base_uri,
-                "/users/{0}/posts?autoget&page={1}".format(username, page),
-            )
-        ).json()
-
-    def statistics(self):
-        return self.session.get(urljoin(self.base_uri, "statistics")).json()
-
-    def status(self):
-        return self.session.get(urljoin(self.base_uri, "/status")).json()
+            resp = await self.client.post(f"/posts/{chat}", json={"content": content})
+
+        print(resp.text, resp.status_code)
+        if resp.status_code == 429:
+            raise RuntimeError("[API] Ratelimited: Sending posts")
+
+
+        if resp.status_code == 401:
+            raise RuntimeError("[API] No Auth to do this action")
+
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Chat Not found") 
+
+        print(resp.text)
+        return Post.from_json(resp.text)
+
+    async def get_post(self, uuid: generic.UUID) -> Post:
+        resp = await self.client.get(f"/posts", params={"id": uuid})
+
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Post Not found") 
+
+        return Post.from_json(resp.text)
+
+    async def update_post(self, uuid: generic.UUID,  content: str) -> Post:
+        resp = await self.client.patch(f"/posts", params={"id": uuid}, json={"content": content})
+
+        if resp.status_code == 429:
+            raise RuntimeError("[API] Ratelimited: Sending posts")
+
+
+        if resp.status_code == 401:
+            raise RuntimeError("[API] No Auth to do this action")
+
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Post Not found") 
+
+        return Post.from_json(resp.text)
+
+    async def delete_post(self, uuid: generic.UUID) -> Post:
+        resp = await self.client.patch(f"/posts", params={"id": uuid})
+
+        if resp.status_code == 429:
+            raise RuntimeError("[API] Ratelimited: Deleting posts")
+
+
+        if resp.status_code == 401:
+            raise RuntimeError("[API] No Auth to do this action")
+
+
+        if resp.status_code == 404: 
+            raise RuntimeError("[API] 404 Post Not found") 
+
+        return Post.from_json(resp.text)
+
+    async def get_inbox(self) -> PagedRequest[Post]:
+        resp = await self.client.get("/inbox", params={"autoget": None})
+
+        if resp.status_code == 401:
+            raise RuntimeError("[API] No Auth to do this action")
+
+        return PagedRequest[Post].from_json(resp.text)
+
+    async def search_users(self, query: str, page: int = 1 ) -> PagedRequest[User]:
+        resp = await self.client.get("/search/users", params={"q": query, "p": page,"autoget": None},)
+
+        return PagedRequest[User].from_json(resp.text)
+
+    async def search_home(self, query: str, page: int = 1) -> PagedRequest[Post]:
+        resp = await self.client.get("/search/home", params={"q": query, "p": page, "autoget": None})
+        return PagedRequest[Post].from_json(resp.text)
+
+    # TODO: Implement wrapper for https://github.com/meower-media-co/Meower-Server/blob/better-moderation/rest_api/admin.py#L74-L1564
+    # TODO: https://github.com/meower-media-co/Meower-Server/blob/better-moderation/rest_api/users.py
+
+    async def _get_user(self, username, url, json=None, page=1, query = None, params=None):
+        resp: Response = await self.client.get(urljoin(f"/users/{username}/", url), json=json, params={"q": query, "p": page, **params})
+        if resp.status_code == 404:
+            raise RuntimeError("[API] User does not exist")
+
+        if resp.status_code == 401:
+            raise RuntimeError("[API] No Auth to do this action")
+
+
+        if resp.status_code == 429:
+            raise RuntimeError("[API] Ratelimited: Updating chat")
+
+        if resp.status_code == 403:
+            raise RuntimeError("[API] Blocked from doing this action")
+
+        return resp._text
+
+    async def get_user_posts(self, username, query, page = 1) -> PagedRequest[Post]:
+        return PagedRequest[Post].from_json(await self._get_user(username, "posts", query=query, page=page, params={"autoget": None}))
+
+    async def get_user_relationship(self, username) -> Relationship:
+        return Relationship.from_json(await self._get_user(username, "relationship"))
+
+    async def edit_user_relationship(self, username, state: Literal[0, 1, 2]) -> Relationship:
+        resp = await self.client.patch(f"/users/{username}/relationship", json={"state": state})
+
+        if resp.status_code == 404:
+            raise RuntimeError("[API] User does not exist")
+
+        if resp.status_code == 401:
+            raise RuntimeError("[API] No Auth to do this action")
+
+
+
+
+
+        return Relationship.from_json(resp.text)
+
+    async def dm_user(self, username) -> ChatGroup:
+        return ChatGroup.from_json(self._get_user(username, 'dm'))