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
`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.21.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.21.0
File	Size	Uploaded
celine_sdk-1.21.0.tar.gz	367.5 kB	Sep 28, 2026	Details

Built distribution (wheel)

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

Total release size: 1.2 MB

Release files / celine_sdk-1.21.0.tar.gz

Download URL	celine_sdk-1.21.0.tar.gz
Size	367.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`b8c9a2a8a9919c158c380e0f37136231067cc8e05842acc3e4bfc56d45887c50`
BLAKE2b-256 checksum How to use checksums	`978b0bfe938d37c840f4597b5113efca5052e2f894741383b41ca70193e3daff`
Upload date	Sep 28, 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/e37f6c4aad5d4e6c0d0d3d61deab8d4dbdd1a157

Workflow

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

Artifact

Subject: celine_sdk-1.21.0.tar.gz
SHA-256 checksum: b8c9a2a8a9919c158c380e0f37136231067cc8e05842acc3e4bfc56d45887c50 Verifying attestations

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

Download URL	celine_sdk-1.21.0-py3-none-any.whl
Size	800.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`111515c92a5ffb1e4cafa2e1cc185352b39c1beaa591a73d2dcadc81200e7486`
BLAKE2b-256 checksum How to use checksums	`df243b14523a2064633a0104a61c1bbee38b79cde9d2eb682986e06a500fc955`
Upload date	Sep 28, 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/e37f6c4aad5d4e6c0d0d3d61deab8d4dbdd1a157

Workflow

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

Artifact

Subject: celine_sdk-1.21.0-py3-none-any.whl
SHA-256 checksum: 111515c92a5ffb1e4cafa2e1cc185352b39c1beaa591a73d2dcadc81200e7486 Verifying attestations