hondana 2.2.2

An asynchronous wrapper around the MangaDex v5 API

Hondana 『本棚』

A lightweight and asynchronous wrapper around the MangaDex v5 API. You can see our stable docs here!

Features

We are currently at 100% feature compliance with the API.

Notes

Authenticated endpoints

Sadly (thankfully?) I am not an author on MangaDex, meaning I cannot test the creation endpoints for things like scanlators, artists, authors, manga or chapters. I have followed the API guidelines to the letter for these, but they may not work.

Any help in testing them is greatly appreciated.

Upload & Creation

Following the above, I can only use the public test manga for upload testing. These are currently implemented and tested to the best of my ability.

Examples

Please take a look at the examples directory for working examples.

NOTE: More examples will follow as the library is developed.

API caveats to note

• There are no API endpoints for Artist. It seems they are not differentiated from Author types except in name only.
  • I have separated them logically, but under the hood all Artists are Authors and their __eq__ reports as such.
• The tags are locally cached since you must pass UUIDs to the api (and I do not think you're going to memorize those), there's a convenience method for updating the local cache as Client.update_tags
  • I have added an example on how to do the above.
  • To use these tags, you can see an example here.
• Settings related endpoints are not currently exposed. I have implemented their documented use, but I do not expect them to currently function.
  • Once this is exposed fully I will implement a richer interface.

Contributing

If you would like to contribute to Hondana, please take a look at the contributing guidelines and follow the procedure there.

If you have any question please feel free to join my Discord server: