用途:contentstack-utils 是 contentstack-python 中 Contentstack CDA SDK 的使用说明,适用于实现或修改 Stack、内容类型、查询、条目、资源行为,以及处理实时预览、分类法、全局字段、变体、图片转换,或评估 CDA API 对齐与扩展公开 SDK 接口。
主要能力:Stack 入口位于 contentstack/stack.py,校验 api_key、delivery_token、environment,通过 ContentstackRegion 将 region 解析为 host,构建 endpoint,并用 headers、timeout、urllib3.Retry 及可选 live_preview、branch、early_access 装配 HTTPSConnection。功能覆盖内容类型与条目(contenttype.py、entry.py、entryqueryable.py)、查询(basequery.py、query.py,链式方法与 CDA 查询参数对齐)、资源(asset.py、assetquery.py)、分类法、全局字段、变体、图片转换(taxonomy.py、globalfields.py、variants.py、image_transform.py),以及同步(Stack.sync_init、分页、sync_token,经 __sync_request 访问 /stacks/sync)。
使用方式:实时预览通过 live_preview 字典(enable、host、authorization 等)在 deep_merge_lp.py 或 Stack 初始化中合并,行为需与 tests/test_live_preview.py 保持一致。HTTP 层由 https_connection.py 提供 requests.Session、HTTPAdapter,get_request 来自 controller.py,user-agent 使用 contentstack.title / version。扩展时应按 CDA 查询参数新增查询或 Stack 方法,并将传输逻辑保留在 HTTPSConnection / controller,避免重复搭建 requests。依赖 requests、urllib3(Retry)、python-dateutil。
限制:资料未提供具体安装命令、版本要求、收费与平台信息,暂未提供。