simple-rule34 0.1.6__py3-none-any.whl → 1.0.0.0__py3-none-any.whl

SimpleRule34/__init__.py

@@ -1 +1 @@
-from .Rule34 import Rule34Api
+from .main import Rule34Api

SimpleRule34/exceptions.py

@@ -1,11 +1,3 @@
-class ToBigRequestException(Exception):
-    def __init__(self, msg):
-        self.msg = msg
-
-    def __str__(self):
-        return self.msg
-
-
 class RequestMoreThanAvailableException(Exception):
     def __init__(self, msg, r_c, a_c):
         self.msg = msg

SimpleRule34/main.py

@@ -0,0 +1,207 @@
+import json
+import xml.etree.ElementTree as ET
+
+from .types import *
+
+
+class Rule34BaseApi:
+    _header = {'User-Agent': 'rule34-simple-api (Request)'}
+    _url = f"https://api.rule34.xxx/index.php"
+
+    def __init__(self, user_id: int, api_key: str, **kwargs):
+        self._params = {
+            'user_id': user_id,
+            'api_key': api_key,
+            'page': "dapi",
+            'q': "index",
+            **kwargs,
+        }
+
+    async def _get(self, json_: bool = True, **params) -> dict | str:
+        """
+        Raw request method
+
+        :return:
+        """
+
+        # API allow boolean values only in 0/1 format, so we need to convert default boolean to this format
+        json_parsed = 1 if json_ else 0
+
+        async with aiohttp.ClientSession(headers=self._header) as session:
+            async with session.get(self._url, params={**self._params, **params, 'json': json_parsed}) as response:
+                if not response.ok:
+                    raise ApiException(await response.text())
+
+                # Used for handling XML response
+                if not json_:
+                    return await response.text()
+
+                try:
+                    return await response.json()
+                except json.decoder.JSONDecodeError:
+                    raise ApiException(await response.text())
+
+
+class Rule34PostApi(Rule34BaseApi):
+    def __init__(self, user_id: int, api_key: str, **kwargs):
+        super().__init__(user_id, api_key, **kwargs)
+        self._params['s'] = "post"
+
+    async def get(self, id: int) -> Rule34Post:
+        """
+        Method used to obtain a post by its ID
+
+        :param id: Post ID
+        :return: Post
+        """
+
+        post = await self._get(id=id)
+        return Rule34Post(**post[0])
+
+    async def get_count(self, tags: list[str] = None) -> int:
+        """
+        Method used to get amount of all posts based on given tags.
+        This value also includes deleted posts, actual amount of posts may be less.
+
+        :param tags: List of tags
+        :return: Amount of posts
+        """
+
+        if tags is None:
+            tags = []
+
+        xml_data = await self._get(json_=False, tags=" ".join(tags))
+        xml_root = ET.fromstring(xml_data)
+
+        return int(xml_root.get('count'))
+
+    async def get_list(self, amount: int = 1000, page: int = 0, tags: list[str] = None,
+                       forbidden_tags: list[str] = None) -> list[Rule34Post]:
+        """
+        Method used to obtain list of posts based on given tags.
+
+        :param amount: Amount of posts that will be searched with this request
+        :param page:  Page number
+        :param tags: List of tags
+        :param forbidden_tags: List of tags posts with whom will be removed from list. When you specify forbidden tags returned amount of posts may be less than specified in amount value.
+        :return: List of posts
+        """
+
+        if tags is None:
+            tags = []
+        if forbidden_tags is None:
+            forbidden_tags = []
+
+        if amount > 1000:
+            raise ValueError(f"The max size of request is 1000 when you tried to request {amount}")
+
+        raw_list = await self._get(limit=amount, pid=page, tags=" ".join(tags))
+        post_list = [Rule34Post(**data) for data in raw_list]
+
+        # Fast return if not sort is needed
+        if len(forbidden_tags) < 1:
+            return post_list
+
+        sorted_post_list = []
+        for post in post_list:
+            if any(tag in forbidden_tags for tag in post.tags):
+                pass
+            else:
+                sorted_post_list.append(post)
+
+        return sorted_post_list
+
+
+class Rule34CommentsApi(Rule34BaseApi):
+    def __init__(self, user_id: int, api_key: str, **kwargs):
+        super().__init__(user_id, api_key, **kwargs)
+        self._params['s'] = "comment"
+
+    async def get(self, post_id: int) -> list[Rule34Comment]:
+        """
+        Method used to obtain list of comments based on given post id.
+
+        :param post_id: Post ID
+        :return: List of comments
+        """
+
+        xml_data = await self._get(post_id=post_id, json_=False)
+        xml_root = ET.fromstring(xml_data)
+
+        return [Rule34Comment(**comment_e.attrib) for comment_e in xml_root.findall("comment")]
+
+
+class Rule34TagsApi(Rule34BaseApi):
+    def __init__(self, user_id: int, api_key: str, **kwargs):
+        super().__init__(user_id, api_key, **kwargs)
+        self._params['s'] = "tag"
+
+    async def get(self, id: int) -> Rule34Tag | None:
+        """
+        Method used to obtain a tag data by its ID
+
+        :param id: Tag ID
+        :return: Tag
+        """
+
+        xml_data = await self._get(id=id, json_=False)
+        xml_root = ET.fromstring(xml_data)
+
+        raw_tag_data = xml_root.find("tag")
+        if raw_tag_data is None:
+            return None
+
+        return Rule34Tag(**raw_tag_data.attrib)
+
+    async def get_list(self, amount: int = 100, page: int = 0) -> list[Rule34Tag]:
+        """
+        Method used to obtain given amount of tags.
+
+        :param amount: Amount of tags you want to obtain
+        :return: List of tags
+        """
+
+        xml_data = await self._get(json_=False, limit=amount, pid=page)
+        xml_root = ET.fromstring(xml_data)
+
+        return [Rule34Tag(**tag_e.attrib) for tag_e in xml_root.findall("tag")]
+
+
+class Rule34AutocompleteApi(Rule34BaseApi):
+    def __init__(self, user_id: int, api_key: str, **kwargs):
+        super().__init__(user_id, api_key, **kwargs)
+        self._url = "https://api.rule34.xxx/autocomplete.php"
+        self._params = {}
+
+    async def search(self, text: str) -> list[Rule34Autocomplete]:
+        return [Rule34Autocomplete(**data) for data in eval(await self._get(json_=False, q=text))]
+
+
+class Rule34Api:
+    def __init__(self, user_id: int, api_key: str, **kwargs):
+        """
+        After 13.07.2025 you need to use API key and user id to access the API.
+        More info: https://discord.com/channels/336564284207267850/497927834241859586/1393885318477906021
+
+        :param user_id: User ID
+        :param api_key: API Key
+        :param kwargs: Any other parameters that you want to pass to ANY requests. (No use cases, but may be used if any other global params will be added in the future)
+        """
+        self._user_id = user_id
+        self._api_key = api_key
+
+    @property
+    def post(self) -> Rule34PostApi:
+        return Rule34PostApi(user_id=self._user_id, api_key=self._api_key)
+
+    @property
+    def comments(self) -> Rule34CommentsApi:
+        return Rule34CommentsApi(user_id=self._user_id, api_key=self._api_key)
+
+    @property
+    def tags(self) -> Rule34TagsApi:
+        return Rule34TagsApi(user_id=self._user_id, api_key=self._api_key)
+
+    @property
+    def autocomplete(self) -> Rule34AutocompleteApi:
+        return Rule34AutocompleteApi(user_id=self._user_id, api_key=self._api_key)

