This is Pyanimu. The structure was inspired by Pymoe and Osuapi. The sync/async structure is very similar to Osuapi.

This is created to help folk like me who don't want to deal with XML anymore. It is a not perfect, non ideal library. For a more frequently used library I recommend Pymoe, but Pymoe is sync only.

This is my first public library that I've shared with others. It was created for fun and for learning. Any feedback is always appreciated, but I may not be able to update it often.

When I get the time, I might add more than just myanimelist, this is why it is structured in this modular fashion. Feel free to give me a heads up about missing documentation as the MAL API documentation is...awful.

I apologize in advance if there is anything missing or implemented incorrectly.

I am ready to be roast.

Note, MAL is not available at this moment. There been saying that instead of bring it back up, they might bring up new api version. This is unknown sources. So at this moment, Anilist is working.

Requirement Libs:

BeautifulSoup, LXML
and either Aiohttp or Requests depending on what you need for.

Mal (unavailable atm)

To create an instance.

from pyanimu import Mal, connectors, Userstatus

con = connectors.ReqAnimu(user_agent = "Pyanimu") # or AioAnimu() for async

# Since every endpoint requires account expect one-two, therefore username/password isn't optional
mal = Mal(username, password,con)  
#it may return an object or list of an object depending on search queue.
manga_obj = mal.search_manga("DN Angel") 

#getting info from this data.
community_score = manga_obj.score #getting community score on it.

#want to update info to user list.
manga_obj.user_score = 7
manga_obj.user_status = UserStatus.completed
mal.update(manga_obj)


#Wanting to add anime to user list.
anime = mal.search_anime("Berserk")
for x in anime:
    if x.title == "Berserk":
        x.user_status = UserStatus.plantowatch #by default it will set plan to watch anyway
        data = mal.add(x)
        break

using Async function

It is same as Sync function except search user which is aio_search_user.

con = connectors.AioAnimu()
mal = MAL(username, password,con)

async def get_data():
	anime_obj = await mal.search_anime("Trigun")
	user_obj = await mal.aio_search_user("Maverun") #Getting anime info about this user.
	#do stuff 
	

results = asyncio.get_event_loop().run_until_complete(get_data())

Method to call

verify():return boolean
search_anime(title):return object of an Anime. It may be an individual or list of an Anime Object.
search_manga(title):return object of Manga. It may be an individual or list of Manga object
aio_search_user(name): return User object. This is async function only.
req_search_user(name): return User object. This is sync function only.
add(obj): require Anime/Manga object to add it to their user list.
update(obj): require Anime/Manga object to update it to their user list.
delete(obj): require Anime/Manga object to delete it from their user list.

Note:

search_ prefix method only return itself object where user attributes related will be None, while running search user list for anime or manga will only return user fields. Since MAL API does not return both at once.

Anime

From Search Anime.

id:int:Anime ID
title:string: Anime Title
english:string:Anime Title in English
synonyms:string: Different Anime Title
episodes:int: Anime's total episodes
type:string: TV,Movie,Ova etc
status:string: return either one of those [Airing, Finished Airing, Not yet aired]
start_date:string: yyyy-mm-dd date of first day airing.
end_date:string: yyyy-mm-dd date of finished airing.
synopsis:string: description of show.
image:string: url of anime's picture cover.
score:int: Average score from community.

From User object only.

user_id:int: User ID from myanimelist
current_episode:int: current ep that user have watched.
date_start:string:yyyy-mm-dd date that user start watching it
date_finish:string:yyyy-mm-dd date that user have finished watching it.
user_score:int: a score that user give.
user_status: Status that user have put in. prefer accept UserStatus object, as int can be changed any time.
rewatch:int: How many time have user watched this anime already.
rewatch_ep:int: total episode including rewatched.
last_updated:string:

Manga

From Search Manga.

id:int:Manga ID
title:string: Manga Title
english:string:Manga Title in English
synonyms:string: Different Anime Title
chapters:int: Manga's total chapters 
volumes:int: Volume of total capters held.
score:int: Average score from community.
type:string: type of manga it is, [Manga,Novel,One-Shot] etc.
status: Status of this manga if it one of those [Publishing, Finished].
start_date:string: yyyy-mm-dd date of first day publish.
end_date:string: yyyy-mm-dd date of finished publish. 
synopsis:string: description of manga.
image:string:url of manga covered

From User List.

user_id:int: User ID from myanimelist
read_chapters:int: current chapter that user is at
read_volumes:int: current volume that user is at
date_start:string:yyyy-mm-dd the date of user start reading
date_finish:string:yyyy-mm-dd the date of user finished reading
user_score:int:Score that user give to
user_status:int:Status that user give, recommend using UserStatus Object.
rereading:int: how many time have user reread it
rereading_chap:int:total chap including rereading time that user have read
last_updated:string: yyyy-mm-dd last update touch by users

User Object

anime:list:Anime object list that you hve seen
manga:list:Manga object list that you hve seen
anime_watching:string: watching tracking 
anime_completed:string: completed tracking 
anime_onhold:string: onhold tracking 
anime_dropped :string: dropped tracking  
anime_plan_to_watch :string: plan_to_read tracking  
anime_days:string: days tracking 
manga_reading:string: reading tracking 
manga_completed:string: completed tracking 
manga_onhold:string: onhold tracking 
manga_dropped:string: dropped tracking 
manga_plan_to_read:string: plan_to_read tracking 
manga_days:string: days tracking

User Status

watching
reading
completed
onhold
dropped
plantowatch
plantoread

Anilist

Please read guideline here Anilist Doc to ensure you are not doing something against it. This is not for storing or any so reason. This is getting data to be used at a moment.

Note: You can do SYNC or ASYNC. all method for async are same expect that you will need to await and use `connectors.AioAnimu()`