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

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.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
Ditch Xiaomi's cloud and use a Telegram bot instead

Yi-Home_Telegram_Bot_Interface Ditch Xiaomi's cloud and use a Telegram bot instead Features Motion detection Works by monitoring a tmp file that is cr

Erli 10 Aug 18, 2022
Stinky ID - A stable pluggable Telegram userbot + Voice & Video Call music bot, based on Telethon

Ultroid - UserBot A stable pluggable Telegram userbot + Voice & Video Call music

Riyan.rz 1 Jan 03, 2022
The first open-source PyTgCalls-based project.

SU Music Player — The first open-source PyTgCalls based Pyrogram bot to play music in voice chats Requirements FFmpeg NodeJS 15+ Python 3.7+ Deploymen

Calls Music 74 Nov 19, 2022
Robust and blazing fast open-redirect vulnerability scanner with ability of recursevely crawling all of web-forms, entry points, or links with data.

After Golismero project got dead there is no more any up to date open-source tool that can collect links with parametrs and web-forms and then test th

railway zeppelin 34 Aug 25, 2022
Python Client for Instagram API

This project is not actively maintained. Proceed at your own risk! python-instagram A Python 2/3 client for the Instagram REST and Search APIs Install

Facebook Archive 2.9k Dec 30, 2022
1.本项目采用Python Flask框架开发提供(应用管理,实例管理,Ansible管理,LDAP管理等相关功能)

op-devops-api 1.本项目采用Python Flask框架开发提供(应用管理,实例管理,Ansible管理,LDAP管理等相关功能) 后端项目配套前端项目为:op-devops-ui jenkinsManager 一.插件python-jenkins bug修复 (1).插件版本 pyt

3 Nov 12, 2021
A simple Python library to integrate with the Heron Data API

Heron Python This library provides easy access to the Heron Data API from applications written in Python. Documentation No language-specific docs are

Heron Data 11 Nov 11, 2022
Improved file host. Change of interface and storage: 15 GB available.

File hosting v2 Improved file host. Change of interface and storage: 15 GB available. This app now uses the Google API to store, view, and delete file

Sarusman 1 Jan 18, 2022
Collaboration with Microsoft, AWS, Google, and ETHZürich Analytics Club (2022 Datathon Project)

DATATHON_ Collaboration with Microsoft, AWS, Google, and ETHZürich Analytics Club (2022 Datathon Project) Datathon Original Challenge SAV DataDays Rei

esthi 34 Nov 10, 2022
Discord Rpc With Python And 2 Buttons

Discord-RPC-With-Python- Discord Rpc With Python And 2 Buttons Packages pypresence time Required Programs Python Latest Version Random IDE Discord :P

Kaz 4 Dec 12, 2021
MusicBot is the original Discord music bot written for Python 3.5+, using the discord.py library

The original MusicBot for Discord (formerly SexualRhinoceros/MusicBot)

Just Some Bots 2.9k Jan 02, 2023
Track to Detect and Segment: An Online Multi-Object Tracker (CVPR 2021)

Track to Detect and Segment: An Online Multi-Object Tracker (CVPR 2021) Track to Detect and Segment: An Online Multi-Object Tracker Jialian Wu, Jiale

Jialian Wu 520 Dec 31, 2022
Coronavirus whatsapp chatbot to give real time info on covid

Covy Developed a coronavirus whatsapp chatbot which gives case counts in a particular district, city, state or country. It also predicts future cases

Devinco (Rachit) 0 Oct 03, 2021
Simple Python Auto Follow Bot

Instagram-Auto-Follow-Bot Description Một IG BOT đơn giản. Tự động follow những người mà bạn muốn cướp follow. Tự động unfollow. Tự động đăng nhập vào

CodingLinhTinh 3 Aug 27, 2022
Seems Like Everyone Is Posting This, Thought I Should Too, Tokens Get Locked Upon Creation And Im Not Going To Fix For Several Reasons

Member-Booster Seems Like Everyone Is Posting This, Thought I Should Too, Tokens Get Locked Upon Creation And Im Not Going To Fix For Several Reasons

Mintyz 1 Dec 28, 2021
BiliBili-live-barrage-transceiver - A simple python program for sending and receiving barrage in bilibili live room

BiliBili-live-barrage-transceiver - A simple python program for sending and receiving barrage in bilibili live room

zeroy 2 Jan 18, 2022
An Open Source ALL-In-One Telegram RoBot, that can do lot of things.

URL Uploader Bot An Open Source ALL-In-One Telegram RoBot, that can do lot of things. My Features Installation The Easy Way You can also tap the Deplo

NT BOTS 1 Oct 23, 2021
A simple API wrapper for Discord written in Python.

AIOCord This project is work in progress not for production use A simple asynchronous API wrapper around Discord API written in Python. Inspiration Th

Izhar Ahmad 3 Dec 07, 2021
GitHub Actions Docker training

GitHub-Actions-Docker-training Training exercise repository for GitHub Actions using a docker base. This repository should be cloned and used for trai

GitHub School 1 Jan 21, 2022
An unofficial client library for Google Music.

gmusicapi: an unofficial API for Google Play Music gmusicapi allows control of Google Music with Python. from gmusicapi import Mobileclient api = Mob

Simon Weber 2.5k Dec 15, 2022