Grayven 0.6.0

A Python wrapper for the Grand Comics Database API.

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="[e-mail]",
    password="Password",
    cache_path=Path("cache.sqlite"),  # Optional, defaults to ~/.cache/grayven/cache.sqlite
    cache_expiry=timedelta(days=1),  # Optional, defaults to 14 days
    ratelimit_path=Path(
        "ratelimits.sqlite"
    ),  # Optional, defaults to ~/.cache/grayven/ratelimits.sqlite
)

# 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 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