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

Release files for Grayven 0.6.1

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.6.1
File Size Uploaded
grayven-0.6.1.tar.gz 358.7 kB Details

Built distribution (wheel)

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

Total release size: 369.9 kB

Release files / grayven-0.6.1.tar.gz

Download URL grayven-0.6.1.tar.gz
Size 358.7 kB
Tags Source
SHA-256 checksum
How to use checksums
f77ee7c84abb520f6adb28210a81ef364ab421213e953acc0adc64d9ecfaaf0c
BLAKE2b-256 checksum
How to use checksums
2fcc3a9930810628fa2759cfaf999e974016193241addb8944b2a887ae6a3cfb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","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.6.1-py3-none-any.whl

Download URL grayven-0.6.1-py3-none-any.whl
Size 11.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9b4c0f60363f9c6e1a06749b286c6c079679e5845f4043cc2f5cc4002d3bee38
BLAKE2b-256 checksum
How to use checksums
31be78cca96190f6cbf64fe6ad0eca4ed44e50f26db37c45ce819222f684b517
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","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.6.1 This release

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