Contentstack CDA SDK – Contentstack Python CDA SDK
When to use
- Implementing or changing
Stack, content-type, query, entry, or asset behavior.
- Working with live preview, taxonomy, global fields, variants, or image transforms.
- Assessing CDA API alignment or extending the public SDK surface.
Instructions
Stack entry
Stack in contentstack/stack.py: validates api_key, delivery_token, environment; resolves region → host via ContentstackRegion; builds endpoint; wires HTTPSConnection with headers, timeout, urllib3.Retry, and optional live_preview / branch / early_access.
Features
- Content types & entries —
contenttype.py, entry.py, entryqueryable.py.
- Queries —
basequery.py, query.py; chain methods align with CDA query parameters.
- Assets —
asset.py, assetquery.py.
- Taxonomy, global fields, variants, image transform —
taxonomy.py, globalfields.py, variants.py, image_transform.py.
- Sync —
Stack.sync_init, pagination, sync_token → /stacks/sync via __sync_request.
Live preview
live_preview dict (enable, host, authorization, etc.) merged in deep_merge_lp.py / stack setup; keep behavior aligned with tests/test_live_preview.py.
HTTP layer
https_connection.py — requests.Session, HTTPAdapter, get_request from controller.py; user-agent uses contentstack.__title__ / __version__.
Extending
- Add query or stack methods consistent with CDA query parameters.
- Keep transport logic in
HTTPSConnection / controller rather than duplicating requests setup.
Dependencies
requests, urllib3 (Retry), python-dateutil