SimpleRule34/types.py

@@ -1,38 +1,42 @@
 import os
 import typing
+import re
+
+from enum import Enum
+from pathlib import Path
+
 import aiofiles
 import aiohttp
 
-from aiofiles import os as aos
-from pydantic import BaseModel
+from pydantic import BaseModel, field_validator, HttpUrl, Field
 
 from .exceptions import ApiException
 from .utils import get_file_type
 
 
 class File(BaseModel):
-    url: str
+    url: HttpUrl
     type: str = None
 
     def __init__(self, /, **data: typing.Any) -> None:
         super().__init__(**data)
 
-        self.type = get_file_type(self.url)
+        self.type = get_file_type(str(self.url))
 
-    async def download(self, path: str = r'./rule34_download') -> str:
-        try:
-            await aos.mkdir(path)
-        except:
-            pass
+    async def download(self, path: Path | str = "./rule34_downloads") -> Path:
+        if isinstance(path, str):
+            path = Path(path)
+        # Create storage path
+        path.mkdir(parents=True, exist_ok=True)
 
         async with aiohttp.ClientSession() as session:
-            async with session.get(self.url) as response:
+            async with session.get(str(self.url)) as response:
                 if response.status != 200:
                     raise ApiException(f"Api returned status code {response.status} with message"
                                        f" {await response.text()}")
 
-                file_name = os.path.basename(self.url)
-                save_path = os.path.join(path, file_name)
+                file_name = os.path.basename(str(self.url))
+                save_path = path / file_name
 
                 async with aiofiles.open(save_path, 'wb') as file:
                     await file.write(await response.read())
