CELINE SDK

Shared SDK for the CELINE platform. Provides OIDC authentication, MQTT broker abstraction, Pydantic settings, and OpenAPI spec management with generated typed clients.

Modules

Module	Description
`celine.sdk.auth`	OIDC token provider, JWKS-based JWT parsing, token refresh
`celine.sdk.broker`	MQTT client with auto-reconnect and JWT authentication
`celine.sdk.settings`	Shared Pydantic settings: OIDC, MQTT, policies
`celine.sdk.openapi.*`	Generated typed clients for CELINE services
`celine.sdk.dt`	Digital Twin domain client helpers
`celine.sdk.nudging`	Nudging service client
`celine.sdk.onboarding`	Onboarding: a member's own data-sharing decisions (`OnboardingClient`), and, on `OnboardingAdminClient`, a service sending a registry member an invitation or password reset for a manager, and a realm admin's registry sync of a community's areas (`registry_sync`)
`celine.sdk.policies`	OPA policy evaluation over a service's own `*.rego` bundle
`celine.sdk.rec_registry`	REC registry client helpers (`RecRegistryUserClient`, `RecRegistryAdminClient`): the batch lookups; a member's meter (`put_asset`, `delete_asset`) and role and area (`patch_member_profile`); a community's areas and topology (`read_community`, `put_area`, `delete_area`, `rename_area`, `put_topology_node`, `delete_topology_node`). A refusal raises `RecRegistryApiError` with the registry's `code` (`sensor_held`, `unknown_area`, `not_a_member`, …) beside `status_code` and `detail`
`celine.sdk.flexibility`	Flexibility service client helpers
`celine.sdk.ai_assistant`	AI assistant client helpers

celine.sdk.clients, celine.sdk.utils and celine.sdk.cli are internal: they support the modules above and the spec-management CLI, and are not part of the public surface.

Installation

pip install celine-sdk

Client generation needs the code generators from this repository's dev dependency group (Python ≥ 3.11) — uv sync in a checkout. It is a maintainer task performed here, not something a consuming service does.

CLI Quick Reference

# Fetch and version OpenAPI specs (writes to ./openapi/)
celine-sdk spec fetch services.yaml

# List discovered spec versions
celine-sdk spec list

# Generate typed Python clients (needs the dev dependency group)
celine-sdk generate services.yaml

# Both steps, in a checkout
task gen

services.yaml Format

services:
  digital-twin:
    package: dt
    openapi: http://dt:8000/openapi.json
  policies:
    openapi: http://policies:8000/openapi.json

Documentation

Document	Description
Auth	OIDC token provider, JWT parsing, AccessToken model
Broker	MQTT client, auto-reconnect, JWT auth, subscription handling
Settings	OidcSettings, MqttSettings, PoliciesSettings, env var config
Spec Management	services.yaml format, spec fetch, versioning, client generation
Specifications	What the SDK must do, as numbered requirements each named by a test

License

Metadata

Release files for celine-sdk 1.23.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for celine-sdk 1.23.0
File	Size	Uploaded
celine_sdk-1.23.0.tar.gz	378.8 kB	Oct 1, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for celine-sdk 1.23.0
File	Interpreter	ABI	Platform	Reset
celine_sdk-1.23.0-py3-none-any.whl 818.1 kB Oct 1, 2026	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / celine_sdk-1.23.0.tar.gz

Download URL	celine_sdk-1.23.0.tar.gz
Size	378.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`58bd7cdd8799fc32b560f0d3c70709fa2ceb7c7deee57fc5e1fc3e6b5e681d41`
BLAKE2b-256 checksum How to use checksums	`488eb1cfc79fa234a3a18ffc91fad0dc78b4c0bb6c587aa2915c297f9fc6ed63`
Upload date	Oct 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/celine-eu/celine-sdk
Publishing commit: github.com/celine-eu/celine-sdk/tree/78003d1adafdbc2d13bd4ce7087260e87d28e2c3

Workflow

Publishing configuration: github.com/celine-eu/celine-sdk/blob/78003d1adafdbc2d13bd4ce7087260e87d28e2c3/.github/workflows/release.yaml
Publishing logs: github.com/celine-eu/celine-sdk/actions/runs/36840253102/attempts/1

Artifact

Subject: celine_sdk-1.23.0.tar.gz
SHA-256 checksum: 58bd7cdd8799fc32b560f0d3c70709fa2ceb7c7deee57fc5e1fc3e6b5e681d41 Verifying attestations

Release files / celine_sdk-1.23.0-py3-none-any.whl

Download URL	celine_sdk-1.23.0-py3-none-any.whl
Size	818.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f1bca6a68f149a1aa2bc6f8b3f5260d55d780e887ef255ce58b0749423d550d1`
BLAKE2b-256 checksum How to use checksums	`d13fa7f8db5369c88c1af763af1d4d015f9d163bfaa3af324df21cb0d2577557`
Upload date	Oct 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/celine-eu/celine-sdk
Publishing commit: github.com/celine-eu/celine-sdk/tree/78003d1adafdbc2d13bd4ce7087260e87d28e2c3

Workflow

Publishing configuration: github.com/celine-eu/celine-sdk/blob/78003d1adafdbc2d13bd4ce7087260e87d28e2c3/.github/workflows/release.yaml
Publishing logs: github.com/celine-eu/celine-sdk/actions/runs/36840253102/attempts/1

Artifact

Subject: celine_sdk-1.23.0-py3-none-any.whl
SHA-256 checksum: f1bca6a68f149a1aa2bc6f8b3f5260d55d780e887ef255ce58b0749423d550d1 Verifying attestations