python-style

作者: contentstack

用於 contentstack_management/ 下的套件佈局、setup.py、pylint 友善風格以及匯入。

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

Python style and repo layout – Contentstack Management Python

When to use

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

Instructions

Layout

  • contentstack_management/contentstack.pyClient, Region, user_agents, OAuth wiring.
  • contentstack_management/_api_client.py_APIClient (HTTP, retries).
  • contentstack_management/stack/ — stack-scoped API surface.
  • Domain modulesentries/, assets/, webhooks/, oauth/, etc.

Style

  • Match existing modules: naming, docstrings, and patterns already used in the same directory.
  • Prefer small, focused changes; keep __init__.py exports consistent with public API intent (README, contentstack_management.__all__).

Imports

  • Use requests (and requests-toolbelt where already used) through _APIClient patterns rather than ad-hoc clients in domain modules unless justified.

Security

  • Do not log authtokens, management tokens, passwords, or API keys; preserve existing header handling in Client.

來自 contentstack 的更多技能

brand-kit-assistant
contentstack
就 Contentstack Brand Kit 的概念、設定、治理與品牌一致性 AI 生成提供使用者建議。將 API 特定任務導向正確的 Brand Kit 功能或…
official
cms-assets
contentstack
為開發人員提供有關在Contentstack中組織、交付和轉換資產的建議。涵蓋資料夾結構、Image Delivery API轉換、發佈……
official
cms-branches-aliases
contentstack
Advise developers on using Contentstack branches for isolated content development and aliases for zero-downtime content deployments. Cover branch strategy,…
official
cms-data-modeling-best-practices
contentstack
Guide developers to model content in Contentstack using the simplest reusable structure. The skill explains when to use content types, references, global…
official
cms-entries
contentstack
Advise developers on querying, localizing, versioning, publishing, and structuring Contentstack entries for efficient delivery. Focus on CDA usage, reference…
official
cms-environments-publishing
contentstack
為開發人員提供關於配置環境、發佈內容、使用傳遞與預覽令牌、運用 Sync API,以及了解 CDN 和…的建議。
official
cms-live-preview-visual-builder-support-assistant
contentstack
Diagnose and guide Contentstack Live Preview and Visual Builder implementations. Trace preview context, identify the broken contract, and recommend the…
official
cms-localization
contentstack
為開發人員提供Contentstack本地化建議:語言設定、備援鏈、本地化與非本地化條目、不可本地化欄位,以及多語言環境…
official