Module janda.pururin
Classes
class Pururin (api_key: str = '')
-
Expand source code
class Pururin(object): """Jandapress Pururin API Methods ------- get: function Get doujin from id get_random: function Get random doujin search: function Searches doujin by tags / artist / character / parody or group """ def __init__(self, api_key: str = ""): """Initializes the Pururin. Parameters ---------- api_key : str scathach.id API key (optional) """ if api_key == "": self.api_key = None else: self.api_key = api_key self.specs = {"api_key": self.api_key} async def get(self, book: int) -> str: """Get pururin doujin book from Id example: https://pururin.to/gallery/61119 Parameters ---------- book : int The id number of the doujin Raises ------ ValueError If the doujin is not found. Returns ------- str reparsed json as string """ self.book = str(book) data = await request(Janda.pururin + Janda.endpoint_book, self.book) return better_object(data) async def search(self, query: str, page: int = 1, sort: str = "newest") -> str: """Search pururin by tags / artist / character / parody or group Parameters ---------- query : str query to search for page : int Page number. Default is 1 sort : str newest, most-popular, highest-rated, most-viewed, title, random Raises ------ ValueError If the doujin is not found. Returns ------- str reparsed json as string """ if sort not in [ "newest", "most-popular", "highest-rated", "most-viewed", "title", "random", ]: raise ValueError( "Sort must be one of newest, most-popular, highest-rated, most-viewed, title, random" ) self.query = query self.page = page self.sort = sort self.req = str(self.query + "&page=" + str(self.page) + "&sort=" + self.sort) data = await request(Janda.pururin + Janda.endpoint_search, self.req) return better_object(data) async def get_random(self) -> str: """Get pururin random doujin Returns ------- str reparsed json as string """ data = await request(Janda.pururin + Janda.endpoint_random) return better_object(data)
Jandapress Pururin API
Methods
get: function Get doujin from id
get_random: function Get random doujin
search: function Searches doujin by tags / artist / character / parody or group
Initializes the Pururin.
Parameters
api_key
:str
- scathach.id API key (optional)
Methods
async def get(self, book: int) ‑> str
-
Expand source code
async def get(self, book: int) -> str: """Get pururin doujin book from Id example: https://pururin.to/gallery/61119 Parameters ---------- book : int The id number of the doujin Raises ------ ValueError If the doujin is not found. Returns ------- str reparsed json as string """ self.book = str(book) data = await request(Janda.pururin + Janda.endpoint_book, self.book) return better_object(data)
Get pururin doujin book from Id
example: https://pururin.to/gallery/61119
Parameters
book
:int
- The id number of the doujin
Raises
ValueError
- If the doujin is not found.
Returns
str
- reparsed json as string
async def get_random(self) ‑> str
-
Expand source code
async def get_random(self) -> str: """Get pururin random doujin Returns ------- str reparsed json as string """ data = await request(Janda.pururin + Janda.endpoint_random) return better_object(data)
Get pururin random doujin
Returns
str
- reparsed json as string
async def search(self, query: str, page: int = 1, sort: str = 'newest') ‑> str
-
Expand source code
async def search(self, query: str, page: int = 1, sort: str = "newest") -> str: """Search pururin by tags / artist / character / parody or group Parameters ---------- query : str query to search for page : int Page number. Default is 1 sort : str newest, most-popular, highest-rated, most-viewed, title, random Raises ------ ValueError If the doujin is not found. Returns ------- str reparsed json as string """ if sort not in [ "newest", "most-popular", "highest-rated", "most-viewed", "title", "random", ]: raise ValueError( "Sort must be one of newest, most-popular, highest-rated, most-viewed, title, random" ) self.query = query self.page = page self.sort = sort self.req = str(self.query + "&page=" + str(self.page) + "&sort=" + self.sort) data = await request(Janda.pururin + Janda.endpoint_search, self.req) return better_object(data)
Search pururin by tags / artist / character / parody or group
Parameters
query
:str
- query to search for
page
:int
- Page number. Default is 1
sort
:str
- newest, most-popular, highest-rated, most-viewed, title, random
Raises
ValueError
- If the doujin is not found.
Returns
str
- reparsed json as string