# animegifs.py
<p align="center">
<a href="https://pypi.org/project/animegifs/">
<img src="https://img.shields.io/pypi/dm/animegifs?logo=PyPI&style=for-the-badge" alt="PyPi Downloads"/></a>
<a href="https://discord.gg/TKZJ4GJj2z">
<img src="https://img.shields.io/discord/856005478789677096?logo=Discord&style=for-the-badge" alt="Discord Server"/></a>
<a href="https://pypi.org/project/animegifs/">
<img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/MarcoSa-2000/animegifs?style=for-the-badge"></a>
<img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/animegifs?logo=Python&logoColor=%23FFFF00&style=for-the-badge">
<img alt="GitHub watchers" src="https://img.shields.io/github/watchers/MarcoSa-2000/animegifs?style=social">
</p>
API wrapper for animegifs. Get random anime gifs by category. Use Python (intended (for now) for Discord).
WIP - updated in time to time. Versions below v0.5.3 aren't expected to work flawlessly or at all.
Version below v1.0 will not have the gifs library updated anymore and the gifs may return 404 as they were hosted on Discord.
For troubleshoots, known errors and categories list, check below.
`pip install animegifs`
# HOW TO USE
```py
#v0.5.3>
from animegifs import animegifs
gifs = animegifs.Animegifs()
gif = gifs.get_gif(category) #return the url of the gif.
```
```py
#v0.6>
from animegifs import animegifs
gifs = animegifs.Animegifs()
gif = gifs.get_gif(category) #gifs.get_gif('hug') and return the url of the gif.
mal = gifs.get_mal(gif) #get url of the gif's anime myanimelist page.
title = gifs.get_animetitle(gif) #get the title of the gif's anime.
malid = gifs.get_malId(gif) #get the ID of the gif's anime myanimelist page.
```
```py
#v0.6>
from animegifs import animegifs
gifs = animegifs.Animegifs()
user_input = input() #let user send any input and search if that input matches a category.
#if user_input == "nom": #nom as category doesn't exist, but is similar to bite (as example)
# user_input = "bite"
try:
gif = gifs.get_gif(user_input) #return the url of the gif if the category exists.
except animegifs.errors.CategoryError:
print("not a valid gif category.")
```
## Category list:
**A**
* Attack
**B**
* Bite, Bloodsuck, Blush, Bonk, Brofist
**C**
* Cry, Cuddle
**D**
* Dance, Disgust
**E**
* Exploding
**F**
* Facedesk, Facepalm, Flick, Flirt
**H**
* Handhold, Happy, Harass, Highfive, Hug
**I**
* Icecream, Insult
**K**
* Kill, Kiss
**L**
* Lick, Love
**M**
* Marry
**N**
* Nod, Nosebleed, Note, Nuzzle
**P**
* Pat, Peck, Poke, Popcorn, Pout, Punch, Punish
**R**
* Run
**S**
* Sad, Scared, Shoot, Shrug, Sip, Slap, Smirk, Sorry, Spank, Stare
**T**
* Tease, Threat, Tickle, Tired
**W**
* Wave
**Y**
* Yawn
**Special Category List**
* Random, Steal-magic
# Live API
You can test out the API (and lib functionality) on my bot's website here: https://enkidu-app.github.io/animegifs
# Submit a GIF
If you also want to contribute to the gifs collection, you can submit a gif at: https://forms.gle/wxWmRuy5VCdDCZWp8
# Troubleshooting and other
If you encounter an error, please raise an issue on the issue page: https://github.com/MarcoSa-2000/animegifs/issues.
Alternatively, you can join my Discord server (https://discord.com/invite/TKZJ4GJj2z) to request new categories, functions, provide feedback, or report any errors.
I do also have a multi-function Discord bot. Feel free to check out the web dashboard here: https://enkidu-app.github.io.
# Copyright
This repository doesn't include any copyrighted material.
If you happen to come across any copyrighted content within this repository (but hosted elsewhere) that you own or represent, email me at **grest0grest@gmail.com**.
Please provide specific details about the copyrighted material and where it can be found.
Once I confirm your claim, I'll take immediate action to remove the identified material.
Raw data
{
"_id": null,
"home_page": "https://github.com/MarcoSa-2000/animegifs",
"name": "animegifs",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "anime, gif, python, anime-gifs, discord",
"author": "Marco-Sa2000",
"author_email": "grest0grest@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d7/cf/0382e95fe67b7265bfd75a8c794190972c449b3dc0b634c1d6c3446834fd/animegifs-1.0.0.tar.gz",
"platform": null,
"description": "\r\n# animegifs.py\r\n\r\n<p align=\"center\">\r\n\r\n <a href=\"https://pypi.org/project/animegifs/\">\r\n\r\n <img src=\"https://img.shields.io/pypi/dm/animegifs?logo=PyPI&style=for-the-badge\" alt=\"PyPi Downloads\"/></a>\r\n\r\n <a href=\"https://discord.gg/TKZJ4GJj2z\">\r\n\r\n <img src=\"https://img.shields.io/discord/856005478789677096?logo=Discord&style=for-the-badge\" alt=\"Discord Server\"/></a>\r\n\r\n <a href=\"https://pypi.org/project/animegifs/\">\r\n\r\n <img alt=\"GitHub release (latest by date)\" src=\"https://img.shields.io/github/v/release/MarcoSa-2000/animegifs?style=for-the-badge\"></a>\r\n\r\n <img alt=\"PyPI - Python Version\" src=\"https://img.shields.io/pypi/pyversions/animegifs?logo=Python&logoColor=%23FFFF00&style=for-the-badge\">\r\n\r\n <img alt=\"GitHub watchers\" src=\"https://img.shields.io/github/watchers/MarcoSa-2000/animegifs?style=social\">\r\n\r\n</p>\r\n\r\n\r\n\r\nAPI wrapper for animegifs. Get random anime gifs by category. Use Python (intended (for now) for Discord).\r\n\r\n\r\n\r\nWIP - updated in time to time. Versions below v0.5.3 aren't expected to work flawlessly or at all. \r\n\r\nVersion below v1.0 will not have the gifs library updated anymore and the gifs may return 404 as they were hosted on Discord.\r\n\r\nFor troubleshoots, known errors and categories list, check below.\r\n\r\n\r\n\r\n`pip install animegifs`\r\n\r\n\r\n\r\n# HOW TO USE\r\n\r\n```py\r\n\r\n#v0.5.3>\r\n\r\nfrom animegifs import animegifs\r\n\r\n\r\n\r\ngifs = animegifs.Animegifs()\r\n\r\n\r\n\r\ngif = gifs.get_gif(category) #return the url of the gif.\r\n\r\n```\r\n\r\n\r\n\r\n```py\r\n\r\n#v0.6>\r\n\r\nfrom animegifs import animegifs\r\n\r\n\r\n\r\ngifs = animegifs.Animegifs()\r\n\r\n\r\n\r\ngif = gifs.get_gif(category) #gifs.get_gif('hug') and return the url of the gif.\r\n\r\nmal = gifs.get_mal(gif) #get url of the gif's anime myanimelist page.\r\n\r\ntitle = gifs.get_animetitle(gif) #get the title of the gif's anime.\r\n\r\nmalid = gifs.get_malId(gif) #get the ID of the gif's anime myanimelist page.\r\n\r\n```\r\n\r\n\r\n\r\n```py\r\n\r\n#v0.6>\r\n\r\nfrom animegifs import animegifs\r\n\r\n\r\n\r\ngifs = animegifs.Animegifs()\r\n\r\n\r\n\r\nuser_input = input() #let user send any input and search if that input matches a category.\r\n\r\n#if user_input == \"nom\": #nom as category doesn't exist, but is similar to bite (as example)\r\n\r\n# user_input = \"bite\"\r\n\r\ntry:\r\n\r\n gif = gifs.get_gif(user_input) #return the url of the gif if the category exists.\r\n\r\nexcept animegifs.errors.CategoryError:\r\n\r\n print(\"not a valid gif category.\")\r\n\r\n```\r\n\r\n\r\n\r\n## Category list:\r\n\r\n\r\n\r\n**A**\r\n\r\n* Attack\r\n\r\n\r\n\r\n**B**\r\n\r\n* Bite, Bloodsuck, Blush, Bonk, Brofist\r\n\r\n\r\n\r\n**C**\r\n\r\n* Cry, Cuddle\r\n\r\n\r\n\r\n**D**\r\n\r\n* Dance, Disgust\r\n\r\n\r\n\r\n**E**\r\n\r\n* Exploding\r\n\r\n\r\n\r\n**F**\r\n\r\n* Facedesk, Facepalm, Flick, Flirt\r\n\r\n\r\n\r\n**H**\r\n\r\n* Handhold, Happy, Harass, Highfive, Hug\r\n\r\n\r\n\r\n**I**\r\n\r\n* Icecream, Insult\r\n\r\n\r\n\r\n**K**\r\n\r\n* Kill, Kiss\r\n\r\n\r\n\r\n**L**\r\n\r\n* Lick, Love\r\n\r\n\r\n\r\n**M**\r\n\r\n* Marry\r\n\r\n\r\n\r\n**N**\r\n\r\n* Nod, Nosebleed, Note, Nuzzle\r\n\r\n\r\n\r\n**P**\r\n\r\n* Pat, Peck, Poke, Popcorn, Pout, Punch, Punish\r\n\r\n\r\n\r\n**R**\r\n\r\n* Run\r\n\r\n\r\n\r\n**S**\r\n\r\n* Sad, Scared, Shoot, Shrug, Sip, Slap, Smirk, Sorry, Spank, Stare\r\n\r\n\r\n\r\n**T**\r\n\r\n* Tease, Threat, Tickle, Tired\r\n\r\n\r\n\r\n**W**\r\n\r\n* Wave\r\n\r\n\r\n\r\n**Y**\r\n\r\n* Yawn\r\n\r\n\r\n\r\n**Special Category List**\r\n\r\n\r\n\r\n* Random, Steal-magic\r\n\r\n\r\n\r\n# Live API\r\n\r\n\r\n\r\nYou can test out the API (and lib functionality) on my bot's website here: https://enkidu-app.github.io/animegifs\r\n\r\n\r\n\r\n# Submit a GIF\r\n\r\n\r\n\r\nIf you also want to contribute to the gifs collection, you can submit a gif at: https://forms.gle/wxWmRuy5VCdDCZWp8\r\n\r\n\r\n\r\n# Troubleshooting and other\r\n\r\n\r\n\r\nIf you encounter an error, please raise an issue on the issue page: https://github.com/MarcoSa-2000/animegifs/issues. \r\n\r\nAlternatively, you can join my Discord server (https://discord.com/invite/TKZJ4GJj2z) to request new categories, functions, provide feedback, or report any errors. \r\n\r\nI do also have a multi-function Discord bot. Feel free to check out the web dashboard here: https://enkidu-app.github.io.\r\n\r\n\r\n\r\n# Copyright\r\n\r\n\r\n\r\nThis repository doesn't include any copyrighted material. \r\n\r\nIf you happen to come across any copyrighted content within this repository (but hosted elsewhere) that you own or represent, email me at **grest0grest@gmail.com**. \r\n\r\nPlease provide specific details about the copyrighted material and where it can be found.\r\n\r\nOnce I confirm your claim, I'll take immediate action to remove the identified material.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Get random anime gifs by category.",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/MarcoSa-2000/animegifs"
},
"split_keywords": [
"anime",
" gif",
" python",
" anime-gifs",
" discord"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "dfed53077fd7fcdec001f58949af8bdb8464291c5f2a6797bec468b933fc0536",
"md5": "2c3056b7bc960b1176effc686061d837",
"sha256": "c30d071632a1dbb057dfc3634c3385686106dd27d365f50ec7a029082d182db5"
},
"downloads": -1,
"filename": "animegifs-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2c3056b7bc960b1176effc686061d837",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 5795,
"upload_time": "2024-03-26T16:25:36",
"upload_time_iso_8601": "2024-03-26T16:25:36.429944Z",
"url": "https://files.pythonhosted.org/packages/df/ed/53077fd7fcdec001f58949af8bdb8464291c5f2a6797bec468b933fc0536/animegifs-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d7cf0382e95fe67b7265bfd75a8c794190972c449b3dc0b634c1d6c3446834fd",
"md5": "fc1e236dfe02eebaec50be48f33c673b",
"sha256": "5b2a8ec36960fae3d4ad76f49dbe3e9a5a82fe53e53aa8e686be11845b4228fc"
},
"downloads": -1,
"filename": "animegifs-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "fc1e236dfe02eebaec50be48f33c673b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 5662,
"upload_time": "2024-03-26T16:25:37",
"upload_time_iso_8601": "2024-03-26T16:25:37.898282Z",
"url": "https://files.pythonhosted.org/packages/d7/cf/0382e95fe67b7265bfd75a8c794190972c449b3dc0b634c1d6c3446834fd/animegifs-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-26 16:25:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MarcoSa-2000",
"github_project": "animegifs",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "animegifs"
}
JSON
