kiponos-pysdk 0.1.2

Kiponos Python SDK for real-time configuration management via WebSocket/STOMP for Kiponos.io

Kiponos Python SDK

The Kiponos Python SDK enables real-time configuration management via WebSocket/STOMP. It connects to the Kiponos server, fetches a configuration tree, and subscribes to updates for dynamic config changes.

Installation

Install via pip:

pip install kiponos-pysdk

Prerequisites

• Python 3.12 or higher
• Environment variables: KIPONOS_ID and KIPONOS_ACCESS (obtain from your Kiponos team account)

Usage

Basic Example

from kiponos_pysdk import KiponosClient

# Initialize client
client = KiponosClient(
    server_url="wss://kiponos.io/api/io-kiponos-sdk",
    kiponos="['Kiponos-Server']['3.0']['Dev']['Factory-Settings']"
)

try:
    # Connect and fetch config
    client.connect()
    print(f"Team ID: {client.team_id}")
    print(f"Value: {client.get('tag-test', 'not found')}")

    # Keep program running to receive updates
    input("Press Enter to exit...")
finally:
    client.close()

Interactive Example

Run example_app.py for an interactive CLI:

poetry run python example_app.py

Commands:

• get <key>: Get value for a key
• list-keys: List all config keys
• dump: Print the entire config tree
• exit: Stop the program

Configuration

Set environment variables:

export KIPONOS_ID="your-kiponos-id"
export KIPONOS_ACCESS="your-kiponos-access"

License

MIT License. See LICENSE for details.

Support

Contact: [e-mail] Homepage: https://kiponos.io