A module to get data about anime characters, news, info, lyrics and more.

Related tags

Third-party APIs Wrapperspythonmusicpackageanimelyricscharacterpipmyanimelistbs4anime-infoanimelyricsanime-newsanime-charactersanime-character-dataanimec
Overview

Animec

A module to get data about anime characters, news, info, lyrics and more. The module scrapes myanimelist to parse requested data.

If you wish to see a feature, please raise an issue. We will surely work on it. You can also join our Discord 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:

pip install animec

To import the module:

import animec
# OR
from animec import *

Examples

Extracting an anime character's data

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

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

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

lyrics = Anilyrics("Ashiato")
print(lyrics.romaji())

Links

Comments
  • Aninews doesn't return the full description

    Aninews doesn't return the full description

    Aninews doesn't return the full description, it is mainly incomplete. Happens the same with Anilyrics. somewhat like this

    Here is a collection of promotional videos (PV), television ads (CM), and trailers for the last week. This thread excludes videos that have already been featured in an article. Please check the News Board, under the Preview tag, for articles that feature a promotional video. Last week's PV thread can be found here. Aggressive Retsuko (ONA) 4th Season | ONA | Trailer The trailer for the fourth season of Aggressive Retsuko reveals that the anime is set to premiere worldwide through the streaming s...

    Thank You

    opened by sagniksen31 4
  • New python file : exceptions.py, Better exception handling

    New python file : exceptions.py, Better exception handling

    It is advisable to have a separate file that contains the different exceptions, the objective is to be able to add and modify exceptions in a simple and fast way. I have created a file called exceptions.py, this file contains the following exceptions:

    • NotFound404
    • NoResultFound
    • TooManyRequests

    To use one of the exceptions, it is imported directly from the file. Look at the code to understand it better. When a new exception is added it should be directly in this new file called exceptions.py

    opened by Mazzya 2
  • Code refactoring

    Code refactoring

    I have applied the PEP 8 - Style Guide for Python Code for the name of the classes, it is recommended to use CapWords for classes :

    anime -> Anime aninews -> AniNews charsearch -> CharSearch anilyrics -> AniLyrics

    I have updated the README.md with the new classes, it is important that you update the documentation.

    opened by Mazzya 1
  • Anime Character Optimisation

    Anime Character Optimisation

    More emphasis on Character Functions

    • [x] Basic Info
    • [ ] Character Votes and Likes (Leaderboard)
    • [ ] Physiology of the Character
    • [ ] Description and Casts
    • [ ] Organisation and Contributors
    enhancement 
    opened by DriftAsimov 1
  • Fix

    Fix "cannot import search from googlesearch" if google is not pre-installed

    Many people are facing an issue which says "cannot import search from googlesearch" if google is not pre-installed in their systems. This is usually faced by users running their scripts on vps.

    opened by DriftAsimov 1
  • Anime ranked will no longer raise AttributeError

    Anime ranked will no longer raise AttributeError

    animec.anicore.Anime.ranked will now return None when the value on MAL's website is N/A

    Before: before

    After: after

    I don't think raising an exception on this case is the best practice, but please kindly correct me if I'm wrong

    opened by munawariz 0
  • Enhancements

    Enhancements

    Things I will be adding to the package:

    • [ ] Character Votes Leaderboard
    • [x] More Character and Anime Information
    • [x] Better Error Handling
    • [x] Anime recommendations
    enhancement 
    opened by DriftAsimov 0
  • To Do's

    To Do's

    Here are the features that I plan to add to the library:

    • [ ] Manga info class
    • [ ] Anime tracker
    • [ ] Faster processing
    • [x] Typehinting
    • [ ] Building cache
    enhancement 
    opened by DriftAsimov 2
