Grayven

A Python wrapper for the Grand Comics Database API.

Installation

pip install Grayven

Example Usage

from datetime import timedelta
from pathlib import Path

from grayven.grand_comics_database import GrandComicsDatabase

session = GrandComicsDatabase(
    email="email@example.com",
    password="Password",
    cache=Path("cache.sqlite"),  # Optional, defaults to ~/.cache/grayven/cache.sqlite
    cache_expiry=timedelta(days=1),  # Optional, defaults to 14 days
)

# Search for Series
results = session.list_series(name="Green Lantern")
for series in results:
    print(f"{series.id} | {series.name} ({series.year_began})")

# Get an issue's release date
result = session.get_issue(id=242700)
print(result.on_sale_date)

Documentation

• Grayven
• GrandComicsDatabase API

Bugs/Requests

Please use the GitHub issue tracker to submit bugs or request features.

Contributing

• When running a new test for the first time, set the environment variables GCD_EMAIL to your GCD email address and GCD_PASSWORD to your GCD password. The responses will be cached in the tests/cache.sqlite database without your credentials.

Socials