Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sinkaroid/janda

Python library for Jandapress
https://github.com/sinkaroid/janda

Last synced: about 1 month ago
JSON representation

Python library for Jandapress

Host: GitHub
URL: https://github.com/sinkaroid/janda
Owner: sinkaroid
License: mit
Created: 2022-03-15T15:17:09.000Z (over 2 years ago)
Default Branch: master
Last Pushed: 2023-04-11T15:53:05.000Z (over 1 year ago)
Last Synced: 2024-09-29T11:33:19.562Z (2 months ago)
Language: Python
Homepage: https://sinkaroid.github.io/janda
Size: 143 KB
Stars: 16
Watchers: 3
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md

Awesome Lists containing this project

awesome-indo-projects - Janda - A featureful Python library covers most popular doujinshi API. (Python)
awesome-indonesia-repo - Janda - A featureful Python library covers most popular doujinshi API. (Python)

README

Python library for Jandapress

Interacts from python, simplified the usage, and intelisense definitions on your IDEs

Contributing •
Documentation •
Report Issues

- [Janda](#)
- [Jandapress](#jandapress)
- [Features](#janda-vs-the-competition)
- [Installation](#installation)
- [Prerequisites](#prerequisites)
- [Documentation](https://sinkaroid.github.io/janda/)
- [Example](#example)
- [Janda.resolve()](#jandaresolve)
- [Known issues](#known-issues)
- [Pronunciation](#pronunciation)
- [Legal](#legal)

---

## Jandapress
If you prefer with raw api and want to dealing with cloudflare stuff use jandapress
- [jandapress](https://github.com/sinkaroid/jandapress) — RESTful and experimental API for nhentai and other doujinshi

## Janda vs. the Competition

Features availability from jandapress

| Client | Status | Get | Search | Random |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ----- | ------ | ---------- |
| nhentai | [![status](https://img.shields.io/badge/status-stable-green)](https://github.com/sinkaroid/janda/actions/workflows/nhentai.yml) | `Yes` | `Yes` | `Yes` |
| pururin | [![status](https://img.shields.io/badge/status-stable-green)](https://github.com/sinkaroid/janda/actions/workflows/pururin.yml) | `Yes` | `Yes` | `Yes` |
| hentaifox | [![status](https://img.shields.io/badge/status-stable-green)](https://github.com/sinkaroid/janda/actions/workflows/hentaifox.yml) | `Yes` | `Yes` | `Yes` |
| hentai2read | [![status](https://img.shields.io/badge/status-partial-blue)](https://github.com/sinkaroid/janda/actions/workflows/hentai2read.yml) | `Yes` | `Yes` | `No` |
| simply-hentai | [![status](https://img.shields.io/badge/status-triage-red)](https://github.com/sinkaroid/janda/actions/workflows/simplyh.yml) | `Yes` | `No` | `No` |
| asmhentai | [![status](https://img.shields.io/badge/status-stable-green)](https://github.com/sinkaroid/janda/actions/workflows/asmhentai.yml) | `Yes` | `Yes` | `Yes` |
| 3hentai | [![status](https://img.shields.io/badge/status-stable-green)](https://github.com/sinkaroid/janda/actions/workflows/thentai.yml) | `Yes` | `Yes` | `Yes` |

## Prerequisites

- Python 3.7 or above

## Installation
`pip install janda`
- Or manual build by cloning this repository and run `python setup.py install`

To use specific site api, You could specify import for example:
- `from janda import Nhentai`

then initializes the client, an [api key](https://scathach.id/login) is optional

## Example
Some methods require additional parameters, check your intelisense.

### get
`(method) get: (book: int, safe: bool | None = None) -> Coroutine`
```py
import asyncio
from janda import Nhentai, resolve

async def book():
nh = Nhentai()
data = await nh.get(177013)
print(data) ## this is
print(resolve(data)) ## this is

async def main():
await asyncio.gather(book())

asyncio.run(main())
```

### search
`(tags: str, page: int = 1, popular: str = 'today') -> Coroutine`

```py
await nh.search("jeanne alter", 1, "today")
```
## janda.resolve()
You will need this for every object, this library designed to be neat and clean returns, although it must be reparsed to the string first, that's why `janda.resolve()` exist.

## Documentation
The documentation can be found [https://sinkaroid.github.io/janda](https://sinkaroid.github.io/janda)

## Returns example
`get` method will represent as **Book Object** and packed with actionable image urls
```js
{
"data": {
"artist": [
"shindol"
],
"characters": [],
"group": null,
"id": 177013,
"image": [
"https://i.nhentai.net/galleries/987560/1.jpg",
"https://i.nhentai.net/galleries/987560/2.jpg",
"https://i.nhentai.net/galleries/987560/3.jpg",
"https://i.nhentai.net/galleries/987560/4.jpg",
"https://i.nhentai.net/galleries/987560/5.jpg",
"https://i.nhentai.net/galleries/987560/6.jpg",
"https://i.nhentai.net/galleries/987560/7.jpg",
"https://i.nhentai.net/galleries/987560/8.jpg",
"https://i.nhentai.net/galleries/987560/9.jpg",
"https://i.nhentai.net/galleries/987560/10.jpg",
"https://i.nhentai.net/galleries/987560/11.jpg",
"https://i.nhentai.net/galleries/987560/12.jpg",
"https://i.nhentai.net/galleries/987560/13.jpg",
"https://i.nhentai.net/galleries/987560/14.jpg",
"https://i.nhentai.net/galleries/987560/15.jpg",
"https://i.nhentai.net/galleries/987560/16.jpg",
"https://i.nhentai.net/galleries/987560/17.jpg",
"https://i.nhentai.net/galleries/987560/18.jpg",
"https://i.nhentai.net/galleries/987560/19.jpg",
"https://i.nhentai.net/galleries/987560/20.jpg",
"https://i.nhentai.net/galleries/987560/21.jpg",
"https://i.nhentai.net/galleries/987560/22.jpg",
"https://i.nhentai.net/galleries/987560/23.jpg",
"https://i.nhentai.net/galleries/987560/24.jpg",
"https://i.nhentai.net/galleries/987560/25.jpg",
"https://i.nhentai.net/galleries/987560/26.jpg",
"https://i.nhentai.net/galleries/987560/27.jpg",
"https://i.nhentai.net/galleries/987560/28.jpg",
"https://i.nhentai.net/galleries/987560/29.jpg",
"https://i.nhentai.net/galleries/987560/30.jpg",
"https://i.nhentai.net/galleries/987560/31.jpg",
"https://i.nhentai.net/galleries/987560/32.jpg",
"https://i.nhentai.net/galleries/987560/33.jpg",
"https://i.nhentai.net/galleries/987560/34.jpg",
"https://i.nhentai.net/galleries/987560/35.jpg",
"https://i.nhentai.net/galleries/987560/36.jpg",
"https://i.nhentai.net/galleries/987560/37.jpg",
"https://i.nhentai.net/galleries/987560/38.jpg",
"https://i.nhentai.net/galleries/987560/39.jpg",
"https://i.nhentai.net/galleries/987560/40.jpg",
"https://i.nhentai.net/galleries/987560/41.jpg",
"https://i.nhentai.net/galleries/987560/42.jpg",
"https://i.nhentai.net/galleries/987560/43.jpg",
"https://i.nhentai.net/galleries/987560/44.jpg",
"https://i.nhentai.net/galleries/987560/45.jpg",
"https://i.nhentai.net/galleries/987560/46.jpg",
"https://i.nhentai.net/galleries/987560/47.jpg",
"https://i.nhentai.net/galleries/987560/48.jpg",
"https://i.nhentai.net/galleries/987560/49.jpg",
"https://i.nhentai.net/galleries/987560/50.jpg",
"https://i.nhentai.net/galleries/987560/51.jpg",
"https://i.nhentai.net/galleries/987560/52.jpg",
"https://i.nhentai.net/galleries/987560/53.jpg",
"https://i.nhentai.net/galleries/987560/54.jpg",
"https://i.nhentai.net/galleries/987560/55.jpg",
"https://i.nhentai.net/galleries/987560/56.jpg",
"https://i.nhentai.net/galleries/987560/57.jpg",
"https://i.nhentai.net/galleries/987560/58.jpg",
"https://i.nhentai.net/galleries/987560/59.jpg",
"https://i.nhentai.net/galleries/987560/60.jpg",
"https://i.nhentai.net/galleries/987560/61.jpg",
"https://i.nhentai.net/galleries/987560/62.jpg",
"https://i.nhentai.net/galleries/987560/63.jpg",
"https://i.nhentai.net/galleries/987560/64.jpg",
"https://i.nhentai.net/galleries/987560/65.jpg",
"https://i.nhentai.net/galleries/987560/66.jpg",
"https://i.nhentai.net/galleries/987560/67.jpg",
"https://i.nhentai.net/galleries/987560/68.jpg",
"https://i.nhentai.net/galleries/987560/69.jpg",
"https://i.nhentai.net/galleries/987560/70.jpg",
"https://i.nhentai.net/galleries/987560/71.jpg",
"https://i.nhentai.net/galleries/987560/72.jpg",
"https://i.nhentai.net/galleries/987560/73.jpg",
"https://i.nhentai.net/galleries/987560/74.jpg",
"https://i.nhentai.net/galleries/987560/75.jpg",
"https://i.nhentai.net/galleries/987560/76.jpg",
"https://i.nhentai.net/galleries/987560/77.jpg",
"https://i.nhentai.net/galleries/987560/78.jpg",
"https://i.nhentai.net/galleries/987560/79.jpg",
"https://i.nhentai.net/galleries/987560/80.jpg",
"https://i.nhentai.net/galleries/987560/81.jpg",
"https://i.nhentai.net/galleries/987560/82.jpg",
"https://i.nhentai.net/galleries/987560/83.jpg",
"https://i.nhentai.net/galleries/987560/84.jpg",
"https://i.nhentai.net/galleries/987560/85.jpg",
"https://i.nhentai.net/galleries/987560/86.jpg",
"https://i.nhentai.net/galleries/987560/87.jpg",
"https://i.nhentai.net/galleries/987560/88.jpg",
"https://i.nhentai.net/galleries/987560/89.jpg",
"https://i.nhentai.net/galleries/987560/90.jpg",
"https://i.nhentai.net/galleries/987560/91.jpg",
"https://i.nhentai.net/galleries/987560/92.jpg",
"https://i.nhentai.net/galleries/987560/93.jpg",
"https://i.nhentai.net/galleries/987560/94.jpg",
"https://i.nhentai.net/galleries/987560/95.jpg",
"https://i.nhentai.net/galleries/987560/96.jpg",
"https://i.nhentai.net/galleries/987560/97.jpg",
"https://i.nhentai.net/galleries/987560/98.jpg",
"https://i.nhentai.net/galleries/987560/99.jpg",
"https://i.nhentai.net/galleries/987560/100.jpg",
"https://i.nhentai.net/galleries/987560/101.jpg",
"https://i.nhentai.net/galleries/987560/102.jpg",
"https://i.nhentai.net/galleries/987560/103.jpg",
"https://i.nhentai.net/galleries/987560/104.jpg",
"https://i.nhentai.net/galleries/987560/105.jpg",
"https://i.nhentai.net/galleries/987560/106.jpg",
"https://i.nhentai.net/galleries/987560/107.jpg",
"https://i.nhentai.net/galleries/987560/108.jpg",
"https://i.nhentai.net/galleries/987560/109.jpg",
"https://i.nhentai.net/galleries/987560/110.jpg",
"https://i.nhentai.net/galleries/987560/111.jpg",
"https://i.nhentai.net/galleries/987560/112.jpg",
"https://i.nhentai.net/galleries/987560/113.jpg",
"https://i.nhentai.net/galleries/987560/114.jpg",
"https://i.nhentai.net/galleries/987560/115.jpg",
"https://i.nhentai.net/galleries/987560/116.jpg",
"https://i.nhentai.net/galleries/987560/117.jpg",
"https://i.nhentai.net/galleries/987560/118.jpg",
"https://i.nhentai.net/galleries/987560/119.jpg",
"https://i.nhentai.net/galleries/987560/120.jpg",
"https://i.nhentai.net/galleries/987560/121.jpg",
"https://i.nhentai.net/galleries/987560/122.jpg",
"https://i.nhentai.net/galleries/987560/123.jpg",
"https://i.nhentai.net/galleries/987560/124.jpg",
"https://i.nhentai.net/galleries/987560/125.jpg",
"https://i.nhentai.net/galleries/987560/126.jpg",
"https://i.nhentai.net/galleries/987560/127.jpg",
"https://i.nhentai.net/galleries/987560/128.jpg",
"https://i.nhentai.net/galleries/987560/129.jpg",
"https://i.nhentai.net/galleries/987560/130.jpg",
"https://i.nhentai.net/galleries/987560/131.jpg",
"https://i.nhentai.net/galleries/987560/132.jpg",
"https://i.nhentai.net/galleries/987560/133.jpg",
"https://i.nhentai.net/galleries/987560/134.jpg",
"https://i.nhentai.net/galleries/987560/135.jpg",
"https://i.nhentai.net/galleries/987560/136.jpg",
"https://i.nhentai.net/galleries/987560/137.jpg",
"https://i.nhentai.net/galleries/987560/138.jpg",
"https://i.nhentai.net/galleries/987560/139.jpg",
"https://i.nhentai.net/galleries/987560/140.jpg",
"https://i.nhentai.net/galleries/987560/141.jpg",
"https://i.nhentai.net/galleries/987560/142.jpg",
"https://i.nhentai.net/galleries/987560/143.jpg",
"https://i.nhentai.net/galleries/987560/144.jpg",
"https://i.nhentai.net/galleries/987560/145.jpg",
"https://i.nhentai.net/galleries/987560/146.jpg",
"https://i.nhentai.net/galleries/987560/147.jpg",
"https://i.nhentai.net/galleries/987560/148.jpg",
"https://i.nhentai.net/galleries/987560/149.jpg",
"https://i.nhentai.net/galleries/987560/150.jpg",
"https://i.nhentai.net/galleries/987560/151.jpg",
"https://i.nhentai.net/galleries/987560/152.jpg",
"https://i.nhentai.net/galleries/987560/153.jpg",
"https://i.nhentai.net/galleries/987560/154.jpg",
"https://i.nhentai.net/galleries/987560/155.jpg",
"https://i.nhentai.net/galleries/987560/156.jpg",
"https://i.nhentai.net/galleries/987560/157.jpg",
"https://i.nhentai.net/galleries/987560/158.jpg",
"https://i.nhentai.net/galleries/987560/159.jpg",
"https://i.nhentai.net/galleries/987560/160.jpg",
"https://i.nhentai.net/galleries/987560/161.jpg",
"https://i.nhentai.net/galleries/987560/162.jpg",
"https://i.nhentai.net/galleries/987560/163.jpg",
"https://i.nhentai.net/galleries/987560/164.jpg",
"https://i.nhentai.net/galleries/987560/165.jpg",
"https://i.nhentai.net/galleries/987560/166.jpg",
"https://i.nhentai.net/galleries/987560/167.jpg",
"https://i.nhentai.net/galleries/987560/168.jpg",
"https://i.nhentai.net/galleries/987560/169.jpg",
"https://i.nhentai.net/galleries/987560/170.jpg",
"https://i.nhentai.net/galleries/987560/171.jpg",
"https://i.nhentai.net/galleries/987560/172.jpg",
"https://i.nhentai.net/galleries/987560/173.jpg",
"https://i.nhentai.net/galleries/987560/174.jpg",
"https://i.nhentai.net/galleries/987560/175.jpg",
"https://i.nhentai.net/galleries/987560/176.jpg",
"https://i.nhentai.net/galleries/987560/177.jpg",
"https://i.nhentai.net/galleries/987560/178.jpg",
"https://i.nhentai.net/galleries/987560/179.jpg",
"https://i.nhentai.net/galleries/987560/180.jpg",
"https://i.nhentai.net/galleries/987560/181.jpg",
"https://i.nhentai.net/galleries/987560/182.jpg",
"https://i.nhentai.net/galleries/987560/183.jpg",
"https://i.nhentai.net/galleries/987560/184.jpg",
"https://i.nhentai.net/galleries/987560/185.jpg",
"https://i.nhentai.net/galleries/987560/186.jpg",
"https://i.nhentai.net/galleries/987560/187.jpg",
"https://i.nhentai.net/galleries/987560/188.jpg",
"https://i.nhentai.net/galleries/987560/189.jpg",
"https://i.nhentai.net/galleries/987560/190.jpg",
"https://i.nhentai.net/galleries/987560/191.jpg",
"https://i.nhentai.net/galleries/987560/192.jpg",
"https://i.nhentai.net/galleries/987560/193.jpg",
"https://i.nhentai.net/galleries/987560/194.jpg",
"https://i.nhentai.net/galleries/987560/195.jpg",
"https://i.nhentai.net/galleries/987560/196.jpg",
"https://i.nhentai.net/galleries/987560/197.jpg",
"https://i.nhentai.net/galleries/987560/198.jpg",
"https://i.nhentai.net/galleries/987560/199.jpg",
"https://i.nhentai.net/galleries/987560/200.jpg",
"https://i.nhentai.net/galleries/987560/201.jpg",
"https://i.nhentai.net/galleries/987560/202.jpg",
"https://i.nhentai.net/galleries/987560/203.jpg",
"https://i.nhentai.net/galleries/987560/204.jpg",
"https://i.nhentai.net/galleries/987560/205.jpg",
"https://i.nhentai.net/galleries/987560/206.jpg",
"https://i.nhentai.net/galleries/987560/207.jpg",
"https://i.nhentai.net/galleries/987560/208.jpg",
"https://i.nhentai.net/galleries/987560/209.jpg",
"https://i.nhentai.net/galleries/987560/210.jpg",
"https://i.nhentai.net/galleries/987560/211.jpg",
"https://i.nhentai.net/galleries/987560/212.jpg",
"https://i.nhentai.net/galleries/987560/213.jpg",
"https://i.nhentai.net/galleries/987560/214.jpg",
"https://i.nhentai.net/galleries/987560/215.jpg",
"https://i.nhentai.net/galleries/987560/216.jpg",
"https://i.nhentai.net/galleries/987560/217.jpg",
"https://i.nhentai.net/galleries/987560/218.jpg",
"https://i.nhentai.net/galleries/987560/219.jpg",
"https://i.nhentai.net/galleries/987560/220.jpg",
"https://i.nhentai.net/galleries/987560/221.jpg",
"https://i.nhentai.net/galleries/987560/222.jpg",
"https://i.nhentai.net/galleries/987560/223.jpg",
"https://i.nhentai.net/galleries/987560/224.jpg",
"https://i.nhentai.net/galleries/987560/225.jpg"
],
"language": "english",
"num_favorites": 97746,
"num_pages": 225,
"optional_title": {
"english": "[ShindoLA] METAMORPHOSIS (Complete) [English]",
"japanese": "",
"pretty": "METAMORPHOSIS"
},
"parodies": null,
"tags": [
"shindol",
"piercing",
"pregnant",
"mmf threesome",
"vomit",
"group",
"story arc",
"schoolgirl uniform",
"snuff",
"english",
"prostitution",
"nakadashi",
"moral degeneration",
"ahegao",
"anal",
"translated",
"dark skin",
"x-ray",
"full body tattoo",
"drugs",
"incest",
"double penetration",
"stockings",
"gyaru",
"mind break",
"blackmail",
"impregnation",
"blowjob",
"deepthroat",
"manga",
"already uploaded"
],
"title": "METAMORPHOSIS",
"total": 225,
"upload_date": "October 18, 2016 (6 years ago)"
},
"source": "https://nhentai.net/g/177013"
}
```

Otherwise `search` will return 25 **List Object** of search results.
```js
{
"data": [
{
"cover": "https://i.nhentai.net/galleries/2244825/1.jpg",
"id": 406651,
"language": "english",
"tags": [
"oni",
"big breasts",
"big ass",
"cheating",
"english",
"anal",
"shemale",
"translated",
"yaoi",
"muscle",
"doujinshi",
"dickgirl on male",
"male on dickgirl",
"focus anal",
"huuten",
"anal intercourse"
],
"title": {
"english": "[huuten (Huuten)] ♂×♂ - Demon Shemale Wife (English)",
"japanese": "[huuten (瘋)] ♂×♂ - 鬼シーメール人妻",
"pretty": "♂×♂ - Demon Shemale Wife"
},
"total": 23,
"upload_date": "June 12, 2022 (1 day ago)"
},
{
"cover": "https://i.nhentai.net/galleries/1893566/1.jpg",
"id": 356040,
"language": "english",
"tags": [
"ttf threesome",
"futanari",
"unusual teeth",
"sweating",
"big breasts",
"unusual pupils",
"cunnilingus",
"group",
"english",
"ahegao",
"anal",
"hairy",
"translated",
"thigh high boots",
"multi-work series",
"double penetration",
"tall girl",
"blowjob",
"stomach deformation",
"doujinshi",
"dickgirl on dickgirl",
"original",
"huuten"
],
"title": {
"english": "[huuten (Huuten)] Defeated by Futanarification Medication (Latter Part)| Drugged to Futanaridom Part 2 [English]",
"japanese": "[huuten (瘋)] 薬を打たれふたなり化(後編)[英訳]",
"pretty": "Defeated by Futanarification Medication| Drugged to Futanaridom Part 2"
},
"total": 43,
"upload_date": "April 21, 2021 (1 year ago)"
}
],
"page": 1,
"sort": "popular-today",
"source": "https://nhentai.net/api/galleries/search?query=futa&sort=popular-today&page=1"
}
```

## Known Issues
#### `UnicodeEncodeError: 'charmap' codec can't encode characters`
- It's raised when the title contains non-ascii characters, then your console can't parse them, use real console don't Git-bash.

## Pronunciation
[`id_ID`](https://www.localeplanet.com/java/id-ID/index.html) • **/jan·da/** — Dewasa dan mengikat; (?)

## Legal
This tool can be freely copied, modified, altered, distributed without any attribution whatsoever. However, if you feel
like this tool deserves an attribution, mention it. It won't hurt anybody.
> Licence: WTF.