用途:在 contentstack-python(Contentstack CDA SDK)中编辑任何 Python 代码时使用,包括 contentstack/ 目录、setup.py、requirements.txt,以及新增模块或调整公共包导出接口。
主要能力:说明包目录结构与各文件职责。contentstack/stack.py 承载 Stack 与 ContentstackRegion;query.py、basequery.py 负责查询构建;entry.py、asset.py、contenttype.py 为领域对象;taxonomy.py、globalfields.py、variants.py 为高级功能;https_connection.py、controller.py 负责 HTTP 会话与请求分发;error_messages.py、utility.py 为共享辅助;init.py 定义公共导出(Stack、Entry、Asset 等)与 version。
风格约定:沿用既有模式,例如 Stack 上的类型标注、tests/ 下 unittest 风格测试;优先保持清晰的公共 API,减少内部改动,模块边界与相邻文件保持一致。
依赖:requests、python-dateutil、urllib3(Retry),见 setup.py 的 install_requires。如需新增运行时依赖,必须同步更新 setup.py 与 requirements.txt。
限制与安全:不得记录 delivery_token、preview_token、api_key 或 management_token,日志行为需与 Stack 中现有实现保持一致。资料未提供具体版本要求、测试运行命令或完整代码示例。