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.22.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.22.0
File	Size	Uploaded
celine_sdk-1.22.0.tar.gz	368.1 kB	Sep 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for celine-sdk 1.22.0
File	Interpreter	ABI	Platform	Reset
celine_sdk-1.22.0-py3-none-any.whl 800.4 kB Sep 29, 2026	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / celine_sdk-1.22.0.tar.gz

Download URL	celine_sdk-1.22.0.tar.gz
Size	368.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`d1b8799ddf59bab08c7d1dc8267c08ce4fc9b466571555c1a61dded377e11ac3`
BLAKE2b-256 checksum How to use checksums	`be8cf2d5c01429e45c1a8a420fcb2d660b92f620dcd2bc31bb32161432f9219d`
Upload date	Sep 29, 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/23304aee3e2cbcaccc0ae18ef45ee18159505b95

Workflow

Publishing configuration: github.com/celine-eu/celine-sdk/blob/23304aee3e2cbcaccc0ae18ef45ee18159505b95/.github/workflows/release.yaml
Publishing logs: github.com/celine-eu/celine-sdk/actions/runs/36528221668/attempts/1

Artifact

Subject: celine_sdk-1.22.0.tar.gz
SHA-256 checksum: d1b8799ddf59bab08c7d1dc8267c08ce4fc9b466571555c1a61dded377e11ac3 Verifying attestations

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

Download URL	celine_sdk-1.22.0-py3-none-any.whl
Size	800.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e0bee26cec9fd37750c7141bfb6e56696e3d2b2afe974f80a3441e6d36e8f31e`
BLAKE2b-256 checksum How to use checksums	`5656c77c9e2ec1789e9f58bc161b2266b7fe795b5f6ba86cb5d27dd349bcbe6a`
Upload date	Sep 29, 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/23304aee3e2cbcaccc0ae18ef45ee18159505b95

Workflow

Publishing configuration: github.com/celine-eu/celine-sdk/blob/23304aee3e2cbcaccc0ae18ef45ee18159505b95/.github/workflows/release.yaml
Publishing logs: github.com/celine-eu/celine-sdk/actions/runs/36528221668/attempts/1

Artifact

Subject: celine_sdk-1.22.0-py3-none-any.whl
SHA-256 checksum: e0bee26cec9fd37750c7141bfb6e56696e3d2b2afe974f80a3441e6d36e8f31e Verifying attestations