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
Remedy when Amazon ECR is not running basic scans for container CVEs.

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

4n6ir 4 Nov 05, 2022
Repositorio dedicado a contener los archivos fuentes del bot de discord "Lector de Ejercicios".

Lector de Ejercicios Este bot de discord está pensado para usarse únicamente en el discord de la materia Algoritmos y Programación I, de la Facultad d

Franco Lighterman Reismann 3 Sep 17, 2022
:cloud: Python API for ThePirateBay.

Unofficial Python API for ThePirateBay. Build Status Test Coverage Version Downloads (30 days) Installation $ pip install ThePirateBay Note that ThePi

Karan Goel 334 Oct 21, 2022
A updated and improved version from the original Discord-Netflix from Nirewen.

Discord-Netflix A updated version from the original Discord-Netflix from nirewen A Netflix wrapper that uses Discord RPC to show what you're watching

Void 42 Jan 02, 2023
Telegram 隨機色圖,支援每日自動爬取

Telegram 隨機色圖機器人 使用此原始碼的Bot 開放的隨機色圖機器人: @katonei_bot 已實現的功能 爬取每日R18排行榜 不夠色!再來一張 Tag 索引,指定Tag色圖 將爬取到的色圖轉為 WebP 格式儲存,節省空間 需要注意的事件 好久之前的怪東西,代碼質量不保證 請在使用A

cluckbird 15 Oct 18, 2021
Pincer-bot-template - A template for a Discord bot created using the Pincer library

Pincer Discord Bot Template (Python) WARNING: Pincer is still in its alpha/plann

binds 2 Mar 17, 2022
Discord ToolBox is a discord bot developed by DJD320 created for the purpose of having some convenient tools in the form of a single bot.

Discord ToolBox Discord ToolBox is a discord bot developed by DJD320 created for the purpose of having some convenient tools in the form of a single b

3 Aug 07, 2021
Wordle-bot: A Discord bot to track you and your friends' Wordle scores.

wordle-bot A Discord bot to track you and your friends' Wordle scores, so you can see who's the best! To submit a score to wordle-bot, just paste the

Spencer Murray 8 Feb 16, 2022
A tiktok autoclaimer/sniper used to get og/rare usernames on tiktok.com

TikTok Autoclaimer A tiktok autoclaimer/sniper used to get og/rare usernames on tiktok.com Report Bug · Request Feature Features Asynchronous User fri

dropout 24 Dec 08, 2022
Stream Telegram files to web

Telegram File Stream Bot A Telegram bot to stream files to web Demo Bot » Report a Bug | Request Feature Table of Contents About this Bot Original Rep

Wrench 572 Jan 09, 2023
ANKIT-OS/TG-SESSION-GENERATOR-BOTbisTG-SESSION-GENERATOR-BOT a special repository. Its Is A Telegram Bot To Generate String Session

ANKIT-OS/TG-SESSION-GENERATOR-BOTbisTG-SESSION-GENERATOR-BOT a special repository. Its Is A Telegram Bot To Generate String Session

ANKIT KUMAR 1 Dec 26, 2021
Telegram Group Management Bot based on Pyrogram

Komi-San Telegram Group Management Bot based on Pyrogram More updates coming soon Support Group Open a Pull request if you wana contribute Example for

33 Nov 07, 2022
This is a simple grabber written in Python which helps you to grab products from Willhaben.at

Willhaben Grabber This is a simple grabber written in Python which helps you to grab products from Willhaben.at General info The tool generates a sear

Ramo 0 Feb 16, 2022
Market calendar RESTful API with holiday, late open, and early close. Over 50+ unique exchange calendars for global equity and futures markets.

Trading Calendar Market calendar RESTful API with holiday, late open, and early close. Over 50+ unique exchange calendars for global equity and future

Apptastic Software 1 Feb 03, 2022
Sunflower-farmers-automated-bot - Sunflower Farmers NFT Game automated bot.IT IS NOT a cheat or hack bot

Sunflower-farmers-auto-bot Sunflower Farmers NFT Game automated bot.IT IS NOT a

Arthur Alves 17 Nov 09, 2022
A Webhook spammer For Python

Webhooker Optimizations Asynchronous Fast & Efficient Multi Tasked Usage Put high threads/tasks for maximum impact Webhook must be valid Proof of conc

andria 1 Dec 20, 2021
TwitterDataStreaming - Twitter data streaming using APIs

Twitter_Data_Streaming Twitter data streaming using APIs Use Case 1: Streaming r

Rita Kushwaha 1 Jan 21, 2022
Bender: A Markov Babbler Slack Bot

See the Digital Ocean tutorial for instructions on how to get the basic bot structure in place. Once you have that, set the gunicorn command to run as

Andrew Howard 1 Dec 04, 2021
471 Dec 24, 2022
Python Package For MTN Zambia Momo API. This package can also be used by MTN momo in other countries.

MTN MoMo API Lite Python Client Power your apps with Lite-Python MTN MoMo API Usage Installation Add the latest version of the library to your project

Mathews Musukuma 7 Jan 01, 2023