python-style

Use for Python package layout, setup.py conventions, and style in 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.

Más skills de contentstack

brand-kit-assistant
contentstack
Advise users on Contentstack Brand Kit concepts, setup, governance, and on-brand AI generation. Route API-specific tasks to the right Brand Kit capability or…
official
cms-assets
contentstack
Asesorar a los desarrolladores sobre cómo organizar, entregar y transformar activos en Contentstack. Cubrir la estructura de carpetas, las transformaciones de la API de entrega de imágenes, la publicación…
official
cms-branches-aliases
contentstack
Asesorar a desarrolladores sobre el uso de ramas de Contentstack para desarrollo de contenido aislado y alias para implementaciones de contenido sin tiempo de inactividad. Cubrir estrategia de ramas, …
official
cms-data-modeling-best-practices
contentstack
Guía a los desarrolladores para modelar contenido en Contentstack usando la estructura reutilizable más simple. La habilidad explica cuándo usar tipos de contenido, referencias, 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
Asesorar a los desarrolladores sobre la configuración de entornos, la publicación de contenido, el uso de tokens de entrega y vista previa, el aprovechamiento de la Sync API y la comprensión de CDN y…
official
cms-live-preview-visual-builder-support-assistant
contentstack
Diagnostica y guía implementaciones de Contentstack Live Preview y Visual Builder. Rastrea el contexto de vista previa, identifica el contrato roto y recomienda la…
official
cms-localization
contentstack
Advise developers on Contentstack localization: language setup, fallback chains, localized vs unlocalized entries, non-localizable fields, and multi-locale…
official