semvec/pypi-packages huggingface dataset:
animec 0.4.2
A module to get data about anime characters, news, info, lyrics and more.
License: MIT
Keywords: animecharacter anime character myanimelist news animenews animeinfo music animelyrics lyrics

<p align = "center"><img width="248" height="248" src="https://i.imgur.com/IyUybvv.png"></p>

<p align = "center"><a href="https://github.com/DriftAsimov/animec/stargazers"><img src = "https://img.shields.io/github/stars/driftasimov/animec?colorA=1e1e28&colorB=c9cbff&style=for-the-badge&logo=starship%20style=for-the-badge"></a>
<a href = "https://discord.gg/x3qAZV3" target = "_blank"><img src="https://img.shields.io/discord/907385605422448742?style=for-the-badge&logo=discord&color=DDB6F2&logoColor=D9E0EE&labelColor=302D41"></a></p>

# Animec

A module to get data about anime characters, news, info, lyrics and more.
The module scrapes [myanimelist](https://myanimelist.net/) to parse requested data.

If you wish to see a feature, please raise an [issue](https://github.com/DriftAsimov/animec). We will surely work on it.
You can also join our [Discord](https://discord.gg/x3qAZV3) to get regular updates about the module.

See the Docs for a complete documentation: https://animec.readthedocs.io/en/latest/.

## Installation and Usage

To install the module:
```python
pip install animec
```

To import the module:
```python
import animec
# OR
from animec import *
```

## Examples

### Extracting an anime character's data

```python
result = Charsearch("okabe rintarou")

print(result.title, result.url, result.image_url, sep="\n")

'''
Output: (As retrieved from myanimelist), check the documentation for a list of all supported attributes
Rintarou Okabe (岡部 倫太郎)
https://myanimelist.net/character/35252/Rintarou_Okabe
https://cdn.myanimelist.net/images/characters/6/122643.jpg
'''
```

### Requesting anime news

```python
news = Aninews()   #default value is 3, check the documentation for a list of all supported attributes

print(news.titles)  #returns news titles
print(news.descripion)   #returns news description

```

### Getting anime info and recommendations

```python
anime = Anime("dr stone")

print(anime.url)
print(anime.name)
print(anime.description)    #check the documentation for a list of all supported attributes
print(anime.recommend())  #returns a list of anime recommendations
```

### Anime Lyrics

```python
lyrics = Anilyrics("Ashiato")
print(lyrics.romaji())
```

## Links
* [Documentation](https://animec.readthedocs.io/en/latest/)
* [GitHub](https://github.com/DriftAsimov)
* [MyAnimeList](https://myanimelist.net/)
* [Animesonglyrics](https://www.animesonglyrics.com/)
* [Kaomoji](http://kaomoji.ru/en/)
* [Discord](https://discord.gg/x3qAZV3)