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
ByDiego Token Grabber is a Discord Stealer

ByDiego Token Grabber is a Discord Stealer. This way you can get too much information from x person if you pass it on and open it

zByDiegoM.T 4 Mar 11, 2022
Versatile async-friendly library to retry failed operations with configurable backoff strategies

riprova riprova (meaning retry in Italian) is a small, general-purpose and versatile Python library that provides retry mechanisms with multiple backo

Tom 108 Apr 27, 2022
How to make a QR Code of your own in python

QR CODE Bilgilendirme! " pip install qrcode pillow " kurmalısınız.

Aktali 1 Dec 24, 2021
Python binding for Microsoft LightGBM

pyLightGBM: python binding for Microsoft LightGBM Features: Regression, Classification (binary, multi class) Feature importance (clf.feature_importanc

Ardalan 330 Nov 18, 2022
Easy to use reaction role Discord bot written in Python.

Reaction Light - Discord Role Bot Light yet powerful reaction role bot coded in Python. Key Features Create multiple custom embedded messages with cus

eibex 109 Dec 20, 2022
An unofficial Python wrapper for the 'Binance exchange REST API'

Welcome to binex_f v0.1.0 many interfaces are heavily used by myself in product environment, the websocket is reliable (re)connected. Latest version:

DeepLn 2 Jan 05, 2022
Dns-Client-Server - Dns Client Server For Python

Dns-client-server DNS Server: supporting all types of queries and replies. Shoul

Nishant Badgujar 1 Feb 15, 2022
Modern, privacy-friendly, and detailed web analytics that works without cookies or JS.

Modern, privacy-friendly, and cookie-free web analytics. Getting started » Screenshots • Features • Office Hours Motivation There are a lot of web ana

R. Miles McCain 2.1k Jan 03, 2023
A discord bot that send SMS spam!

bruh-bot send spam sms! send spam with email! it sends you spam via sms and Email using two tools, quack and impulse! if you have some problem contact

pai 32 Dec 25, 2022
An all-in-one discord bot!

Interbot Interbot is a do-it-all bot originally made for the Interbyte Studios discord server. This repo contains the code for this bot, allowing you

Logan 5 Aug 03, 2021
A Bot to get RealTime Tweets to a Specific Chats from Desired Persons on Twitter to Telegram Chat.

TgTwitterStreamer A Bot to get RealTime Tweets to a Specific Chats from Desired Persons on Twitter to Telegram Chat. For Getting ENV's Refer this Link

Anonymous 69 Dec 20, 2022
A python API wrapper for temp-mail.org

temp-mail Python API Wrapper for temp-mail.ru service. Temp-mail is a service which lets you use anonymous emails for free. You can view full API spec

Denis Veselov 91 Nov 19, 2022
Simple Telegram Bot To Get Feedback from users & Some Other Features

FeedbackBot Simple Telegram Bot To Get Feedback from users & Some Other Features. Features Get Feedback from users Reply to user's feedback Customisab

Arun 18 Dec 29, 2022
Send automated wishes to your contacts at scheduled time through WhatsApp. Written for Raspberry pi.

Whatsapp Automated Wishes Helps to send automated wishes to your contacts in Whatsapp at scheduled time using pywhatkit . Written for Raspberry pi. Wi

Uthayamurthy 2 Dec 13, 2022
Useful tools for building interactions in Python

discord-interactions-python Types and helper functions for Discord Interactions webhooks. Installation Available via pypi: pip install discord-interac

Discord 77 Dec 07, 2022
Full-featured Python interface for the Slack API

This repository is archived and will not receive any updates It's time to say goodbye. I'm archiving Slacker. It's been getting harder to find time to

Oktay Sancak 1.6k Dec 13, 2022
Wrapper for Between - 비트윈을 위한 파이썬 라이브러리

PyBetween Wrapper for Between - 비트윈을 위한 파이썬 라이브러리 Legal Disclaimer 오직 교육적 목적으로만 사용할수 있으며, 비트윈은 VCNC의 자산입니다. 악의적 공격에 이용할시 처벌 받을수 있습니다. 사용에 따른 책임은 사용자가

1 Mar 15, 2022
Discord Panel is an AIO panel for Discord that aims to have all the needed tools related to user token interactions, as in nuking and also everything you could possibly need for raids

Discord Panel Discord Panel is an AIO panel for Discord that aims to have all the needed tools related to user token interactions, as in nuking and al

11 Mar 30, 2022
Sielzz Music adalah proyek bot musik telegram, memungkinkan Anda memutar musik di telegram grup obrolan suara.

Hi, I am: Requirements 📝 FFmpeg NodeJS nodesource.com Python 3.8 or higher PyTgCalls MongoDB Get STRING_SESSION from below: 🎖 History Features 🔮 Th

1 Nov 04, 2021