@@ -40,23 +44,82 @@ class File(BaseModel):
                 return save_path
 
 
-class Post(BaseModel):
-    directory: int
-    hash: str
-    width: int
-    height: int
+class Rule34Post(BaseModel):
     id: int
-    change: int
-    owner: str
-    parent_id: int
-    rating: str
-    sample: bool
-    score: int
-    tags: list
-    source: str
-    status: str
-    has_notes: bool
-    comment_count: int
-
-    main: File
-    preview: File
+    owner: str | None
+    status: str | None
+    rating: str | None
+    score: int | None
+
+    preview_file: File  = Field(validation_alias="preview_url")
+    sample_file: File  = Field(validation_alias="sample_url")
+    file: File = Field(validation_alias="file_url")
+    source: str | None
+
+    width: int | None
+    height: int | None
+    hash: str | None
+    image: str | None
+    directory: int | None
+
+    change: int | None
+    parent_id: int | None
+    has_notes: bool | None
+    comment_count: int | None
+
+    sample: bool | None
+    sample_height: int | None
+    sample_width: int | None
+
+    tags: typing.List[str] | None
+
+    @field_validator('tags', mode='before')
+    @classmethod
+    def split_tags(cls, v):
+        if isinstance(v, str):
+            return v.strip().split()
+        return v
+
+    @field_validator('preview_file', 'sample_file', 'file', mode='before', check_fields=False)
+    @classmethod
+    def wrap_in_file(cls, v):
+        if isinstance(v, (str, HttpUrl)):
+            return File(url=v)
+        return v
+
+    class Config:
+        populate_by_name = True
+
+
+class Rule34Comment(BaseModel):
+    id: int
+    post_id: int
+    message: str = Field(alias="body")
+    creator: str
+    creator_id: int
+
+
+class Rule34TagType(Enum):
+    GENERAL = "0"
+    ARTIST = "1"
+    COPYRIGHT = "3"
+    UNKNOWN = "2"
+    CHARACTER = "4"
+    META = "5"
+
+
+class Rule34Tag(BaseModel):
+    id: int
+    type: Rule34TagType
+    name: str
+    count: int = Field(default_factory=int)
+    ambiguous: bool
+
+
+class Rule34Autocomplete(BaseModel):
+    label: str
+    value: str
+
+    @property
+    def count(self) -> int:
+        return int(re.search(r'\((\d+)\)', self.label).group(1))

SimpleRule34/utils.py

@@ -1,3 +1,16 @@
+FILE_TYPES = {
+    'jpg': "photo",
+    'jpeg': "photo",
+    'png': "photo",
+
+    'mp4': "video",
+    'avi': "video",
+    'mov': "video",
+    'webm': "video",
+
+    'gif': "animation",
+}
+
 
 async def get_file_size(url, session):
     async with session.head(url=url, allow_redirects=True) as response:
@@ -8,15 +21,11 @@ async def get_file_size(url, session):
             return None
 
 
-def get_file_type(url):
+def get_file_type(url) -> str | None:
     file_extension = url.split('.')[-1].lower()
-    if file_extension in ['jpg', 'jpeg', 'png']:
-        return 'photo'
-    elif file_extension in ['mp4', 'avi', 'mov']:
-        return 'video'
-    elif file_extension == 'gif':
-        return 'animation'
-    else:
-        return None
+
+    if file_extension not in FILE_TYPES.keys(): return None
+
+    return FILE_TYPES[file_extension]
 
 

simple_rule34-1.0.0.0.dist-info/METADATA

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: simple_rule34
+Version: 1.0.0.0
+Summary: Simple api wrapper of rule34.xxx for python with asynchronous support
+Author-email: StarMan12 <author@example.com>
+Project-URL: Homepage, https://github.com/SyperAlexKomp/simple-rule34-api
+Project-URL: Bug Tracker, https://github.com/SyperAlexKomp/simple-rule34-api/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiofiles~=25.1.0
+Requires-Dist: aiohttp~=3.12.15
+Requires-Dist: pydantic~=2.12.5
+Dynamic: license-file
+
+# rule34-simple-api
+Simple api wrapper of rule34.xxx for python with asynchronous support

