This release is a pre-release and may not be stable for production use.
comics
GoComics API wrapper
Installation
pip install comics
Quick start
Find and download the Calvin and Hobbes comic strip published on January 2, 1990:
import comics
ch = comics.search("calvinandhobbes", date="1990-01-02")
ch.download("calvinandhobbes.png")
Find comics
Available comics can be found using the directory class:
import comics
# List available comics - total of 401
comics.directory.listall()
# >>> ("1-and-done", "9-chickweed-lane-classics", "9chickweedlane", "9to5", ... )
# Find endpoints for Calvin and Hobbes
comics.directory.search("Calvin and Hobbes")
# >>> ("calvinandhobbes", "calvinandhobbesenespanol")
First, pass the desired endpoint to comics.search. For example, to search for Calvin and Hobbes comics in english use comics.search("calvinandhobbes"); for spanish, use comics.search("calvinandhobbesenespanol").
Search and download comics
Then, search for a comic strip by passing date into search():
import comics
# Get a Calvin and Hobbes comic strip by date
ch = comics.search("calvinandhobbes", date="2013-05-13") # Also accepts datetime.date or datetime object
# Get a random Calvin and Hobbes comic strip
random_ch = comics.search("calvinandhobbes", date="random")
Finally, show, download, or stream the comic strip:
# Show comic strip - opens in Jupyter notebook or default image viewer application
ch.show()
# Download comic strip - defaults to {endpoint}.png if an export path is not provided
# E.g., a Calvin and Hobbes comic strip will be exported as "calvinandhobbes.png" in the current working directory
ch.download()
# Stream comic strip - useful if custom image content manipulation is desired
ch.stream()
Retry logic
If a comic strip fails to load due to CDN delays or missing image data, a retry mechanism is built into download(), show(), and stream(). You can control this behavior via:
retries: number of attempts before failing (default = 5)base_delay: exponential backoff seed time in seconds (default = 0.5)
This improves reliability when fetching newly released strips or handling transient issues.
| Attempt | Wait Before Attempt (sec) | Cumulative Time (sec) |
|---|---|---|
| 1 | 0.0 | 0.0 |
| 2 | 0.5 | 0.5 |
| 3 | 1.0 | 1.5 |
| 4 | 2.0 | 3.5 |
| 5 | 4.0 | 7.5 |
| 6 | 8.0 | 15.5 |
Retry behavior can be customized per call:
# Try 3 times total with shorter delay
ch.download(retries=2, base_delay=0.25)
Attributes
An instantiated search class will have the following public attributes:
import comics
garfield = comics.search("garfield")
garfield.endpoint
# >>> "garfield"
garfield.title
# >>> "Garfield"
garfield.start_date
# >>> "1978-06-19"
An instantiated search class with date will have the following public attributes:
import comics
garfield = comics.search("garfield", date="2000-08-20")
garfield.endpoint
# >>> "garfield"
garfield.title
# >>> "Garfield"
garfield.date
# >>> "2000-08-20"
garfield.url
# >>> "https://www.gocomics.com/garfield/2000/08/20"
garfield.image_url
# >>> "https://assets.amuniversal.com/6694c52099bd01365606005056a9545d"
Exceptions
An exception will be thrown if the queried date is unregistered or before the comic's origin date:
import comics
try:
peanuts = comics.search("peanuts", date="1900-01-01")
peanuts.download()
except comics.exceptions.InvalidDateError:
print("Whoops, an invalid date was queried.")
An exception will be thrown if the queried endpoint is unregistered:
import comics
try:
invalid_comic = comics.search("invalid_endpoint", date="2000-01-01")
invalid_comic.download()
except comics.exceptions.InvalidEndpointError:
print("Whoops, an invalid endpoint was queried.")
An exception will be thrown if GoComics' CDN rejects the request (HTTP 403, HTTP 429 rate limiting, or an anti-bot challenge that never resolves). This is not retried, since it depends on your client and network rather than the date:
import comics
try:
garfield = comics.search("garfield", date="2020-05-05")
garfield.download()
except comics.exceptions.ComicsBlockedError:
print("GoComics rejected this request. Wait a while or try a different network.")
An exception will be thrown if Playwright fails to fetch a comic (e.g., browser not installed or page error):
import comics
try:
garfield = comics.search("garfield", date="2020-05-05", force_playwright=True)
garfield.download()
except comics.exceptions.ComicsPlaywrightError:
print("Playwright failed to fetch the page. Check your Playwright installation.")
Contribute
Support
If you are having issues or would like to propose a new feature, please use the issues tracker.
License
This project is licensed under the MIT license.
1 maintainer
Metadata
1 maintainer
Release files for comics 0.10.0a1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| comics-0.10.0a1.tar.gz | 28.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| comics-0.10.0a1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 50.1 kB
Release files / comics-0.10.0a1.tar.gz
| Download URL | comics-0.10.0a1.tar.gz |
|---|---|
| Size | 28.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6afee776bf38108c133abaa61ccaa5458936f6f850258c704b6a0b8700e0b633
|
|
BLAKE2b-256 checksum How to use checksums |
5715366dfa62974fdfeff75dbc05bd0e8d700b1a5a0bc80a126ec9c96367ea45
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.13
|
Release files / comics-0.10.0a1-py3-none-any.whl
| Download URL | comics-0.10.0a1-py3-none-any.whl |
|---|---|
| Size | 21.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cea6749dda085168dab932e1912998d7518fc0a01d1f255a054fbe5a1f292407
|
|
BLAKE2b-256 checksum How to use checksums |
d9a33f1bd687fe8a37bec202aec80f6ed6ea099aa39a2d884554af39370f4303
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.13
|
Security for comics 0.10.0a1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
