licensekit-sdk 0.1.0a0

Python SDK for licensekit.dev

licensekit-sdk

Public Python SDK source for licensekit.dev.

This repository is the standalone home of the PyPI package licensekit-sdk. It contains the published client source, examples, tests, and the OpenAPI snapshot used to generate the typed client surface.

Links:

• product site: https://licensekit.dev
• hosted API: https://api.licensekit.dev
• TypeScript SDK: https://www.npmjs.com/package/@licensekit/sdk

Install

pip install licensekit-sdk

Quick Start

from licensekit import (
    ManagementClient,
    PublicKeyStore,
    RuntimeClient,
    SystemClient,
    verify_runtime_result,
)

base_url = "https://api.licensekit.dev"

system = SystemClient(base_url=base_url)
health = system.health()
print(health["data"]["status"])

management = ManagementClient(
    base_url=base_url,
    token="lkm_..."
)

product = management.create_product(
    body={
        "name": "Example App",
        "code": "example-app",
    }
)

runtime = RuntimeClient(
    base_url=base_url,
    license_key="lsk_..."
)

result = runtime.validate_license(
    body={
        "fingerprint": "host-123",
    }
)

public_keys = system.list_public_keys()
verified = verify_runtime_result(
    result,
    PublicKeyStore(public_keys["data"]),
)

print(product["data"]["id"], verified.ok)

Package Shape

• ManagementClient Uses Authorization: Bearer <token> for /api/v1/... management operations.
• RuntimeClient Uses Authorization: License <license-key> for /api/v1/license/... runtime operations.
• SystemClient Unauthenticated access to /health, /healthz, /readyz, /metrics, and /api/v1/system/public-keys.

Hosted deployments should prefer /health for liveness checks behind api.licensekit.dev. /healthz remains available for local and self-hosted compatibility.

Scope Metadata

from licensekit import get_required_scopes, has_required_scopes

scopes = get_required_scopes("createProduct")
allowed = has_required_scopes("createProduct", ["product:write"])

Raw Response Access

Each client exposes a .raw companion for callers that need status codes and headers.

from licensekit import SystemClient

system = SystemClient(base_url="https://api.licensekit.dev")
ready = system.raw.readyz()

print(ready.status, ready.data["data"]["status"])

Examples

Examples live in examples/:

• 01_create_scoped_api_key.py
• 02_runtime_validate_and_verify.py

Development

python3 -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
python scripts/generate_from_openapi.py
pytest
python -m build

Generation uses the checked-in OpenAPI snapshot at openapi/openapi.yaml.