stigg-sidecar-sdk

What it is and what it does

stigg-sidecar-sdk is a Python client for the Stigg Sidecar, a service that manages customer entitlements and controls access to metered features. It wraps communication with a separately deployed sidecar instance, allowing you to query whether a customer has access to a feature, request metered entitlements with usage counts, and provision customers through the underlying API.

The SDK is async-first and depends on betterproto for protocol buffer support and stigg-api-client-v2 for the underlying API client. It requires Python 3.9 or later and is actively maintained. The main workflow is to initialize a Stigg client with an API key and sidecar host/port, then call methods like get_metered_entitlement() to check access or use the .api property to perform administrative operations.

Use it for:

• Check whether a customer has access to a metered feature before allowing them to use it.
• Query entitlements with requested usage counts to enforce usage-based billing or rate limits.
• Provision new customers and manage their entitlements programmatically.
• Integrate feature gating into a SaaS application backed by Stigg's subscription management.
• Build access-control logic that respects customer subscription tiers and feature quotas.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python SDK for interacting with Stigg Sidecar, a service for managing customer entitlements and feature access control.

Yes, if you are already using Stigg for subscription management and need a Python client for the Sidecar. Low install friction and active maintenance are positive signals. However, verify the license terms before committing—the metadata shows 'unclear' status with no published license text. Confirm that deploying and maintaining a separate sidecar instance fits your architecture.

Install

stigg-sidecar-sdk on PyPI

pip install stigg-sidecar-sdk

uv add stigg-sidecar-sdk

poetry add stigg-sidecar-sdk

Installing stigg-sidecar-sdk

Before you install

Low install friction with a pure Python wheel. Actively maintained as of 2 days ago. Depends on betterproto and stigg-api-client-v2, both of which should resolve cleanly.

License in practice

License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before using in proprietary or restricted contexts.

Quickstart

pip install stigg-sidecar-sdk

import os
from stigg_sidecar_sdk import Stigg, ApiConfig

api_key = os.environ.get("STIGG_SERVER_API_KEY")
stigg = Stigg(
    ApiConfig(api_key=api_key),
    remote_sidecar_host='localhost',
    remote_sidecar_port=80
)

Requires a running Stigg Sidecar instance (typically deployed as a Docker container) accessible at the specified host and port.

Verify before relying

• Actual license terms—metadata shows 'unclear' treatment with no SPDX or raw license text available.
• Whether the sidecar must be deployed separately or if it can be embedded; documentation link is not accessible in the fact sheet.
• Stability and API surface of stigg-api-client-v2 dependency.

Package facts

Evidence: stigg_sidecar_sdk-8.0.0-py3-none-any.whl

Tags

More WWW/HTTP packages