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

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

@@ -18,7 +18,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "320119579fcad9c21884f5c4861d16174d0e06250625266f50fe6898340abefa"
 
 [[package]]
-name = "agntcy-protoc-srpc-plugin"
+name = "agntcy-protoc-slimrpc-plugin"
 version = "0.1.0"
 dependencies = [
  "anyhow",
@@ -29,18 +29,19 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim"
-version = "0.4.0"
+version = "0.6.0"
 dependencies = [
  "agntcy-slim-config",
  "agntcy-slim-service",
  "agntcy-slim-signal",
  "agntcy-slim-tracing",
  "clap",
- "duration-str",
+ "duration-string",
  "jemallocator",
  "lazy_static",
  "num_cpus",
  "serde",
+ "serde_json",
  "serde_yaml",
  "thiserror 2.0.12",
  "tokio",
@@ -50,8 +51,9 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-auth"
-version = "0.2.0"
+version = "0.3.1"
 dependencies = [
+ "agntcy-slim-config",
  "async-trait",
  "aws-lc-rs",
  "base64 0.22.1",
@@ -63,7 +65,6 @@ dependencies = [
  "parking_lot",
  "pin-project",
  "reqwest",
- "rustls",
  "schemars",
  "serde",
  "serde_json",
@@ -101,12 +102,12 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-config"
-version = "0.2.0"
+version = "0.4.0"
 dependencies = [
  "agntcy-slim-auth",
  "base64 0.22.1",
  "drain",
- "duration-str",
+ "duration-string",
  "futures",
  "http 1.3.1",
  "hyper-rustls",
@@ -140,19 +141,24 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-controller"
-version = "0.2.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",
@@ -166,7 +172,7 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-datapath"
-version = "0.8.0"
+version = "0.10.0"
 dependencies = [
  "agntcy-slim-config",
  "agntcy-slim-tracing",
@@ -195,7 +201,7 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-mls"
-version = "0.1.0"
+version = "0.1.2"
 dependencies = [
  "agntcy-slim-auth",
  "agntcy-slim-datapath",
@@ -222,7 +228,7 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-service"
-version = "0.5.0"
+version = "0.7.0"
 dependencies = [
  "agntcy-slim-auth",
  "agntcy-slim-config",
@@ -230,6 +236,7 @@ dependencies = [
  "agntcy-slim-datapath",
  "agntcy-slim-mls",
  "async-trait",
+ "base64 0.22.1",
  "bincode",
  "dirs",
  "drain",
@@ -254,7 +261,7 @@ dependencies = [
 
 [[package]]
 name = "agntcy-slim-tracing"
-version = "0.2.2"
+version = "0.2.4"
 dependencies = [
  "agntcy-slim-config",
  "once_cell",
@@ -357,12 +364,6 @@ version = "1.0.98"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "e16d2d3311acee920a9eb8d33b8cbc1787ce4a264e85f964c2404b969bdcd487"
 
-[[package]]
-name = "arrayvec"
-version = "0.7.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7c02d123df017efcdfbd739ef81735b36c5ba83ec3c59c80a9d7ecc718f92e50"
-
 [[package]]
 name = "assert-json-diff"
 version = "2.0.2"
@@ -1023,17 +1024,12 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "92773504d58c093f6de2459af4af33faa518c13451eb8f2b5698ed3d36e7c813"
 
 [[package]]
-name = "duration-str"
-version = "0.12.0"
+name = "duration-string"
+version = "0.5.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "64ad6b66883f70e2f38f1ee99e3797b9d7e7b7fb051ed2e23e027c81753056c8"
+checksum = "edbd404ab304f4426de3e981a875a77129597ce04202c9b8b4502c6f1c246809"
 dependencies = [
- "chrono",
- "rust_decimal",
  "serde",
- "thiserror 2.0.12",
- "time",
- "winnow 0.6.26",
 ]
 
 [[package]]
@@ -3359,16 +3355,6 @@ dependencies = [
  "windows-sys 0.52.0",
 ]
 
-[[package]]
-name = "rust_decimal"
-version = "1.37.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b203a6425500a03e0919c42d3c47caca51e79f1132046626d2c8871c5092035d"
-dependencies = [
- "arrayvec",
- "num-traits",
-]
-
 [[package]]
 name = "rustc-demangle"
 version = "0.1.25"
@@ -3780,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",
 ]
@@ -4163,7 +4152,7 @@ dependencies = [
  "serde_spanned",
  "toml_datetime",
  "toml_write",
- "winnow 0.7.11",
+ "winnow",
 ]
 
 [[package]]
@@ -5000,15 +4989,6 @@ version = "0.53.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "271414315aff87387382ec3d271b52d7ae78726f5d44ac98b4f4030c91880486"
 
-[[package]]
-name = "winnow"
-version = "0.6.26"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1e90edd2ac1aa278a5c4599b1d89cf03074b610800f866d4026dc199d7929a28"
-dependencies = [
- "memchr",
-]
-
 [[package]]
 name = "winnow"
 version = "0.7.11"

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

@@ -1,6 +1,6 @@
 [workspace]
 
-members = ["python-bindings"]
+members = ["python/bindings"]
 
 default-members = [
     "core/config",
@@ -10,26 +10,26 @@ default-members = [
     "core/service",
     "core/signal",
     "core/tracing",
-    "srpc-compiler",
+    "slimrpc-compiler",
     "examples",
     "testing",
 ]
 
-exclude = ["integrations/mcp/mcp-proxy"]
+exclude = ["integrations/mcp-proxy"]
 
 resolver = "2"
 
 [workspace.dependencies]
 # Local dependencies
-agntcy-slim = { path = "core/slim", version = "0.4.0" }
-agntcy-slim-auth = { path = "core/auth", version = "0.2.0" }
-agntcy-slim-config = { path = "core/config", version = "0.2.0" }
-agntcy-slim-controller = { path = "core/controller", version = "0.2.0" }
-agntcy-slim-datapath = { path = "core/datapath", version = "0.8.0" }
-agntcy-slim-mls = { path = "core/mls", version = "0.1.0" }
-agntcy-slim-service = { path = "core/service", version = "0.5.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.2" }
+agntcy-slim-tracing = { path = "core/tracing", version = "0.2.4" }
 
 anyhow = "1.0.98"
 
@@ -43,7 +43,7 @@ clap = { version = "4.5.23", features = ["derive", "env"] }
 
 criterion = { version = "0.5", features = ["html_reports"] }
 drain = { version = "0.1", features = ["retain"] }
-duration-str = "0.12.0"
+duration-string = { version = "0.5.3", features = ["serde"] }
 futures = "0.3.31"
 h2 = "0.4.7"
 headers = "0.4.1"

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).
+