SKILL.md
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
Stackincontentstack/stack.py: validatesapikey,deliverytoken,environment; resolvesregion → hostviaContentstackRegion; buildsendpoint; wiresHTTPSConnectionwithheaders,timeout,urllib3.Retry, and optionallivepreview/branch/earlyaccess.
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.syncinit,pagination,synctoken→/stacks/syncvia__sync_request.
Live preview
livepreviewdict (enable,host,authorization, etc.) merged indeepmergelp.py/ stack setup; keep behavior aligned withtests/testlive_preview.py.
HTTP layer
httpsconnection.py—requests.Session,HTTPAdapter,getrequestfromcontroller.py; user-agent usescontentstack.title/version.
Extending
- Add query or stack methods consistent with CDA query parameters.
- Keep transport logic in
HTTPSConnection/controllerrather than duplicatingrequestssetup.
Dependencies
requests,urllib3(Retry),python-dateutil