dannykeane

Official Python SDK and CLI for the dannykeane.com public API: Danny Keane's work history, GitHub contribution calendar, live visitor stats, and the Habbo room NPC chat.

Zero dependencies, standard library only. Python 3.9+, fully typed.

pip install dannykeane

Usage

from dannykeane import DannyKeane

dk = DannyKeane()
for role in dk.iter_work():
    print(role["company"], role["years"])

Every endpoint is public, so there is no API key. Pass base_url to point at a local or preview deploy.

Results are the API's own JSON as TypedDicts. The full contract is the OpenAPI document at https://dannykeane.com/openapi.json.

Pagination

list_work returns one page: {"data": [...], "next_cursor": "..."}, with next_cursor set to None on the last page. iter_work follows the cursors for you.

Errors

Every non-2xx response raises ApiError, parsed from the API's ErrorResponse body:

from dannykeane import ApiError, DannyKeane

try:
    DannyKeane().list_work(limit=50)
except ApiError as error:
    print(error.status, error.code, error.message, error.hint)
    # 400 invalid_parameter limit must be an integer from 1 to 20 ...

error.body holds the full parsed body. Network failures raise the standard library's urllib.error.URLError.

Rate limits

On a 429 the client waits out Retry-After and retries, up to max_retries (default 2). A Retry-After longer than max_retry_delay (default 60 seconds) raises immediately instead, with the wait on error.retry_after. Set max_retries=0 to handle every 429 yourself.

CLI

The package installs a dannykeane command. Run it without installing:

pipx run dannykeane work --limit 5

The API's JSON goes to stdout, indented when stdout is a terminal (--pretty forces it). Failures go to stderr as one line of ErrorResponse JSON, with stdout empty. --base-url or DANNYKEANE_BASE_URL points it at another deploy.

Exit codes: 0 success, 1 the API returned an error, 2 usage error, 3 the API could not be reached.

The npm package dannykeane ships the same client and CLI for TypeScript and Node.

Links

• Developer docs: https://dannykeane.com/developers
• OpenAPI spec: https://dannykeane.com/openapi.json
• Contact: me@dannykeane.co.uk

License

MIT