simple_rule34-1.0.0.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+SimpleRule34/__init__.py,sha256=9VMHjQsFOoSFNj_Ufq6VJLcTXHJPvqxeEozHpIpXSe0,29
+SimpleRule34/exceptions.py,sha256=7tjDPPoOmXTBaMbfsSjaLsXkzgChdKLBsDyCMClMIAo,341
+SimpleRule34/main.py,sha256=L_JIw45Y8UcBWiRvmeeB5zSimjHLOjVoNf1Hg29rMKY,7080
+SimpleRule34/types.py,sha256=6yHumh_U2khFmxgBzVyz2Hj81kdH-z6vCOqfoPHyj0k,3127
+SimpleRule34/utils.py,sha256=q4ohygRV4J88mNUQnCQ_-_A2-syIZpnO_UifIt_vpFc,689
+simple_rule34-1.0.0.0.dist-info/licenses/LICENSE,sha256=6kbiFSfobTZ7beWiKnHpN902HgBx-Jzgcme0SvKqhKY,1091
+simple_rule34-1.0.0.0.dist-info/METADATA,sha256=gh6Aa2UwAXDGHe3uSYxP24r1NnrdqKcZmMEXayx0DdE,801
+simple_rule34-1.0.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+simple_rule34-1.0.0.0.dist-info/top_level.txt,sha256=YI-Z1ijzIjlJw2WeM95PSmClCzIvm24KAlyZi80YVNs,22
+simple_rule34-1.0.0.0.dist-info/RECORD,,

