Skip to content

Seagrin

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

prek Ruff ty

status-badge Read the Docs

A Python wrapper for the Metron API.

Installation

Bash
pip install seagrin

Example Usage

Python
from datetime import timedelta
from pathlib import Path

from seagrin.metron import Metron

session = Metron(
    username="Username",
    password="Password",
    cache=Path("cache.sqlite"),  # Optional, defaults to ~/.cache/seagrin/cache.sqlite
    cache_expiry=timedelta(days=1),  # Optional, defaults to 14 days
)

# Get all Marvel comics for the week of 2026-01-19
this_week = session.list_issues(
    params={
        "store_date_range_after": "2026-01-19",
        "store_date_range_before": "2026-01-26",
        "publisher_name": "marvel",
    }
)

# Print the results
for iss in this_week:
    print(f"{iss.id} {iss.issue_name}")

# Retrieve the detail for an individual issue
asm_68 = session.issue(issue_id=31660)

# Print the issue Description
print(asm_68.desc)

Documentation

Bugs/Requests

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