Modules¶

Comic_Geeks¶

class comicgeeks.Comic_Geeks(ci_session: str | None = None)[source]¶

Bases: object

League of Comic Geeks client

ci_session¶

Cookie ci_session of League of Comic Geeks

Type:: str

character_info(character_id: int) → Character[source]¶

Get character info by id

Parameters:: character_id (int) – character id
Returns:: Character object
Return type:: Character

creator_info(creator_id: int) → Creator[source]¶

Get creator info by id

Parameters:: creator_id (int) – creator id
Returns:: Creator object
Return type:: Creator

issue_info(issue_id: int) → Issue | Trade_Paperback[source]¶

Get issue info by id

Parameters:: issue_id (int) – issue id
Returns:: Issue object
Return type:: Issue | Trade_Paperback

login(username: str, password: str) → bool[source]¶

Login to League of Comic Geeks

Parameters:

username (str) – Username
password (str) – Password

Returns:

ci_session cookie

Return type:

str

new_releases(date: datetime = 'now') → list[comicgeeks.classes.Issue][source]¶

Get this week new releases

Parameters:: date (datetime) – Date to get new releases
Returns:: List of issues
Return type:: list (Issue)

search_creator(query: str) → list[comicgeeks.classes.Creator][source]¶

Search series by name

Parameters:: query (str) – Series name
Returns:: List of series
Return type:: list (Series)

search_series(query: str) → list[comicgeeks.classes.Series][source]¶

Search series by name

Parameters:: query (str) – Series name
Returns:: List of series
Return type:: list (Series)

series_info(series_id: int) → Series[source]¶

Get series info by id

Parameters:: series_id (int) – series id
Returns:: Series class
Return type:: Series

Issue¶

class comicgeeks.classes.Issue(issue_id: int, session: Session)[source]¶

Bases: object

ComicGeeks Issue class

add_to_collection() → dict[source]¶

Add issue to collection

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

add_to_wishlist() → dict[source]¶

Add series to wishlist

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

property characters: list¶: List of characters that appear in this issue

property community: dict¶

Dictionary with community data

Parameters:

pull (int|str) – Number of pulls or “Unknown” if the issue was already released,
collect (int) – Number of users who have it,
readlist (int) – Number of user who read it,
wishlist (int) – Number of user who have it in their wishlist,
rating (int) – Rating

property cover: dict¶: Issue cover

property description: str¶: Issue description

property details: dict¶

Issue details

Parameters:

format (str) – Issue format,
page_count (str) – Number of pages,
upc (str?) – UPC code,
distributor_sku (str?) – SKU code,

property issue_id: int¶: Issue id

json() → dict[source]¶: Return data in json format

mark_read() → dict[source]¶

Mark issue as read

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

property name: str¶: Issue name

property number: str¶: Issue number

property person_credits: list¶: List of people that create this issue

property price: float¶: Issue price

property publisher: str¶: Publisher name

pull() → dict[source]¶

Pull issue

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

rate(score: int) → dict[source]¶

Rate issue

Parameters:: score (int) – number from 0 to 5
Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

remove_from_collection() → dict[source]¶

Remove series from collection

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

remove_from_readlist() → dict[source]¶

Mark issue as unread

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

remove_from_wishlist() → dict[source]¶

Remove series from wishlist

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

property series_pagination: dict¶

Issue pagination

Parameters:

prev (Issue) – previous issue
series (Series) – series
next (Issue) – next issue

property store_date: int¶: Issue store date

unsubscribe() → dict[source]¶

Unsubscribe issue

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

property url: str¶: Issue url

property user: dict¶

Dictionary with user data

Parameters:

pull (bool) – Is the issue in the pull list?,
collect (bool) – Is the issue in the collection?,
readlist (bool) – Is the issue in the read list?,
wishlist (bool) – Is the issue in the wishlist?,
rating (int) – User rating from 0 to 5

property variant_covers: list¶: List of variant covers

Trade Paperback¶

class comicgeeks.classes.Trade_Paperback(issue_id: int, session: Session)[source]¶

Bases: Issue

property collects: list[comicgeeks.classes.Issue]¶: List of issues collected in this trade paperback

Series¶

class comicgeeks.classes.Series(series_id: int, session: Session)[source]¶

Bases: object

ComicGeeks Series class

add_missing_to_wishlist() → dict[source]¶

Add missing issues to wishlist

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

add_to_collection() → dict[source]¶

Add series to collection

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

add_to_wishlist() → dict[source]¶

Add series to wishlist

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

property cover: str¶: Series cover url

property description: str¶: Series description

property end_year: int¶: Year when the series ended

property issue_count: int¶: Number of issues

property issues: list[comicgeeks.classes.Issue]¶: List of issues of the series

json() → dict[source]¶: Return data in json format

mark_owned_read() → dict[source]¶

Mark owned issues as read

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

mark_read() → dict[source]¶

Mark series as read

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

property name: str¶: Series name

property publisher: str¶: Publisher name

pull() → dict[source]¶

Pull series

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

pull_hc() → dict[source]¶

Pull only hard cover issues

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

pull_tp() → dict[source]¶

Pull only trade paperback issues

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

remove_from_collection() → dict[source]¶

Remove series from collection

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

remove_from_readlist() → dict[source]¶

Mark series as unread

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

remove_from_wishlist() → dict[source]¶

Remove series from wishlist

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

property series_id: int¶: Series id

property start_year: int¶: Year when the series started

property trade_paperback_count: int¶: Number of trade paperbacks

property trade_paperbacks: list[comicgeeks.classes.Trade_Paperback]¶: List of trade paperbacks of the series

unsubscribe() → dict[source]¶

Unsubscribe series

Returns:: {“text”: “”, “type”: “error|success”}
Return type:: dict

property url: str¶: Series url

property user: dict¶

Dictionary with user data

Parameters:

pull (bool) – Is the series in the pull list?,
owned (str) – Is the issue in the collection?,
read (str) – Is the issue in the read list?

Creator¶

class comicgeeks.classes.Creator(creator_id: int, session: Session)[source]¶

Bases: object

Creator class

property characters: list¶: Credited characters

property creator_id: list¶: Creator id

property description: list¶: Creator description

property image: list¶: Creator image

property issue_count: int¶: Number of issues made by this creator

json() → dict[source]¶: Return data in json format

property name: list¶: Creator name

property owned: int¶: Issues by this creator owned

property read: int¶: Issues by this creator read

property series: list¶: Credited series

property url: list¶: Creator url

Character¶

class comicgeeks.classes.Character(character_id: int, session: Session)[source]¶

Bases: object

Character class

property also_known_as: list¶: Other character personalities

property character_id: str¶: Character id

property creators: list¶: Character creators

property description: str¶: Character description

property image: str¶: Character image

property information: list¶: Information about the character

property issue_count: int¶: Issues with this character

json() → dict[source]¶: Return data in json format

property name: str¶: Character real name

property owned: int¶: Issues with this character owned

property publisher: str¶: Character publisher

property read: int¶: Issues with this character read

property real_name: str¶: Character real name

property series: list¶: Series in which the character appears

property universe: str¶: Character universe

property url: str¶: Character url