Module janda.pururin
Expand source code
from janda.utils.client import *
from janda.utils.request import request
Janda = Api()
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)Classes
class Pururin (api_key: str = '')-
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)
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)Methods
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
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) async def get_random(self) ‑> str-
Get pururin random doujin
Returns
str- reparsed json as string
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) 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
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)