slim-bindings 0.5.0__tar.gz → 0.6.0__tar.gz

{slim_bindings-0.5.0 → slim_bindings-0.6.0}/Cargo.lock

@@ -29,7 +29,7 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim"
-version = "0.5.0"
+version = "0.6.0"
 dependencies = [
  "agntcy-slim-config",
  "agntcy-slim-service",
@@ -51,7 +51,7 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-auth"
-version = "0.3.0"
+version = "0.3.1"
 dependencies = [
  "agntcy-slim-config",
  "async-trait",
@@ -102,7 +102,7 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-config"
-version = "0.3.0"
+version = "0.4.0"
 dependencies = [
  "agntcy-slim-auth",
  "base64 0.22.1",
@@ -141,19 +141,24 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-controller"
-version = "0.3.0"
+version = "0.4.0"
 dependencies = [
+ "agntcy-slim-auth",
  "agntcy-slim-config",
  "agntcy-slim-datapath",
  "agntcy-slim-signal",
  "agntcy-slim-tracing",
+ "base64 0.22.1",
+ "bincode",
  "drain",
  "h2 0.4.10",
  "parking_lot",
  "prost 0.13.5",
  "protoc-bin-vendored",
+ "rand 0.9.1",
  "serde",
  "serde_json",
+ "serde_yaml",
  "thiserror 2.0.12",
  "tokio",
  "tokio-stream",
@@ -167,7 +172,7 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-datapath"
-version = "0.9.0"
+version = "0.10.0"
 dependencies = [
  "agntcy-slim-config",
  "agntcy-slim-tracing",
@@ -196,7 +201,7 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-mls"
-version = "0.1.1"
+version = "0.1.2"
 dependencies = [
  "agntcy-slim-auth",
  "agntcy-slim-datapath",
@@ -223,7 +228,7 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-service"
-version = "0.6.0"
+version = "0.7.0"
 dependencies = [
  "agntcy-slim-auth",
  "agntcy-slim-config",
@@ -231,6 +236,7 @@ dependencies = [
  "agntcy-slim-datapath",
  "agntcy-slim-mls",
  "async-trait",
+ "base64 0.22.1",
  "bincode",
  "dirs",
  "drain",
@@ -255,7 +261,7 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-tracing"
-version = "0.2.3"
+version = "0.2.4"
 dependencies = [
  "agntcy-slim-config",
  "once_cell",
@@ -3760,11 +3766,14 @@ dependencies = [
  "agntcy-slim",
  "agntcy-slim-auth",
  "agntcy-slim-config",
+ "agntcy-slim-controller",
  "agntcy-slim-datapath",
  "agntcy-slim-mls",
  "agntcy-slim-service",
  "agntcy-slim-signal",
+ "anyhow",
  "clap",
+ "prost 0.13.5",
  "tokio",
  "tracing",
 ]

{slim_bindings-0.5.0 → slim_bindings-0.6.0}/Cargo.toml

@@ -21,15 +21,15 @@ resolver = "2"
 
 [workspace.dependencies]
 # Local dependencies
-agntcy-slim = { path = "core/slim", version = "0.5.0" }
-agntcy-slim-auth = { path = "core/auth", version = "0.3.0" }
-agntcy-slim-config = { path = "core/config", version = "0.3.0" }
-agntcy-slim-controller = { path = "core/controller", version = "0.3.0" }
-agntcy-slim-datapath = { path = "core/datapath", version = "0.9.0" }
-agntcy-slim-mls = { path = "core/mls", version = "0.1.1" }
-agntcy-slim-service = { path = "core/service", version = "0.6.0" }
+agntcy-slim = { path = "core/slim", version = "0.6.0" }
+agntcy-slim-auth = { path = "core/auth", version = "0.3.1" }
+agntcy-slim-config = { path = "core/config", version = "0.4.0" }
+agntcy-slim-controller = { path = "core/controller", version = "0.4.0" }
+agntcy-slim-datapath = { path = "core/datapath", version = "0.10.0" }
+agntcy-slim-mls = { path = "core/mls", version = "0.1.2" }
+agntcy-slim-service = { path = "core/service", version = "0.7.0" }
 agntcy-slim-signal = { path = "core/signal", version = "0.1.3" }
-agntcy-slim-tracing = { path = "core/tracing", version = "0.2.3" }
+agntcy-slim-tracing = { path = "core/tracing", version = "0.2.4" }
 
 anyhow = "1.0.98"
 

slim_bindings-0.6.0/PKG-INFO

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: slim-bindings
+Version: 0.6.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Summary: SLIM Rust bindings for Python
+License-Expression: Apache-2.0
+Requires-Python: >=3.9, <4.0
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Repository, https://github.com/agntcy/slim
+Project-URL: Issues, https://github.com/agntcy/slim/issues
+Project-URL: Changelog, https://github.com/agntcy/slim/blob/main/data-plane/python/bindings/CHANGELOG.md
+
+# SLIM Python Bindings
+
+High-level asynchronous Python bindings for the SLIM data‑plane service (Rust core).
+They let you embed SLIM directly into your Python application to:
+
+- Instantiate a local SLIM service (`Slim.new`)
+- Run a server listener (start / stop a SLIM endpoint)
+- Establish outbound client connections (`connect` / `disconnect`)
+- Create, accept, configure, and delete sessions (Point2Point / Group)
+- Publish / receive messages (point‑to‑point or group (channel) based)
+- Manage routing and subscriptions (add / remove routes, subscribe / unsubscribe)
+- Configure identity & trust (shared secret, static JWT, dynamic signing JWT, JWKS auto‑resolve)
+- Integrate tracing / OpenTelemetry
+
+---
+
+## Supported Session Types
+
+| Type        | Description                                                                              | Sticky Peer | Metadata | MLS (group security) |
+|-------------|------------------------------------------------------------------------------------------|-------------|----------|----------------------|
+| Point2Point | Point-to-point with a fixed destination                                                  | Yes         | Yes      | Yes                  |
+| Group       | Many-to-many via channel/topic name (channel moderator can invite/remove participants)   | N/A         | Yes      | Yes                  |
+
+---
+
+## Identity & Authentication
+
+You can choose among multiple identity provider / verifier strategies:
+
+| Provider Variant                      | Use Case                               | Notes |
+|--------------------------------------|-----------------------------------------|-------|
+| `PyIdentityProvider.SharedSecret`    | Local dev / tests                       | Symmetric; not for production |
+| `PyIdentityProvider.StaticJwt`       | Pre-issued token loaded from file       | No key rotation; simple |
+| `PyIdentityProvider.Jwt`             | Dynamically signed JWT (private key)    | Supports exp, iss, aud, sub, duration |
+| `PyIdentityVerifier.Jwt`             | Verifies JWT (public key or JWKS auto)  | Optional claim requirements (`require_iss`, etc.) |
+| `PyIdentityVerifier.SharedSecret`    | Matches shared secret provider          | Symmetric validation |
+
+JWKS auto‑resolution (when configured in the verifier with `autoresolve=True`) will:
+1. Try OpenID discovery (`/.well-known/openid-configuration`) for `jwks_uri`
+2. Fallback to `/.well-known/jwks.json`
+3. Cache the key set with a TTL and prefer `kid` match, else algorithm match.
+
+---
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pip install slim-bindings
+```
+
+### 2. Minimal Receiver Example
+
+```python
+import asyncio
+import slim_bindings
+
+async def main():
+    # 1. Create identity (shared secret for demo)
+    provider = slim_bindings.PyIdentityProvider.SharedSecret(identity="demo", shared_secret="secret")
+    verifier = slim_bindings.PyIdentityVerifier.SharedSecret(identity="demo", shared_secret="secret")
+
+    local_name = slim_bindings.PyName("org", "namespace", "demo")
+    slim = await slim_bindings.Slim.new(local_name, provider, verifier)
+
+    # 2. (Optionally) connect as a client to a remote endpoint
+    # await slim.connect({"endpoint": "http://127.0.0.1:50000", "tls": {"insecure": True}})
+
+    # 3. (Optionally) run a local server (insecure TLS for local dev)
+    # await slim.run_server({"endpoint": "127.0.0.1:40000", "tls": {"insecure": True}})
+
+    # 4. Wait for inbound session
+    print("Waiting for an inbound session...")
+    session = await slim.listen_for_session()
+
+    # 5. Receive one message and reply
+    msg_ctx, payload = await session.get_message()
+    print("Received:", payload)
+    await session.publish_to(msg_ctx, b"echo:" + payload)
+
+    # 6. Clean shutdown
+    await slim.delete_session(session)
+    await slim.stop_server("127.0.0.1:40000")
+
+asyncio.run(main())
+```
+
+### 3. Outbound Session (PointToPoint)
+
+```python
+remote = slim_bindings.PyName("org", "namespace", "peer")
+session = await slim.create_session(
+    slim_bindings.PySessionConfiguration.PointToPoint(
+        peer_name=remote,
+        mls_enabled=True,
+        metadata={"trace_id": "abc123"},
+    )
+)
+await slim.set_route(remote)
+await session.publish(b"hello")
+ctx, reply = await session.get_message()
+print("Reply:", reply)
+await slim.delete_session(session)
+```
+
+---
+
+## Tracing / Observability
+
+Initialize tracing (optionally enabling OpenTelemetry export):
+
+```python
+await slim_bindings.init_tracing({
+    "log_level": "info",
+    "opentelemetry": {
+        "enabled": True,
+        "grpc": {"endpoint": "http://localhost:4317"}
+    }
+})
+```
+
+---
+
+## Installation
+
+```bash
+pip install slim-bindings
+```
+
+---
+
+## Include as Dependency
+
+### With `pyproject.toml`
+
+```toml
+[project]
+name = "slim-example"
+version = "0.1.0"
+description = "Python program using SLIM"
+requires-python = ">=3.9"
+dependencies = [
+    "slim-bindings>=0.6.0"
+]
+```
+
+### With Poetry
+
+```toml
+[tool.poetry]
+name = "slim-example"
+version = "0.1.0"
+description = "Python program using SLIM"
+
+[tool.poetry.dependencies]
+python = ">=3.9,<3.14"
+slim-bindings = ">=0.5.0"
+```
+
+---
+
+## Feature Highlights
+
+| Area            | Capability |
+|-----------------|------------|
+| Server          | `run_server`, `stop_server` |
+| Client          | `connect`, `disconnect`, automatic subscribe to local name |
+| Routing         | `set_route`, `remove_route` |
+| Subscriptions   | `subscribe`, `unsubscribe` |
+| Sessions        | `create_session`, `listen_for_session`, `delete_session`, `set_session_config` |
+| Messaging       | `publish`, `publish_to`, `get_message` |
+| Identity        | Shared secret, static JWT, dynamic JWT signing, JWT verification (public key / JWKS) |
+| Tracing         | Structured logs & optional OpenTelemetry export |
+
+---
+
+## Example Programs
+
+Complete runnable examples (point2point, group, server) live in the repository:
+
+https://github.com/agntcy/slim/tree/slim-v0.5.0/data-plane/python/bindings/examples
+
+You can install and invoke them (after building) via:
+
+```bash
+slim-bindings-examples point2point ...
+slim-bindings-examples group ...
+slim-bindings-examples slim ...
+```
+
+---
+
+## When to Use Each Session Type
+
+| Use Case                          | Recommended Type |
+|----------------------------------|-------------------|
+| Stable peer workflow / stateful  | Point2Point       |
+| Group chat / fan-out             | Group             |
+
+---
+
+## Security Notes
+
+- Prefer asymmetric JWT-based identity in production.
+- Rotate keys periodically and enable `require_iss`, `require_aud`, `require_sub`.
+- Shared secret is only suitable for local tests and prototypes.
+
+---
+
+## License
+
+Apache-2.0 (see repository for full license text).
+

slim_bindings-0.6.0/README.md

@@ -0,0 +1,213 @@
+# SLIM Python Bindings
+
+High-level asynchronous Python bindings for the SLIM data‑plane service (Rust core).
+They let you embed SLIM directly into your Python application to:
+
+- Instantiate a local SLIM service (`Slim.new`)
+- Run a server listener (start / stop a SLIM endpoint)
+- Establish outbound client connections (`connect` / `disconnect`)
+- Create, accept, configure, and delete sessions (Point2Point / Group)
+- Publish / receive messages (point‑to‑point or group (channel) based)
+- Manage routing and subscriptions (add / remove routes, subscribe / unsubscribe)
+- Configure identity & trust (shared secret, static JWT, dynamic signing JWT, JWKS auto‑resolve)
+- Integrate tracing / OpenTelemetry
+
+---
+
+## Supported Session Types
+
+| Type        | Description                                                                              | Sticky Peer | Metadata | MLS (group security) |
+|-------------|------------------------------------------------------------------------------------------|-------------|----------|----------------------|
+| Point2Point | Point-to-point with a fixed destination                                                  | Yes         | Yes      | Yes                  |
+| Group       | Many-to-many via channel/topic name (channel moderator can invite/remove participants)   | N/A         | Yes      | Yes                  |
+
+---
+
+## Identity & Authentication
+
+You can choose among multiple identity provider / verifier strategies:
+
+| Provider Variant                      | Use Case                               | Notes |
+|--------------------------------------|-----------------------------------------|-------|
+| `PyIdentityProvider.SharedSecret`    | Local dev / tests                       | Symmetric; not for production |
+| `PyIdentityProvider.StaticJwt`       | Pre-issued token loaded from file       | No key rotation; simple |
+| `PyIdentityProvider.Jwt`             | Dynamically signed JWT (private key)    | Supports exp, iss, aud, sub, duration |
+| `PyIdentityVerifier.Jwt`             | Verifies JWT (public key or JWKS auto)  | Optional claim requirements (`require_iss`, etc.) |
+| `PyIdentityVerifier.SharedSecret`    | Matches shared secret provider          | Symmetric validation |
+
+JWKS auto‑resolution (when configured in the verifier with `autoresolve=True`) will:
+1. Try OpenID discovery (`/.well-known/openid-configuration`) for `jwks_uri`
+2. Fallback to `/.well-known/jwks.json`
+3. Cache the key set with a TTL and prefer `kid` match, else algorithm match.
+
+---
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pip install slim-bindings
+```
+
+### 2. Minimal Receiver Example
+
+```python
+import asyncio
+import slim_bindings
+
+async def main():
+    # 1. Create identity (shared secret for demo)
+    provider = slim_bindings.PyIdentityProvider.SharedSecret(identity="demo", shared_secret="secret")
+    verifier = slim_bindings.PyIdentityVerifier.SharedSecret(identity="demo", shared_secret="secret")
+
+    local_name = slim_bindings.PyName("org", "namespace", "demo")
+    slim = await slim_bindings.Slim.new(local_name, provider, verifier)
+
+    # 2. (Optionally) connect as a client to a remote endpoint
+    # await slim.connect({"endpoint": "http://127.0.0.1:50000", "tls": {"insecure": True}})
+
+    # 3. (Optionally) run a local server (insecure TLS for local dev)
+    # await slim.run_server({"endpoint": "127.0.0.1:40000", "tls": {"insecure": True}})
+
+    # 4. Wait for inbound session
+    print("Waiting for an inbound session...")
+    session = await slim.listen_for_session()
+
+    # 5. Receive one message and reply
+    msg_ctx, payload = await session.get_message()
+    print("Received:", payload)
+    await session.publish_to(msg_ctx, b"echo:" + payload)
+
+    # 6. Clean shutdown
+    await slim.delete_session(session)
+    await slim.stop_server("127.0.0.1:40000")
+
+asyncio.run(main())
+```
+
+### 3. Outbound Session (PointToPoint)
+
+```python
+remote = slim_bindings.PyName("org", "namespace", "peer")
+session = await slim.create_session(
+    slim_bindings.PySessionConfiguration.PointToPoint(
+        peer_name=remote,
+        mls_enabled=True,
+        metadata={"trace_id": "abc123"},
+    )
+)
+await slim.set_route(remote)
+await session.publish(b"hello")
+ctx, reply = await session.get_message()
+print("Reply:", reply)
+await slim.delete_session(session)
+```
+
+---
+
+## Tracing / Observability
+
+Initialize tracing (optionally enabling OpenTelemetry export):
+
+```python
+await slim_bindings.init_tracing({
+    "log_level": "info",
+    "opentelemetry": {
+        "enabled": True,
+        "grpc": {"endpoint": "http://localhost:4317"}
+    }
+})
+```
+
+---
+
+## Installation
+
+```bash
+pip install slim-bindings
+```
+
+---
+
+## Include as Dependency
+
+### With `pyproject.toml`
+
+```toml
+[project]
+name = "slim-example"
+version = "0.1.0"
+description = "Python program using SLIM"
+requires-python = ">=3.9"
+dependencies = [
+    "slim-bindings>=0.6.0"
+]
+```
+
+### With Poetry
+
+```toml
+[tool.poetry]
+name = "slim-example"
+version = "0.1.0"
+description = "Python program using SLIM"
+
+[tool.poetry.dependencies]
+python = ">=3.9,<3.14"
+slim-bindings = ">=0.5.0"
+```
+
+---
+
+## Feature Highlights
+
+| Area            | Capability |
+|-----------------|------------|
+| Server          | `run_server`, `stop_server` |
+| Client          | `connect`, `disconnect`, automatic subscribe to local name |
+| Routing         | `set_route`, `remove_route` |
+| Subscriptions   | `subscribe`, `unsubscribe` |
+| Sessions        | `create_session`, `listen_for_session`, `delete_session`, `set_session_config` |
+| Messaging       | `publish`, `publish_to`, `get_message` |
+| Identity        | Shared secret, static JWT, dynamic JWT signing, JWT verification (public key / JWKS) |
+| Tracing         | Structured logs & optional OpenTelemetry export |
+
+---
+
+## Example Programs
+
+Complete runnable examples (point2point, group, server) live in the repository:
+
+https://github.com/agntcy/slim/tree/slim-v0.5.0/data-plane/python/bindings/examples
+
+You can install and invoke them (after building) via:
+
+```bash
+slim-bindings-examples point2point ...
+slim-bindings-examples group ...
+slim-bindings-examples slim ...
+```
+
+---
+
+## When to Use Each Session Type
+
+| Use Case                          | Recommended Type |
+|----------------------------------|-------------------|
+| Stable peer workflow / stateful  | Point2Point       |
+| Group chat / fan-out             | Group             |
+
+---
+
+## Security Notes
+
+- Prefer asymmetric JWT-based identity in production.
+- Rotate keys periodically and enable `require_iss`, `require_aud`, `require_sub`.
+- Shared secret is only suitable for local tests and prototypes.
+
+---
+
+## License
+
+Apache-2.0 (see repository for full license text).

{slim_bindings-0.5.0 → slim_bindings-0.6.0}/core/auth/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.1](https://github.com/agntcy/slim/compare/slim-auth-v0.3.0...slim-auth-v0.3.1) - 2025-10-09
+
+### Added
+
+- implement control plane group management ([#554](https://github.com/agntcy/slim/pull/554))
+- remove bearer auth in favour of static jwt ([#774](https://github.com/agntcy/slim/pull/774))
+
+### Other
+
+- upgrade to rust toolchain 1.90.0 ([#730](https://github.com/agntcy/slim/pull/730))
+
 ## [0.3.0](https://github.com/agntcy/slim/compare/slim-auth-v0.2.0...slim-auth-v0.3.0) - 2025-09-17
 
 ### Added

{slim_bindings-0.5.0 → slim_bindings-0.6.0}/core/auth/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "agntcy-slim-auth"
-version = "0.3.0"
+version = "0.3.1"
 license = { workspace = true }
 edition = { workspace = true }
 description = "Authentication utilities for the Agntcy Slim framework"