Asynchronous wrapper for rule34.xxx.
Project description
Table of Contents
Getting Started
Install using PyPI
pip install -U pyrule34
or
Clone the repository
git clone https://github.com/Hypick122/pyrule34.git
- Install the required Python packages:
pip install -U aiohttp, beautifulsoup4, lxml
- Create a .py file and import the required libraries:
import asyncio
from pyrule34 import AsyncRule34
Usage
AsyncRule34 can be used as a context manager:
```python
#example
async def main():
async with AsyncRule34() as r34:
get_posts = await r34.get_posts(4931536)
print(get_posts[0].tags)
loop = asyncio.get_event_loop()
loop.run_until_complete(main())
Search
Search for posts using specified inclusion and exclusion tags.
Returns a list.
Parameters:
tags
- The include tagsexclude_tags
- The exclude tags (default: None)limit
- The (maximum) limit to get posts. Maximum 1000 per one request (default: 100)page_id
- The page number (default: 0)
search = await r34.search(tags=["neko"], exclude_tags=["rating:general"], page_id=2, limit=1)
Get post
Retrieve post(s) by ID or MD5 hash.
Returns a list.
Parameters:
posts_id
: The list of IDs posts or post IDmd5
: The MD5 hash of the post (default: None)
get_posts = await r34.get_posts(4931536)
Comments on the post
Get comments by post ID.
Returns a list.
Parameters:
post_id
: The ID of the post
get_post_comments = await r34.get_post_comments(4153825)
Random post
Get a random post.
Returns a dict.
get_random_post = await r34.get_random_post()
Pool
Get Pool by ID.
Returns a list.
Parameters:
cid
: Pool IDoffset
: offset (default: 0) | 1 page - 45
get_pool = await r34.get_pool(29619)
User favorites
Get user's favorites by ID.
Returns a list.
Parameters:
user_id
: user IDoffset
: offset (default: 0) | 1 page - 50
favorite = await r34.users.favorites(2993217)
Top 100 characters and tags
Get the top 100 characters or tags.
Returns a list.
top_character = await r34.top_characters()
top_tags = await r34.top_tags()
Top users
Get the top 10 best users by tags, comments, etc.
Returns a list.
taggers = await r34.stats.taggers()
favorites = await r34.stats.favorites()
commenters = await r34.stats.commenters()
forum_posters = await r34.stats.forum_posters()
image_posters = await r34.stats.image_posters()
note_editors = await r34.stats.note_editors()
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pyrule34test-0.0.17.tar.gz
(7.0 kB
view hashes)
Built Distribution
Close
Hashes for pyrule34test-0.0.17-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 45e062d629d69f4ce676818ac7d29abbe266825b450744c9a6bc3df48d278f9e |
|
MD5 | bcf973be05d76197a4765c5592e6adb8 |
|
BLAKE2b-256 | cf337e0d766b4a57a15edd4111ada3021832e34b8b7ea05f7c1ee395bd2b955a |