{simple_rule34-0.1.6.dist-info → simple_rule34-1.0.0.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.43.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

SimpleRule34/Rule34.py

@@ -1,149 +0,0 @@
-import random
-import time
-
-import aiohttp
-import datetime
-import logging
-import xml.etree.ElementTree as ET
-
-from .exceptions import *
-from .types import *
-
-
-class Rule34Api:
-    def __init__(self):
-        self.header = {'User-Agent': 'rule34-simple-api 0.1.5.6 (Request)'}
-    async def get_post_count(self, tags: str = '') -> int:
-        async with aiohttp.ClientSession(headers=self.header) as session:
-            async with session.get(f'https://api.rule34.xxx/index.php?'
-                                   f'page=dapi&s=post&q=index&tags={tags}') as response:
-                xml_data = await response.text()
-
-        xml_root = ET.fromstring(xml_data)
-
-        return int(xml_root.get('count'))
-
-    async def get_post(self, id: int) -> Post:
-        st = time.time()
-
-        async with aiohttp.ClientSession(headers=self.header) as session:
-            async with session.get(f'https://api.rule34.xxx/index.php?'
-                                   f'json=1&page=dapi&s=post&q=index&id={id}') as response:
-                if response.status != 200:
-                    raise ApiException(f"Api returned status code {response.status} with message"
-                                       f" {await response.text()}")
-
-                j = await response.json()
-                data = j[0]
-
-        data["main"] = {
-            "url": data['file_url']
-        }
-        data["preview"] = {
-            "url": data['preview_url']
-        }
-        data["tags"] = data["tags"].split(" ")
-
-        logging.debug(f"Post[{id}] where found in {time.time() - st}s")
-
-        return Post(**data)
-
-    async def get_random_post(self, tags: str = '', forbidden_tags: list[str] = []) -> Post:
-        start_time = time.time()
-
-        post_count = await self.get_post_count(tags)
-
-        page_count = post_count // 1000
-
-        if page_count > 0:
-            post_list = await self.get_post_list(page_id=random.randint(0, page_count if page_count <= 200 else 200),
-                                                 tags=tags, limit=1000)
-
-        else:
-            post_list = await self.get_post_list(tags=tags, limit=1000)
-
-        post_list_ = []
-
-        for post in post_list:
-            if any(tag in forbidden_tags for tag in post.main.tags):
-                pass
-            else:
-                post_list_.append(post)
-
-        logging.debug(f"Random posts where found in {time.time() - start_time}s")
-
-        return post_list_[random.randint(0, len(post_list_) - 1)] if len(post_list_) > 0 else None
-
-    async def get_random_posts(self, tags: str = '', count: int = 8, forbidden_tags: list[str] = []) -> list[Post]:
-        st = time.time()
-
-        request_count = 1
-        true_count = count*20
-
-        post_list = []
-
-        if true_count > 1000:
-            request_count = true_count // 1000
-
-        post_count = await self.get_post_count(tags)
-        page_id = int(random.randint(0, int(post_count / true_count)) / 8)  if post_count >= true_count else 0
-
-        for pid in range(request_count + 1):
-            post_list += await self.get_post_list(tags=tags, forbidden_tags=forbidden_tags,
-                                                  page_id=page_id, limit=true_count if true_count <= 1000 else 1000)
-
-        getted = []
-
-        for x in range(count):
-            if len(post_list) > 0:
-                getted.append(post_list[random.randint(0, len(post_list) - 1)])
-            else:
-                pass
-
-        logging.debug(f"{count} random posts where found in {time.time() - st}s")
-
-        return getted
-
-    async def get_post_list(self, limit: int = 1000, page_id: int = 0, tags: str = '', forbidden_tags: list[str] = [])\
-            -> list[Post]:
-        if limit > 1000:
-            raise ToBigRequestException(f"The max size of request is 1000 when you tried to request {limit}")
-
-        async with aiohttp.ClientSession(headers=self.header) as session:
-            start_time = time.time()
-
-            async with session.get(f'https://api.rule34.xxx/index.php?'
-                                   f'json=1&page=dapi&s=post&q=index&limit={limit}&pid={page_id}&tags={tags}') as response:
-                if response.status != 200:
-                    raise ApiException(f"Api returned status code {response.status} with message"
-                                       f" {await response.text()}")
-
-                data = await response.json()
-
-            logging.debug(f"Request with {limit} limit posts were done in {time.time() - start_time}s")
-
-            post_list = []
-            for post_data in data:
-                post_data["main"] = {
-                    "url": post_data['file_url']
-                }
-                post_data["preview"] = {
-                    "url": post_data['preview_url']
-                }
-                post_data["tags"] = post_data["tags"].split(" ")
-
-                post_list.append(Post(**post_data))
-
-            start_time = time.time()
-
-            post_list_ = []
-
-            for post in post_list:
-                if any(tag in forbidden_tags for tag in post.tags):
-                    pass
-                else:
-                    post_list_.append(post)
-
-            logging.debug(f"{len(post_list_)} posts where found in {time.time() - start_time}s")
-
-            return post_list_

SimpleRule34/aio/ARule34.py

@@ -1,186 +0,0 @@
-import random
-import time
-
-import aiohttp
-import datetime
-import logging
-import xml.etree.ElementTree as ET
-
-from ..exceptions import *
-from .types import *
-
-
-async def parse_result(post_element):
-
-
-    id = int(post_element.get('id'))
-    height = int(post_element.get('height'))
-    width = int(post_element.get('width'))
-    url = post_element.get('file_url')
-
-    sample_height = int(post_element.get('sample_height'))
-    sample_width = int(post_element.get('sample_width'))
-    sample_url = post_element.get('sample_url')
-
-    sample_post = Rule34SamplePost(sample_height, sample_width, sample_url, id)
-
-    preview_height = int(post_element.get('preview_height'))
-    preview_width = int(post_element.get('preview_width'))
-    preview_url = post_element.get('preview_url')
-
-    preview_post = Rule34PreviewPost(preview_height, preview_width, preview_url, id)
-
-    score = int(post_element.get('score'))
-    rating = post_element.get('rating')
-    creator_id = int(post_element.get('creator_id'))
-    tags = post_element.get('tags')
-    has_children = post_element.get('has_children') == 'true'
-    created_date = datetime.datetime.strptime(post_element.get('created_at'), "%a %b %d %H:%M:%S %z %Y")
-    status = post_element.get('status')
-    source = post_element.get('source')
-    has_notes = post_element.get('has_notes') == 'true'
-    has_comments = post_element.get('has_comments') == 'true'
-
-    main_post = Rule34MainPost(score, rating, creator_id, tags, has_children, created_date, status,
-                               source, has_notes, has_comments, height, width, url, id)
-
-    return main_post, sample_post, preview_post
-
-class Rule34Api:
-    def __init__(self):
-        self.header = {'User-Agent': 'rule34-simple-api 0.1.5.3 (Request)'}
-    async def get_post_count(self, tags: str = '') -> int:
-        async with aiohttp.ClientSession(headers=self.header) as session:
-            async with session.get(f'https://api.rule34.xxx/index.php?'
-                                   f'page=dapi&s=post&q=index&tags={tags}') as response:
-                xml_data = await response.text()
-
-        xml_root = ET.fromstring(xml_data)
-
-        return int(xml_root.get('count'))
-
-    async def get_post(self, id: int):
-        st = time.time()
-
-        async with aiohttp.ClientSession(headers=self.header) as session:
-            async with session.get(f'https://api.rule34.xxx/index.php?'
-                                   f'page=dapi&s=post&q=index&id={id}') as response:
-                xml_data = await response.text()
-
-        try:
-            xml_root = ET.fromstring(xml_data)
-        except:
-            return None
-
-        post_element = xml_root.find('post')
-
-        parsed = await parse_result(post_element)
-
-        if parsed is None:
-            return None
-        else:
-            main_post, sample_post, preview_post = parsed
-
-        logging.info(f"Post where found in {time.time() - st}s")
-
-        return Rule34PostData(id, main_post, sample_post, preview_post)
-
-    async def get_random_post(self, tags: str = '', forbidden_tags: list[str] = []):
-        start_time = time.time()
-
-        post_count = await self.get_post_count(tags)
-
-        page_count = post_count // 1000
-
-        if page_count > 0:
-            post_list = await self.get_post_list(page_id=random.randint(0, page_count if page_count <= 200 else 200),
-                                                 tags=tags, limit=1000)
-
-        else:
-            post_list = await self.get_post_list(tags=tags, limit=1000)
-
-        post_list_ = []
-
-        for post in post_list:
-            if any(tag in forbidden_tags for tag in post.main.tags):
-                pass
-            else:
-                post_list_.append(post)
-
-        logging.info(f"Random post where found in {time.time() - start_time}s")
-
-        return post_list_[random.randint(0, len(post_list_) - 1)] if len(post_list_) > 0 else None
-
-    async def get_random_posts(self, tags: str = '', count: int = 8, forbidden_tags: list[str] = []) -> list[Rule34PostData]:
-        st = time.time()
-
-        request_count = 1
-        true_count = count*20
-
-        post_list = []
-
-        if true_count > 1000:
-            request_count = true_count // 1000
-
-        post_count = await self.get_post_count(tags)
-        page_id = int(random.randint(0, int(post_count / true_count)) / 8)  if post_count >= true_count else 0
-
-        for pid in range(request_count + 1):
-            post_list += await self.get_post_list(tags=tags, forbidden_tags=forbidden_tags,
-                                                  page_id=page_id, limit=true_count if true_count <= 1000 else 1000)
-
-        getted = []
-
-        for x in range(count):
-            if len(post_list) > 0:
-                getted.append(post_list[random.randint(0, len(post_list) - 1)])
-            else:
-                pass
-
-        logging.info(f"{count} random posts where found in {time.time() - st}s")
-
-        return getted
-
-    async def get_post_list(self, limit: int = 1000, page_id: int = 0, tags: str = '', forbidden_tags: list[str] = [])\
-            -> list[Rule34PostData]:
-        async with aiohttp.ClientSession(headers=self.header) as session:
-            if limit > 1000:
-                raise ToBigRequestException(f"The max size of request is 1000 when you tried to request {limit}")
-
-            start_time = time.time()
-
-            async with session.get(f'https://api.rule34.xxx/index.php?'
-                                   f'page=dapi&s=post&q=index&limit={limit}&pid={page_id}&tags={tags}') as response:
-                xml_data = await response.text()
-
-            logging.debug(f"Request with {limit} limit posts were done in {time.time() - start_time}s")
-
-            xml_root = ET.fromstring(xml_data)
-            posts = xml_root.findall('post')
-            post_list = []
-
-            start_time = time.time()
-
-            for post_element in posts:
-                parsed = await parse_result(post_element)
-
-                if parsed is None:
-                    return []
-                else:
-                    main_post, sample_post, preview_post = parsed
-
-                post_list.append(Rule34PostData(main_post.id, main_post, sample_post, preview_post))
-
-            logging.debug(f"Creating {len(posts)} objects was done in {time.time() - start_time}s")
-
-            post_list_ = []
-
-            for post in post_list:
-                if any(tag in forbidden_tags for tag in post.main.tags):
-                    pass
-                else:
-                    post_list_.append(post)
-
-            logging.info(f"{len(post_list_)} posts where found in {time.time() - start_time}s")
-
-            return post_list_

SimpleRule34/aio/types.py

@@ -1,98 +0,0 @@
-import typing
-
-import aiofiles
-import aiohttp
-import os
-import datetime
-
-from .utils import get_file_size, get_file_type
-
-
-class Rule34Post:
-    def __init__(self, height: int, width: int, url: str, id: int):
-        self.path = r'./rule34_download'
-        self.height = height
-        self.width = width
-        self.url = url
-        self.id = id
-        self.file_type = get_file_type(self.url)
-
-    def __str__(self):
-        return f"<Rule34Post(id={self.id}, height={self.height}, width={self.width}, url={self.url})>"
-
-    async def get_file_size(self) -> typing.Optional[int]:
-        async with aiohttp.ClientSession() as session:
-            file_size = await get_file_size(self.url, session)
-        return file_size
-
-    async def download(self, path=r'./rule34_download'):
-        async with aiohttp.ClientSession() as session:
-            async with session.get(self.url) as response:
-                if response.status == 200:
-                    try:
-                        os.mkdir(self.path)
-                    except:
-                        pass
-
-                    file_name = os.path.basename(self.url)
-                    save_path = os.path.join(path, file_name)
-                    async with aiofiles.open(save_path, 'wb') as file:
-                        await file.write(await response.read())
-
-                    return save_path
-                else:
-                    pass
-
-    async def get_bytes(self):
-        async with aiohttp.ClientSession() as session:
-            async with session.get(self.url) as response:
-                return await response.read()
-
-
-class Rule34MainPost(Rule34Post):
-    def __init__(self, score: int, rating: str, creator_id: int, tags: str, has_children: bool,
-                 created_date: datetime.datetime, status: str, source: str, has_notes: bool, has_comments: bool,
-                 height: int, width: int, url: str, id: int):
-        super().__init__(height, width, url, id)
-        self.score = score
-        self.rating = rating
-        self.creator_id = creator_id
-        self.tags = tags.split(" ")
-        self.has_children = has_children
-        self.created_date = created_date
-        self.status = status
-        self.source = source
-        self.has_notes = has_notes
-        self.has_comments = has_comments
-
-    def __str__(self):
-        return f"<Rule34MainPost(id={self.id}, height={self.height}, width={self.width}, url={self.url}," \
-               f" score={self.score}, rating={self.rating}, creator_id={self.creator_id}," \
-               f" has_children={self.has_children}, has_notes={self.has_notes}, has_comments={self.has_comments}" \
-               f" created_date={self.created_date}, status={self.status}, tags={self.tags})>"
-
-    def format_tags(self, format: str = "#"):
-        str_tags = (format + ' ').join(self.tags)
-        return str_tags.split(" ")
-
-
-class Rule34SamplePost(Rule34Post):
-    def __str__(self):
-        return f"<Rule34SamplePost(id={self.id}, height={self.height}, width={self.width}, url={self.url})>"
-
-
-class Rule34PreviewPost(Rule34Post):
-    def __str__(self):
-        return f"<Rule34PreviewPost(id={self.id}, height={self.height}, width={self.width}, url={self.url})>"
-
-
-class Rule34PostData:
-    def __init__(self, id: int, main: Rule34MainPost, sample: Rule34SamplePost, preview: Rule34PreviewPost):
-        self.id = id
-        self.main = main
-        self.sample = sample
-        self.preview = preview
-
-    def __str__(self):
-        return f"<Rule34PostData(id={self.id}, main={str(self.main)}, sample={str(self.sample)}," \
-               f" preview={str(self.preview)})>"

SimpleRule34/aio/utils.py

@@ -1,22 +0,0 @@
-
-async def get_file_size(url, session):
-    async with session.head(url=url, allow_redirects=True) as response:
-        if 'Content-Length' in response.headers:
-            size = int(response.headers['Content-Length'])
-            return size
-        else:
-            return None
-
-
-def get_file_type(url):
-    file_extension = url.split('.')[-1].lower()
-    if file_extension in ['jpg', 'jpeg', 'png']:
-        return 'photo'
-    elif file_extension in ['mp4', 'avi', 'mov']:
-        return 'video'
-    elif file_extension == 'gif':
-        return 'animation'
-    else:
-        return None
-
-

SimpleRule34/setup.py

@@ -1,26 +0,0 @@
-from setuptools import setup, find_packages
-
-setup(
-    name='SimpleRule34',
-    version='0.1',
-    description='Simple api wrapper of rule34.xxx for python with asynchronous support',
-    packages=find_packages(),
-    install_requires=[
-        'aiohttp==3.8.4',
-        'aiosignal==1.3.1',
-        'async-timeout==4.0.2',
-        'attrs==23.1.0',
-        'certifi==2023.5.7',
-        'charset-normalizer==3.2.0',
-        'docopt==0.6.2',
-        'frozenlist==1.4.0',
-        'idna==3.4',
-        'multidict==6.0.4',
-        'pipreqs==0.4.13',
-        'requests==2.31.0',
-        'urllib3==2.0.3',
-        'yarg==0.1.9',
-        'yarl==1.9.2',
-    ],
-    url='https://github.com/Loshok229/rule34-simple-api'
-)

simple_rule34-0.1.6.dist-info/METADATA

@@ -1,57 +0,0 @@
-Metadata-Version: 2.1
-Name: simple_rule34
-Version: 0.1.6
-Summary: Simple api wrapper of rule34.xxx for python with asynchronous support
-Author-email: StarMan12 <author@example.com>
-Project-URL: Homepage, https://github.com/SyperAlexKomp/simple-rule34-api
-Project-URL: Bug Tracker, https://github.com/SyperAlexKomp/simple-rule34-api/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: aiohttp ==3.8.4
-Requires-Dist: aiosignal ==1.3.1
-Requires-Dist: alabaster ==0.7.13
-Requires-Dist: async-timeout ==4.0.2
-Requires-Dist: attrs ==23.1.0
-Requires-Dist: Babel ==2.9.1
-Requires-Dist: build ==0.10.0
-Requires-Dist: certifi ==2023.5.7
-Requires-Dist: charset-normalizer ==3.2.0
-Requires-Dist: colorama ==0.4.6
-Requires-Dist: docopt ==0.6.2
-Requires-Dist: docutils ==0.18.1
-Requires-Dist: frozenlist ==1.4.0
-Requires-Dist: idna ==3.4
-Requires-Dist: imagesize ==1.4.1
-Requires-Dist: importlib-metadata ==6.8.0
-Requires-Dist: Jinja2 ==3.1.2
-Requires-Dist: MarkupSafe ==2.1.3
-Requires-Dist: multidict ==6.0.4
-Requires-Dist: packaging ==23.1
-Requires-Dist: pipreqs ==0.4.13
-Requires-Dist: Pygments ==2.15.1
-Requires-Dist: pyproject-hooks ==1.0.0
-Requires-Dist: requests ==2.31.0
-Requires-Dist: snowballstemmer ==2.2.0
-Requires-Dist: Sphinx ==6.2.1
-Requires-Dist: sphinx-rtd-theme ==1.2.2
-Requires-Dist: sphinxcontrib-applehelp ==1.0.4
-Requires-Dist: sphinxcontrib-devhelp ==1.0.2
-Requires-Dist: sphinxcontrib-htmlhelp ==2.0.1
-Requires-Dist: sphinxcontrib-jquery ==4.1
-Requires-Dist: sphinxcontrib-jsmath ==1.0.1
-Requires-Dist: sphinxcontrib-qthelp ==1.0.3
-Requires-Dist: sphinxcontrib-serializinghtml ==1.1.5
-Requires-Dist: tomli ==2.0.1
-Requires-Dist: urllib3 ==2.0.3
-Requires-Dist: yarg ==0.1.9
-Requires-Dist: yarl ==1.9.2
-Requires-Dist: zipp ==3.16.2
-Requires-Dist: aiofiles ~=23.2.1
-Requires-Dist: pydantic ~=2.7.1
-
-# rule34-simple-api
-Simple api wrapper of rule34.xxx for python with asynchronous support

simple_rule34-0.1.6.dist-info/RECORD

@@ -1,15 +0,0 @@
-__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-SimpleRule34/Rule34.py,sha256=yVgZFMuCyC8VHbhxDWO37DnMvodkh9d8RYNRVtaHnIk,5433
-SimpleRule34/__init__.py,sha256=C4IbcJ_rjqBhpENXImVGuEQxf81GUwNaycqNNAY_ROc,31
-SimpleRule34/exceptions.py,sha256=dUpJBROzXWT67ZOLAHWWse0srvMRunIa9rSl1Cs10B8,491
-SimpleRule34/setup.py,sha256=7hNDTD52EAs7W00-Nd5LzvH8H4-Dvc59W8a999LqvW4,735
-SimpleRule34/types.py,sha256=n9y60b96g9wyD8FAZ_ElETBFNnM1F1GAs5VoxzCFI68,1518
-SimpleRule34/utils.py,sha256=fWx-ntJ672NoktH5Ws9-FcO0gtCNVmd8VfxFxjWqsD0,616
-SimpleRule34/aio/ARule34.py,sha256=nZwxmMNo_g_a16U9dJmxFGUIkDtgNB-W0uFH8LJ8tSI,6858
-SimpleRule34/aio/types.py,sha256=919XQt5ydRoLeVxy5HRujc0IeKYlD3crYuH_qvPqdKY,3719
-SimpleRule34/aio/utils.py,sha256=fWx-ntJ672NoktH5Ws9-FcO0gtCNVmd8VfxFxjWqsD0,616
-simple_rule34-0.1.6.dist-info/LICENSE,sha256=6kbiFSfobTZ7beWiKnHpN902HgBx-Jzgcme0SvKqhKY,1091
-simple_rule34-0.1.6.dist-info/METADATA,sha256=dDBVIIRhZOzlaayIKolcj74YeEzKpsdGWWPi5bhQ_44,2154
-simple_rule34-0.1.6.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-simple_rule34-0.1.6.dist-info/top_level.txt,sha256=YI-Z1ijzIjlJw2WeM95PSmClCzIvm24KAlyZi80YVNs,22
-simple_rule34-0.1.6.dist-info/RECORD,,