Skip to main content

Grayven

PyPI - Python PyPI - Status PyPI - Version PyPI - License

prek Ruff ty

status-badge Read the Docs

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

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

Social - Matrix Social - Matrix

Metadata

Release files for Grayven 0.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Grayven 0.7.0
File Size Uploaded
grayven-0.7.0.tar.gz 344.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for Grayven 0.7.0
File Interpreter ABI Platform
grayven-0.7.0-py3-none-any.whl Python 3 none any Details

Total release size: 355.7 kB

Release files / grayven-0.7.0.tar.gz

Download URL grayven-0.7.0.tar.gz
Size 344.5 kB
Tags Source
SHA-256 checksum
How to use checksums
51f679dda559db22e7496ad46d74c13320eae9d0452f0d43826e165a075d0ae4
BLAKE2b-256 checksum
How to use checksums
6acfc68670fa6fa0a91f27b054a389c04561ea32daae547e127e9f5815c965cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / grayven-0.7.0-py3-none-any.whl

Download URL grayven-0.7.0-py3-none-any.whl
Size 11.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b8ed49a73cd5485fec07c7bf0169af1c864d389b696f6e7b704345bb24ad7603
BLAKE2b-256 checksum
How to use checksums
d3beb143ba30a180b2e6a7c6eb71150c8c3f5f01ad48787b20b5640ae48bf3ed
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.7.0 This release

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page