python-style

Dùng cho bố cục gói Python, các quy ước setup.py, và phong cách trong contentstack-python.

npx skills add https://github.com/contentstack/contentstack-python --skill python-style

Python style – Contentstack CDA SDK

When to use

  • Editing any Python under contentstack/, setup.py, or requirements.txt.
  • Adding modules or changing how the public package surface is exported.

Instructions

Layout

PathRole
contentstack/stack.pyStack, ContentstackRegion
contentstack/query.py, basequery.pyQuery building
contentstack/entry.py, asset.py, contenttype.pyDomain objects
contentstack/taxonomy.py, globalfields.py, variants.pyAdvanced features
contentstack/https_connection.py, controller.pyHTTP session + request dispatch
contentstack/error_messages.py, utility.pyShared helpers
contentstack/__init__.pyPublic exports (Stack, Entry, Asset, …), __version__

Style

  • Match existing patterns (typing on Stack, unittest-style tests in tests/).
  • Prefer clear public APIs over internal churn; keep module boundaries similar to neighboring files.

Dependencies

  • requests, python-dateutil, urllib3 (Retry) — see setup.py install_requires.
  • Do not add new runtime dependencies without updating setup.py and requirements.txt.

Security

  • Do not log delivery_token, preview_token, api_key, or management_token; follow existing logging in Stack.

Thêm skills từ contentstack

cms-assets
contentstack
Hướng dẫn các nhà phát triển cách tổ chức, phân phối và chuyển đổi tài nguyên trong Contentstack. Bao gồm cấu trúc thư mục, các phép chuyển đổi của Image Delivery API, xuất bản…
cms-branches-aliases
contentstack
Tư vấn cho nhà phát triển về cách sử dụng Contentstack branches để phát triển nội dung độc lập và aliases để triển khai nội dung không gián đoạn. Bao gồm chiến lược branch,…
cms-data-modeling-best-practices
contentstack
Hướng dẫn các nhà phát triển mô hình hóa nội dung trong Contentstack bằng cấu trúc tái sử dụng đơn giản nhất. Kỹ năng này giải thích khi nào nên sử dụng loại nội dung, tham chiếu, toàn cục…
cms-live-preview-visual-builder-support-assistant
contentstack
Chẩn đoán và hướng dẫn triển khai Contentstack Live Preview và Visual Builder. Theo dõi ngữ cảnh xem trước, xác định hợp đồng bị hỏng, và đề xuất…
cms-releases
contentstack
Tư vấn cho nhà phát triển về cách sử dụng Contentstack Releases để triển khai nội dung đồng bộ và nguyên tử. Bao gồm tạo bản phát hành, quản lý mục, triển khai theo giai đoạn,…
cms-roles-permissions
contentstack
Tư vấn cho các nhà phát triển về việc thiết kế vai trò, quyền hạn, nhóm và quyền truy cập token trong Contentstack. Giải thích vai trò tích hợp sẵn, vai trò tùy chỉnh, việc hợp nhất quyền hạn,…
cms-taxonomy
contentstack
Tư vấn cho nhà phát triển về cách sử dụng Contentstack Taxonomy để phân loại nội dung có cấu trúc, phân cấp và lọc phía phân phối. Bao gồm sự khác biệt giữa taxonomy và tags,…
cms-tokens-authentication
contentstack
Tư vấn cho nhà phát triển cách chọn phương thức xác thực Contentstack và loại token phù hợp cho các trường hợp sử dụng frontend, backend, tự động hóa và ứng dụng bên thứ ba.…