<h1 align="center">🦀 Cunny.py 🦀</h1>
<h3 align="center">🔥A Blazingly Fast Image Board Library🔥</h3>
---
<p align="center">
<a href="#📥Installation">📥Installation</a> |
<a href="#🌟Features">🌟Features</a> |
<a href="#⚙️Usage">⚙️Usage</a>
</p>
<br>
## 📥Installation
✅ Getting started with Cunny.py is quick and easy! Simply install the package using your favorite tool.
📥Using [pip](https://pypi.org/project/pip/):
```bash
pip install cunnypy
```
🪶Using [poetry](https://python-poetry.org):
```bash
poetry add cunnypy
```
## 🌟Features
- 🔥 **Blazingly Fast**™️
- 🐍 **Modern** and **Pythonic** API.
- 🚀 Supports [**AnyIO**](https://github.com/agronholm/anyio), [**AsyncIO**](https://docs.python.org/3/library/asyncio.html), and [**Trio**](https://github.com/python-trio/trio).
- 💯 **15** boorus supported.
- 🆔 Support for **aliases**.
- 🎲 Randomize posts with the `gatcha` parameter.
- 🔍 Autocomplete support for **all** boorus.
- 🔢 Search **any combination** of boors at once.
## ⚙️Usage
### 🔎 Basic Search
📝 **Note**: You can specify additional parameters in the search function.
```python
import asyncio
import cunnypy
async def main():
posts = await cunnypy.search("gelbooru", "megumin")
print(posts)
asyncio.run(main())
```
### 🔍 Basic Multi-Booru Search
📝 **Note**: To add credential support import the `Booru` class.
```python
import asyncio
import cunnypy
async def main():
posts = await cunnypy.ms(["gel", "safe"], "megumin")
print(posts)
asyncio.run(main())
```
### 🤖 Autocomplete
```python
import asyncio
import cunnypy
async def main():
auto = await cunnypy.autocomplete("gel", "megumi*")
print(auto)
asyncio.run(main())
```
Raw data
{
"_id": null,
"home_page": "",
"name": "cunnypy",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.11,<4.0",
"maintainer_email": "",
"keywords": "allthefallen,anime,anime artwork,anyio,artwork,async,asyncio,booru,danbooru,e621,e926,gelbooru,hentai,httpx,hypnohub,konachan,library,lolibooru,parsel,realbooru,rule34,safebooru,sankaku,tbib,trio,xbooru,yandere",
"author": "CunnyArc",
"author_email": "glitchy@cunny.social",
"download_url": "https://files.pythonhosted.org/packages/7a/1e/02fb062b88e59b976c9ec60f92f27e79c794c941a60530c8140227466f39/cunnypy-3.0.0.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">\ud83e\udd80 Cunny.py \ud83e\udd80</h1>\n<h3 align=\"center\">\ud83d\udd25A Blazingly Fast Image Board Library\ud83d\udd25</h3>\n\n\n---\n\n<p align=\"center\">\n\t<a href=\"#\ud83d\udce5Installation\">\ud83d\udce5Installation</a> |\n\t<a href=\"#\ud83c\udf1fFeatures\">\ud83c\udf1fFeatures</a> |\n\t<a href=\"#\u2699\ufe0fUsage\">\u2699\ufe0fUsage</a>\n</p>\n<br>\n\n## \ud83d\udce5Installation\n\u2705 Getting started with Cunny.py is quick and easy! Simply install the package using your favorite tool.\n\n\ud83d\udce5Using [pip](https://pypi.org/project/pip/):\n\n```bash\npip install cunnypy\n```\n\n\ud83e\udeb6Using [poetry](https://python-poetry.org):\n\n```bash\npoetry add cunnypy\n```\n\n## \ud83c\udf1fFeatures\n- \ud83d\udd25 **Blazingly Fast**\u2122\ufe0f\n- \ud83d\udc0d **Modern** and **Pythonic** API.\n- \ud83d\ude80 Supports [**AnyIO**](https://github.com/agronholm/anyio), [**AsyncIO**](https://docs.python.org/3/library/asyncio.html), and [**Trio**](https://github.com/python-trio/trio).\n- \ud83d\udcaf **15** boorus supported.\n- \ud83c\udd94 Support for **aliases**.\n- \ud83c\udfb2 Randomize posts with the `gatcha` parameter.\n- \ud83d\udd0d Autocomplete support for **all** boorus.\n- \ud83d\udd22 Search **any combination** of boors at once.\n\n\n## \u2699\ufe0fUsage\n\n### \ud83d\udd0e Basic Search\n\ud83d\udcdd **Note**: You can specify additional parameters in the search function.\n\n```python\nimport asyncio\n\nimport cunnypy\n\n\nasync def main():\n posts = await cunnypy.search(\"gelbooru\", \"megumin\")\n print(posts)\n\nasyncio.run(main())\n```\n\n### \ud83d\udd0d Basic Multi-Booru Search\n\ud83d\udcdd **Note**: To add credential support import the `Booru` class.\n```python\nimport asyncio\n\nimport cunnypy\n\n\nasync def main():\n posts = await cunnypy.ms([\"gel\", \"safe\"], \"megumin\")\n print(posts)\n\nasyncio.run(main())\n```\n\n### \ud83e\udd16 Autocomplete\n\n```python\nimport asyncio\n\nimport cunnypy\n\n\nasync def main():\n auto = await cunnypy.autocomplete(\"gel\", \"megumi*\")\n print(auto)\n\nasyncio.run(main())\n```\n",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "A blazingly fast image board library.",
"version": "3.0.0",
"project_urls": {
"Discord": "https://discord.gg/ZxbYHEh",
"Documentation": "https://codeberg.org/CunnyTech/Cunnypy#readme",
"Funding": "https://liberapay.com/Glitchy",
"Issues": "https://codeberg.org/CunnyTech/Cunnypy/issues",
"Source": "https://codeberg.org/CunnyTech/Cunnypy"
},
"split_keywords": [
"allthefallen",
"anime",
"anime artwork",
"anyio",
"artwork",
"async",
"asyncio",
"booru",
"danbooru",
"e621",
"e926",
"gelbooru",
"hentai",
"httpx",
"hypnohub",
"konachan",
"library",
"lolibooru",
"parsel",
"realbooru",
"rule34",
"safebooru",
"sankaku",
"tbib",
"trio",
"xbooru",
"yandere"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f07770d59b5f2f3c3e68eddcf35a4797a9d667027cddfbc5332d062b0eaa3f7d",
"md5": "08795251613cf521105f383f2c57a731",
"sha256": "8527f3773da0f4ca2d05187a048f9503b130c27163167e87530b9a178d426882"
},
"downloads": -1,
"filename": "cunnypy-3.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "08795251613cf521105f383f2c57a731",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11,<4.0",
"size": 21141,
"upload_time": "2023-09-19T20:10:40",
"upload_time_iso_8601": "2023-09-19T20:10:40.442827Z",
"url": "https://files.pythonhosted.org/packages/f0/77/70d59b5f2f3c3e68eddcf35a4797a9d667027cddfbc5332d062b0eaa3f7d/cunnypy-3.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7a1e02fb062b88e59b976c9ec60f92f27e79c794c941a60530c8140227466f39",
"md5": "02b84b664fc7bdfda21290701491d6b3",
"sha256": "e56302223f8be9300cdbda33ad557996784df25439e566a91a0dc21fe5ba21ce"
},
"downloads": -1,
"filename": "cunnypy-3.0.0.tar.gz",
"has_sig": false,
"md5_digest": "02b84b664fc7bdfda21290701491d6b3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11,<4.0",
"size": 20964,
"upload_time": "2023-09-19T20:10:41",
"upload_time_iso_8601": "2023-09-19T20:10:41.997430Z",
"url": "https://files.pythonhosted.org/packages/7a/1e/02fb062b88e59b976c9ec60f92f27e79c794c941a60530c8140227466f39/cunnypy-3.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-19 20:10:41",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": true,
"codeberg_user": "CunnyTech",
"codeberg_project": "Cunnypy#readme",
"lcname": "cunnypy"
}
JSON