Skip to main content

Staff

Unofficial Python library to work with data on The StoryGraph.

This library relies on interacting with The StoryGraph's website, and is liable to break at any moment! If you want something more stable, consider voting for API support on the roadmap.

Basic usage

Create a JSON file containing your login credentials for The StoryGraph, e.g. .storygraph.json:

{
  "email": "user@example.com",
  "password": "password"
}

Create a client using your credentials file:

from staff import StoryGraph

with StoryGraph(".storygraph.json") as sg:
    latest = next(sg.current_books())
    print(f"I'm reading {latest.title} by {latest.author}")

Your credentials file will be updated with a cookie from the website after your first sign-in.

Metadata

Release files for Staff 0.2.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 Staff 0.2.0
File Size Uploaded Provenance
staff-0.2.0.tar.gz 10.5 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for Staff 0.2.0
File Interpreter ABI Platform
staff-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 22.9 kB

Release files / staff-0.2.0.tar.gz

Download URL staff-0.2.0.tar.gz
Size 10.5 kB
Tags Source
SHA-256 checksum
How to use checksums
3251e29bb9b0f6345b3617fe8b9a4e82a0c304279865cde1cd0038641b5ca442
BLAKE2b-256 checksum
How to use checksums
3a3f9116b0975a7ae48131c2f966d91b6f620a4f93b9de7e9a27fb9c001c5d69
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.11

Release files / staff-0.2.0-py3-none-any.whl

Download URL staff-0.2.0-py3-none-any.whl
Size 12.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b321e0b0813de2bc2a054c938112fd8e224dd6330508c9454751e1a3d9d40481
BLAKE2b-256 checksum
How to use checksums
f50ba49b8d3d3891073803b02ef161a8d5d05d72d933e0ea4ee2412551bcbe5d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.11

Security for Staff 0.2.0

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.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

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