Python Client

Python client SDK for the License Server gRPC API.

Installation

pip install -e .

For development dependencies:

pip install -e ".[dev]"

Quick Start

from license_client import LicenseClient, ClientConfig

config = ClientConfig(
    server_addr="localhost:9090",
    license_key="YOUR-LICENSE-KEY",
)

with LicenseClient(config) as client:
    # Validate license
    result = client.validate()
    if result.valid:
        print(f"License valid until {result.expires_at}")
        for ent in result.entitlements:
            print(f"  {ent.code}: {ent.name}")
    else:
        print(f"Validation failed: {result.error_message}")

mTLS Configuration

from license_client import LicenseClient, ClientConfig, TLSConfig

config = ClientConfig(
    server_addr="license.example.com:9090",
    license_key="YOUR-KEY",
    tls=TLSConfig(
        cert_file="client.crt",
        key_file="client.key",
        ca_file="ca.crt",
    ),
)

Features

• License validation with metadata
• Device activation / deactivation
• Heartbeat (manual)
• Usage reporting and status
• mTLS support
• Grace period token caching
• Hardware ID generation (compatible with Go client)
• Context manager support

Note

Offline .lic file validation is not yet supported in the Python client. Use the Go client for full offline mode including .lic file verification, grace-period caching, and automatic reconnection.

Development

make deps    # Install dev dependencies
make test    # Run tests
make lint    # Run linters
make proto   # Regenerate protobuf stubs

Proto Generation

The generated stubs are located at src/license_client/gen/license/v1/. To regenerate:

make proto

This requires grpcio-tools, which is installed with the dev dependencies.

Running Examples

export LICENSE_SERVER_ADDR="localhost:50090"
export LICENSE_KEY="YOUR-LICENSE-KEY"
uv run python -m examples.basic_validation --server $LICENSE_SERVER_ADDR --key $LICENSE_KEY