https://github.com/metron-project/esak
Python wrapper for the Marvel API.
https://github.com/metron-project/esak
api-wrapper comics marvel metadata
Last synced: 3 months ago
JSON representation
Python wrapper for the Marvel API.
- Host: GitHub
- URL: https://github.com/metron-project/esak
- Owner: Metron-Project
- License: mit
- Created: 2021-05-16T12:36:47.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-01-27T17:44:47.000Z (9 months ago)
- Last Synced: 2025-04-15T22:15:42.389Z (6 months ago)
- Topics: api-wrapper, comics, marvel, metadata
- Language: Python
- Homepage:
- Size: 1.34 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# esak - Python wrapper for Marvel API
[](https://pypi.python.org/pypi/esak/)
[](https://pypi.python.org/pypi/esak/)
[](https://opensource.org/licenses/GPL-3.0)
[](https://github.com/pre-commit/pre-commit)
[](https://github.com/astral-sh/ruff)
[](https://github.com/Metron-Project/esak/graphs/contributors)
[](https://github.com/Metron-Project/esak/actions/workflows/testing.yml)
[](https://codecov.io/gh/Metron-Project/esak)
[](https://esak.readthedocs.io/en/stable)
This project is a fork of [marvelous](https://github.com/rkuykendall/marvelous) with the goal of supporting the full Marvel API.
## Installation
```console
pip install --user esak
```
## Example Usage
```python
import esak
# Your own config file to keep your private key local and secret
from config import public_key, private_key
# Authenticate with Marvel, with keys I got from http://developer.marvel.com/
m = esak.api(public_key, private_key)
# Get all comics from this week, sorted alphabetically by title
pulls = sorted(m.comics_list({
'format': "comic",
'formatType': "comic",
'noVariants': True,
'dateDescriptor': "thisWeek",
'limit': 100}),
key=lambda comic: comic.title)
for comic in pulls:
# Write a line to the file with the name of the issue, and the id of the series
print(f'{comic.title} (series #{comic.series.id})')
```
## Documentation
- [esak](https://esak.readthedocs.io/en/stable)
- [Marvel API](https://developer.marvel.com/docs)
## Bugs/Requests
Please use the [GitHub issue tracker](https://github.com/Metron-Project/esak/issues) to submit bugs or request features.
## Contributing
- When running a new test for the first time, set the environment variables `PUBLIC_KEY` and `PRIVATE_KEY` to your Marvel API keys.
The responses will be cached in the `tests/testing_mock.sqlite` database without your keys.
## Socials
[](https://matrix.to/#/#metron-general:matrix.org)
[](https://matrix.to/#/#metron-development:matrix.org)