framework

Use for _APIClient, requests usage, retries, timeout, and OAuth interceptor in contentstack-management-python.

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

Framework / HTTP – Contentstack Management Python

When to use

  • Editing contentstack_management/_api_client.py or OAuth interceptor/handler wiring.
  • Changing retry policy, timeouts, or how requests is invoked.

Instructions

Integration point

  • _APIClient uses requests in _call_request, honors timeout and max_retries, and delegates to oauth_interceptor when configured.

When to change

  • Retry or transport behavior — keep logic centralized in _APIClient unless a resource truly needs a documented exception.
  • Auth headers — prefer extending Client / user_agents patterns rather than scattering header merges.

Testing

  • Unit — mock requests or _APIClient at the boundary used by existing tests.
  • API — full stack via credentials from tests/cred.py.

More skills from contentstack

cms-assets
contentstack
Advise developers on organizing, delivering, and transforming assets in Contentstack. Cover folder structure, Image Delivery API transformations, publishing…
cms-branches-aliases
contentstack
Advise developers on using Contentstack branches for isolated content development and aliases for zero-downtime content deployments. Cover branch strategy,…
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…
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…
cms-releases
contentstack
Advise developers on using Contentstack Releases for coordinated, atomic content deployment. Cover release creation, item management, staged deployment,…
cms-roles-permissions
contentstack
Advise developers on designing roles, permissions, teams, and token access in Contentstack. Explain built-in roles, custom roles, permission merging,…
cms-taxonomy
contentstack
Advise developers on using Contentstack Taxonomy for structured, hierarchical content classification and delivery-side filtering. Covers taxonomy vs tags,…
cms-tokens-authentication
contentstack
Advise developers on choosing the right Contentstack authentication method and token type for frontend, backend, automation, and third-party app use cases.…