quantjourney-common-sdk

Shared Python mechanics for QJ SDKs.

This package owns only transport-level concerns: auth/token exchange, HTTP request handling, response envelopes, pagination helpers, bounded retry, and small typed models. Domain clients live in SDK-specific packages such as qj.data and qj.api.

Canonical package metadata:

quantjourney-common-sdk must not ship qj/__init__.py. It is designed to co-install with quantjourney-data and quantjourney-api.

Install from PyPI:

pip install quantjourney-common-sdk==0.1.1

No private Python package registry is required. Consumers should pin a compatible release range in application dependencies.

Auth model:

• QJ_*_TOKEN is sent as a Bearer token directly.
• QJ_*_API_KEY=QJ_live_* is exchanged through qj-auth /auth/token.
• QJ_*_CLIENT_ID + QJ_*_CLIENT_SECRET=QJ_svc_* use client_credentials.
• exchanged JWTs are cached in memory until shortly before exp.

Transport model:

• idempotent reads retry 429/502/503/504 with bounded backoff;
• each request gets X-QJ-Request-ID;
• response envelopes are parsed into QJResponse.