# PyMangaPlus
[![License](https://img.shields.io/github/license/hyugogirubato/pymangaplus)](https://github.com/hyugogirubato/pymangaplus/blob/main/LICENSE)
[![Release](https://img.shields.io/github/release-date/hyugogirubato/pymangaplus)](https://github.com/hyugogirubato/pymangaplus/releases)
[![Latest Version](https://img.shields.io/pypi/v/pymangaplus)](https://pypi.org/project/pymangaplus/)
PyMangaPlus is a Python client for the MangaPlus API, allowing you to access various manga-related information and
features. This library provides a convenient way to interact with the MangaPlus API and retrieve data such as manga
details, chapters, comments, rankings, and more.
## Features
- Retrieve manga details including title, author, description, cover image, and more.
- Get a list of available chapters for a specific manga.
- View manga chapters and read them online.
- Add or remove manga titles from your bookmarks.
- Access publisher news for specific publishers.
- View featured manga titles.
- Retrieve and update user profile information.
- View the home page with recommended manga titles.
- Like or unlike comments on manga chapters.
## Installation
You can install PyMangaPlus using pip:
````shell
pip install pymangaplus
````
## Usage
Here's an example of how to use the PyMangaPlus library:
```python
import secrets
from pymangaplus.client import Client
from pymangaplus.constants import Quality
if __name__ == "__main__":
title_id = 100191 # OSHI NO KO
chapter_id = 1014090 # Chapter 86: ASSISTANT DIRECTOR
android_id = secrets.token_bytes(8).hex()
client = Client()
# Register new device
client.register(android_id)
# Home titles
content = client.home()
print(content)
# View manga chapters
content = client.manga_viewer(chapter_id, quality=Quality.SUPER_HIGH)
print(content)
```
For more information on how to use PyMangaPlus, please refer to
the [documentation](https://github.com/hyugogirubato/pymangaplus/blob/main/docs).
## Disclaimer
PyMangaPlus is an unofficial library and is not affiliated with or endorsed by MangaPlus or Shueisha. The library is
provided "as is" without any warranty, and the usage of this library is at your own risk. Make sure to comply with the
terms and conditions of the MangaPlus service while using this library.
### License
This project is licensed under the [GPL v3 License](https://github.com/hyugogirubato/pymangaplus/blob/main/LICENSE).
Raw data
{
"_id": null,
"home_page": "https://github.com/hyugogirubato/pymangaplus",
"name": "pymangaplus",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "client,manga,ebooks,manga-plus",
"author": "hyugogirubato",
"author_email": "hyugogirubato@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/92/2c/dc512f7df45b07817c8e46ae7205ae7db15f2a62794eae5b66e7698748f5/pymangaplus-1.1.4.tar.gz",
"platform": null,
"description": "# PyMangaPlus\r\n\r\n[![License](https://img.shields.io/github/license/hyugogirubato/pymangaplus)](https://github.com/hyugogirubato/pymangaplus/blob/main/LICENSE)\r\n[![Release](https://img.shields.io/github/release-date/hyugogirubato/pymangaplus)](https://github.com/hyugogirubato/pymangaplus/releases)\r\n[![Latest Version](https://img.shields.io/pypi/v/pymangaplus)](https://pypi.org/project/pymangaplus/)\r\n\r\nPyMangaPlus is a Python client for the MangaPlus API, allowing you to access various manga-related information and\r\nfeatures. This library provides a convenient way to interact with the MangaPlus API and retrieve data such as manga\r\ndetails, chapters, comments, rankings, and more.\r\n\r\n## Features\r\n\r\n- Retrieve manga details including title, author, description, cover image, and more.\r\n- Get a list of available chapters for a specific manga.\r\n- View manga chapters and read them online.\r\n- Add or remove manga titles from your bookmarks.\r\n- Access publisher news for specific publishers.\r\n- View featured manga titles.\r\n- Retrieve and update user profile information.\r\n- View the home page with recommended manga titles.\r\n- Like or unlike comments on manga chapters.\r\n\r\n## Installation\r\n\r\nYou can install PyMangaPlus using pip:\r\n\r\n````shell\r\npip install pymangaplus\r\n````\r\n\r\n## Usage\r\n\r\nHere's an example of how to use the PyMangaPlus library:\r\n\r\n```python\r\nimport secrets\r\n\r\nfrom pymangaplus.client import Client\r\nfrom pymangaplus.constants import Quality\r\n\r\nif __name__ == \"__main__\":\r\n title_id = 100191 # OSHI NO KO\r\n chapter_id = 1014090 # Chapter 86: ASSISTANT DIRECTOR\r\n android_id = secrets.token_bytes(8).hex()\r\n\r\n client = Client()\r\n\r\n # Register new device\r\n client.register(android_id)\r\n\r\n # Home titles\r\n content = client.home()\r\n print(content)\r\n\r\n # View manga chapters\r\n content = client.manga_viewer(chapter_id, quality=Quality.SUPER_HIGH)\r\n print(content)\r\n```\r\n\r\nFor more information on how to use PyMangaPlus, please refer to\r\nthe [documentation](https://github.com/hyugogirubato/pymangaplus/blob/main/docs).\r\n\r\n## Disclaimer\r\n\r\nPyMangaPlus is an unofficial library and is not affiliated with or endorsed by MangaPlus or Shueisha. The library is\r\nprovided \"as is\" without any warranty, and the usage of this library is at your own risk. Make sure to comply with the\r\nterms and conditions of the MangaPlus service while using this library.\r\n\r\n### License\r\n\r\nThis project is licensed under the [GPL v3 License](https://github.com/hyugogirubato/pymangaplus/blob/main/LICENSE).\r\n",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "Python client for the MangaPlus API.",
"version": "1.1.4",
"project_urls": {
"Homepage": "https://github.com/hyugogirubato/pymangaplus"
},
"split_keywords": [
"client",
"manga",
"ebooks",
"manga-plus"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "922cdc512f7df45b07817c8e46ae7205ae7db15f2a62794eae5b66e7698748f5",
"md5": "fc6f4f7398f9c39d32f71cfd994c2ca1",
"sha256": "27ec4685ccc392549ca390e8f5717663230ce973fba7dbb762fe50d86880f19d"
},
"downloads": -1,
"filename": "pymangaplus-1.1.4.tar.gz",
"has_sig": false,
"md5_digest": "fc6f4f7398f9c39d32f71cfd994c2ca1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 27237,
"upload_time": "2024-03-10T16:28:38",
"upload_time_iso_8601": "2024-03-10T16:28:38.475556Z",
"url": "https://files.pythonhosted.org/packages/92/2c/dc512f7df45b07817c8e46ae7205ae7db15f2a62794eae5b66e7698748f5/pymangaplus-1.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-10 16:28:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hyugogirubato",
"github_project": "pymangaplus",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pymangaplus"
}