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/
Scuttlecrab.py - Python Version of Scuttle Crab Bot

____ _ _ _ ____ _ / ___| ___ _ _| |_|

Fabrizo 4 Jul 08, 2022
Discord Blogger Integration Using Blogger API

It's a very simple discord bot created in python using blogger api in order to search and send your website articles in your discord chat in form of an embedded message. It's pretty useful for people

Owen Singh 8 Oct 28, 2022
A Python wrapper for the DeepL API

deepl.py A Python wrapper for the DeepL API installing Install and update using pip: pip install deepl.py A simple example. # Sync Sample import deep

grarich 18 Dec 12, 2022
fair-test is a library to build and deploy FAIR metrics tests APIs supporting the specifications used by the FAIRMetrics working group.

☑️ FAIR test fair-test is a library to build and deploy FAIR metrics tests APIs supporting the specifications used by the FAIRMetrics working group. I

Maastricht University IDS 6 Oct 30, 2022
The world's first public V2ray manager Telegram bot

📌 DarkV2ray-Manager-Bot 0.1 UPDATE 11/11/2021 Telegram bot v2ray Test user expired date data limit paylode && sni usage user on/off heroku bot hostin

@Dk_king_offcial 1 Nov 11, 2021
My beancount practice as a template

my-beancount-template 个人 Beancount 方案的模板仓库 相关博客 复式记账指北（一）：What and Why？ 复式记账指北（二）：做账方法论 复式记账指北（三）：如何打造不半途而废的记账方案 配置 详细配置请参考博客三。必须修改的配置有： Bot功能：data/be

KAAAsS 29 Nov 29, 2022
A robust, low-level connector for the Discord API

Bauxite Bauxite is a robust, low-level connector for the Discord API. What is Bauxite for? Bauxite is made for two main purposes: Creating higher-leve

1 Dec 04, 2021
Detects members having unicode names. Public bot: @scarletwitchprobot

✨ Scarletwitch bot ✨ Detects unicode names members in a tg chat & provides a option to take action on that user ! Public bot: @scarletwitchprobot Supp

ÁÑÑÍHÌLÅTØR SPÄRK 18 Nov 12, 2022
Python wrapper for Xeno-canto API 2.0. Enables downloading bird data with one command line

Python wrapper for Xeno-canto API 2.0. Enables downloading bird data with one command line. Supports multithreading

_zza 9 Dec 10, 2022
Send OpenWeatherMap alerts (One Call API) to telegram users.

OpenWeatherMap Telegram Alert Send OpenWeatherMap alerts (One Call API) to telegram users. Installation Requirements: $ apt install python3-yaml pytho

Michael Hacker 1 Jun 04, 2022
Biblioteca Python que extrai dados de mercado do Bacen (Séries Temporais)

Pybacen This library was developed for economic analysis in the Brazilian scenario (Investments, micro and macroeconomic indicators) Installation Inst

42 Jan 05, 2023
Lambda-function - Python codes that allow notification of changes made to some services using the AWS Lambda Function

AWS Lambda Function This repository contains python codes that allow notificatio

Elif Apaydın 3 Feb 11, 2022
Asynchronous multi-platform robot framework written in Python

NoneBot ✨ 跨平台 Python 异步机器人框架 ✨ 文档 · 安装 · 开始使用 · 文档打不开？ 简介 NoneBot2 是一个现代、跨平台、可扩展的 Python 聊天机器人框架，它基于 Python 的类型注解和异步特性，能够为你的需求实现提供便捷灵活的支持。

NoneBot 3.1k Jan 04, 2023
Due to changes to the discord API and discord.py being discontinued

Talia Due to changes to the discord API and discord.py being discontinued, Talia development has been halted permanently A customizable economy discor

2 Mar 08, 2022
Home Assistant custom integration for controlling Powered by Tuya (PBT) devices using Tuya Open API, officially maintained by the Tuya Developer Team.

Tuya Home Assistant Integration Home Assistant custom integration for controlling Powered by Tuya (PBT) devices using Tuya Open API, officially mainta

Tuya 704 Jan 03, 2023
This is a python wrapper for "the best api in the world"

This is a python wrapper for my api api_url = "https://api.dhravya.me/" This wrapper now has async support, its basically the same except it uses asyn

Dhravya Shah 3 Dec 21, 2021
Data Platform com AWS CDK

Welcome to your CDK Python project! This is a blank project for Python development with CDK. The cdk.json file tells the CDK Toolkit how to execute yo

Andre Sionek 8 Jul 02, 2022
This Instagram app created as a clone of instagram.Developed during Moringa Core.

Instagram This Instagram app created as a clone of instagram.Developed during Moringa Core. AUTHOR By: Nyagah Isaac Description This web-app allows a

Nyagah Isaac 1 Nov 01, 2021
A simple way to create a request to the coinpayment API with a valid HMAC using your private key and command

Coinpayments Verify TXID Created for Astral Discord bot A simple way to create a request to the coinpayment API with a valid HMAC using your private k

HellSec 1 Nov 07, 2022
HTTP API for TON (The Open Network)

HTTP API for The Open Network Since TON nodes uses its own ADNL binary transport protocol, a intermediate service is needed for an HTTP connection. TO

66 Dec 28, 2022