Releases(0.4)

  • 0.4(Jan 16, 2022)

  • 0.3.2(Jul 31, 2021)

    This release fixes lots of bugs and has some breaking changes.

    Highlights

    • Url's with special characters are now encoded
    • Fixed animec.Anime raising decrypting errors
    • romaji, kanji and english attributes of Anilyrics class are now methods

    Yes I know I am late in releasing this, it was released on pypi already

    Source code(tar.gz)
    Source code(zip)

  • 0.3.0(Jul 21, 2021)

    Highlights

    This version adds the following to the module:

    • Added Waifu class with a lot of classmethods
    • Fixed url encoding
    • Better stability

    Docs about Waifu class can be found here

    Source code(tar.gz)
    Source code(zip)

  • 0.2.0(Jul 1, 2021)

    This version gives another stable cover to the module.

    Main changes:

    • Added kao function which returns random kaomojis
    • Better toctree for docs
    • Broke exceptions into separate files

    Read the docs to know about more changes!

    Source code(tar.gz)
    Source code(zip)

  • 0.1.50(Jun 14, 2021)

    This release comes with a lot of changes.

    Anime class changes:

    • Added is_nsfw() method
    • Added type, status, producers, genres and teaser attributes
    • Fixed more encoding errors

    General changes:

    • Renamed anime to Anime
    • Renamed aninews to Aninews
    • Renamed charsearch to Charsearch
    • Renamed anilyrics to Anilyrics
    • Reformed gs.py (which is now called helpers.py)

    See the docs at https://animec.readthedocs.io/en/latest/ for more info!

    Source code(tar.gz)
    Source code(zip)

  • 0.1.3(May 23, 2021)

    Major Changes

    • Made docs public which can be found on: https://animec.readthedocs.io/en/latest/
    • Added docstrings to classes
    • Added references attribute to charsearch class
    Source code(tar.gz)
    Source code(zip)

  • 0.1.2(Apr 20, 2021)

  • 0.1.0(Apr 13, 2021)

    Major Fixed

    • Fixed instability
    • Added Exceptions to handle easily
    • Better Error Handling
    • Blocked Heavy Calls

    Improvements

    • Added multiple anime class attributes
    • Better anime news parsing
    • Faster and efficient calls
    Source code(tar.gz)
    Source code(zip)

  • 0.0.8(Apr 13, 2021)

  • 0.0.7(Apr 13, 2021)

  • 0.0.6(Mar 26, 2021)

  • 0.0.5(Mar 26, 2021)

  • 0.0.4(Mar 26, 2021)

    Depreciated

    The following methods have been depreciated:

    • Character search no longer returns a dictionary
    • Returning error if no character is found

    Improvements

    • Now the character search class got attributes
    • They include title, url, and image_url
    Source code(tar.gz)
    Source code(zip)

  • 0.0.3(Mar 24, 2021)

  • 0.0.2(Mar 24, 2021)

    This version was released in-order to stabilise the API and make it ready-to-use.

    Key Features:

    • Stable release
    • Added character url, name and image url
    Source code(tar.gz)
    Source code(zip)

  • 0.0.1(Mar 24, 2021)

Owner
DriftAsimov
Starting things from scratch is exhilarating
DriftAsimov
GitHub Repository http://animec.rtfd.io/
Hermes Bytecode Reverse Engineering Tool (Assemble/Disassemble Hermes Bytecode)

hbctool A command-line interface for disassembling and assembling the Hermes Bytecode. Since the React Native team created their own JavaScript engine

Pongsakorn Sommalai 216 Jan 03, 2023
OGE-2022-na-Python - Solving problems in python for the OGE 2022

OGE-2022-na-Python Решение задачек на питоне для ОГЭ 2022 Тут разобраны разные в

Slava 0 Oct 14, 2022
Forward Propagation, Backward Regression and Pose Association for Hand Tracking in the Wild (CVPR 2022)

HandLer This repository contains the code and data for the following paper: Forward Propagation, Backward Regression, and Pose Association for Hand Tr

<a href=[email protected]"> 17 Oct 02, 2022
GTK3-based panel for sway window manager

nwg-panel I have been using sway since 2019 and find it the most comfortable working environment, but... Have you ever missed all the graphical bells

Piotr Miller 290 Jan 07, 2023
A Telegram bot to download posts, videos, reels, IGTV and a user profile picture from Instagram!

Telegram Bot A telegram bot to download media from Instagram! No API Key or Login Needed! Requirements You must have python installed (of course) You

Simon Farah 2 Apr 10, 2022
Discord Webhook Spammer (fastest)

Discord Webhook Spammer A simple fast asynchronous webhook spammer. Spammer Features Fast message spamming. Controllable speed. Noob friendly. Usage N

Varient 2 Apr 22, 2022
OpenEmu Discord Rich Presence provided with Python!

A simple application that provides your current OpenEmu game as an RPC state in Discord via PyPresence. How to use Unzip and open the latest x86_64 ve

Deltaion Lee 6 May 30, 2022
A fun hangman style game to guess random movie names with a short summary about the movie.

hang-movie-man Hangman but for movies 😉 This is a fun hangman style game to guess random movie names from the local database and show some summary ab

Ankit Josh 10 Sep 07, 2022
Home Assistant Hilo Integration via HACS

BETA This is a beta release. There will be some bugs, issues, etc. Please bear with us and open issues in the repo. Hilo Hilo integration for Home Ass

66 Dec 23, 2022
Make low level API wrapper in fast, easy.

The lowrapper is a library for quickly and easily creating an environment for tapping the API without implementation.

tasuren 1 Oct 25, 2022
SongFinder Bot helps you to find song name by recognising via voice note or instagram reels shared link.

SongFinder V1.1 SongFinder to detect songs name by just sending voice note or instagram reels links to your telegram bot. FFMPEG must be installed on

Abhishek Pathak 4 Dec 30, 2022
Video Stream: an Advanced Telegram Bot that's allow you to play Video & Music on Telegram Group Video Chat

Video Stream is an Advanced Telegram Bot that's allow you to play Video & Music

SHU KURENAI TEAM 4 Nov 05, 2022
An unofficial API for lyricsfreak.com using django and django rest framework.

An unofficial API for lyricsfreak.com using django and django rest framework.

Hesam Norin 1 Feb 09, 2022
Source code of BobuxAdmin bot from Bobux Bot Development server.

BobuxAdmin Source code of BobuxAdmin bot from Bobux Bot Development server. The bot is written with usage of disnake and SQLite database. Functionalit

Bobux Bot Developers 3 Dec 29, 2022
Python: Asynchronous client for the Open-Meteo API.

Python: Asynchronous client for the Open-Meteo API. Asynchronous client for the Open-Meteo API. About Open-Meteo offers free weather forecast APIs for

Franck Nijhof 11 Dec 21, 2022
Telegram Voice Chat UserBot made with Pyrogram and MarshalX/tgcalls with playlist and Heroku support

Telegram Voice Chat UserBot A Telegram UserBot to Play Audio in Voice Chats. This is also the source code of the userbot which is being used for playi

Calls Music 164 Nov 12, 2022
Simple progressbar for discord

⚙️ DiscordProgressbar 📂 Установка | Installation pip install discordbar 📚 Документация | Documentation 📞 Связаться со мной | Сontact with me 📜 Ли

DenyS 26 Nov 30, 2022
A method to check whether a Discord user is using the client or not.

Discord Captcha Method This is an example, of a verification trough a check, if the user loads the picture send with the verification-message. This ma

Julien 2 Jan 19, 2022
Slack->DynamDB->Some applications

slack-event-subscriptions About The Project Do you want to get simple attendance checks? If you are using Slack, participants can just react on a spec

UpstageAI 26 May 28, 2022
A Telegram Video Watermark Adder Bot in Pyrogram by @AbirHasan2005

Watermark-Bot A Telegram Video Watermark Adder Bot by @AbirHasan2005 Features: Save Custom Watermark Image. Auto Resize Watermark According to Video q

Abir Hasan 95 Nov 20, 2022