neonlink-client 1.3.15__tar.gz

neonlink_client-1.3.15/.gitignore

@@ -0,0 +1,82 @@
+# Binaries for programs and plugins
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary, built with `go test -c`
+*.test
+
+# Output of the go coverage tool
+*.out
+
+# Dependency directories
+vendor/
+
+# Go workspace file
+go.work
+
+# Environment variables
+# .env
+.env.local
+.env.*.local
+.env.staging
+.env.production
+*.env
+!.env.example
+
+# IDE specific files
+.idea/
+.vscode/
+*.swp
+*.swo
+
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Application specific
+logs/
+tmp/
+dist/
+build/
+
+# Certificates
+*.pem
+*.key
+*.crt
+
+# Database files
+*.db
+*.sqlite
+
+# Temporary files
+*.tmp
+*.bak
+*.backup/neonlink
+
+# Build artifacts (Go binaries in root)
+/neonlink
+/debug-client
+
+# Temp files
+tmp/
+bin/
+
+# JWT tokens directory (sensitive)
+tokens/
+*.token
+
+# Ignore stray archived draft file
+documents/10-archive/archive/insight_service_input copy.md
+
+# Ignore stray archived draft file
+documents/10-archive/archive/insight_service_input copy.md

neonlink_client-1.3.15/CHANGELOG.md

@@ -0,0 +1,71 @@
+# Changelog
+
+All notable changes to the NeonLink Python SDK will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Nothing yet
+
+## [1.0.0] - 2025-12-06
+
+### Added
+- Initial release of NeonLink Python SDK
+- **Core Client** (`NeonLinkClient`)
+  - Async/await support with `grpcio`
+  - Context manager support (`async with`)
+  - Connection management with auto-reconnection
+  - TLS/mTLS support for secure connections
+- **Configuration** (`ConfigBuilder`, `NeonLinkConfig`)
+  - Builder pattern for fluent configuration
+  - Environment variable support (`NEONLINK_*`)
+  - TLS configuration (`TLSConfig`)
+  - Retry policy configuration (`RetryPolicy`)
+- **Middleware System**
+  - `LoggingMiddleware` - Request/response logging
+  - `RetryMiddleware` - Exponential backoff retries
+  - `TimeoutMiddleware` - Request timeout enforcement
+  - `RecoveryMiddleware` - Exception handling
+  - `MetricsMiddleware` - Performance metrics collection
+- **Message Building** (`MessageBuilder`)
+  - Fluent builder pattern for message construction
+  - Automatic UUID generation for message IDs
+  - JSON payload support
+  - Idempotency key support (explicit and field-based generation)
+- **Helper Functions**
+  - `get_identity_context()` - Extract identity headers
+  - `get_webhook_ingress_context()` - Extract webhook headers
+  - `get_active_job_type_name()` - Get job type from headers
+  - `get_job_type_message()` - Get job type message from headers
+- **Error Handling**
+  - `NeonLinkError` - Base exception class
+  - `ConnectionError` - Connection failures
+  - `TimeoutError` - Request timeouts
+  - `PublishError` - Publish failures
+  - `SubscribeError` - Subscription failures
+  - `AckError` - Acknowledgment failures
+  - `ConfigurationError` - Invalid configuration
+- **gRPC Operations**
+  - `publish()` - Send messages to streams
+  - `subscribe()` - Stream messages with async iterator
+  - `ack()` - Acknowledge processed messages
+  - `nack()` - Negative acknowledge failed messages
+  - `get_stream_health()` - Check stream health metrics
+  - `health_check()` - Connection health verification
+
+### Feature Parity
+- Full feature parity with Go SDK v1.0.8
+- All core operations supported
+- Middleware chain compatible with Go SDK patterns
+- Idempotency key generation matches Go SDK algorithm
+
+### Documentation
+- Comprehensive README with quick start guide
+- Five example scripts demonstrating usage patterns
+- Type hints throughout for IDE support
+
+[Unreleased]: https://github.com/LetA-Tech/mcfo-neonlink/compare/py3-v1.0.0...HEAD
+[1.0.0]: https://github.com/LetA-Tech/mcfo-neonlink/releases/tag/py3-v1.0.0

neonlink_client-1.3.15/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 LetA Tech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

neonlink_client-1.3.15/PKG-INFO

@@ -0,0 +1,285 @@
+Metadata-Version: 2.4
+Name: neonlink-client
+Version: 1.3.15
+Summary: Official Python client for NeonLink message broker
+Project-URL: Homepage, https://github.com/LetA-Tech/mcfo-neonlink
+Project-URL: Documentation, https://github.com/LetA-Tech/mcfo-neonlink/tree/main/py3
+Project-URL: Repository, https://github.com/LetA-Tech/mcfo-neonlink.git
+Project-URL: Changelog, https://github.com/LetA-Tech/mcfo-neonlink/blob/main/py3/CHANGELOG.md
+Author-email: LetA Tech <dev@leta.tech>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: async,grpc,mellions,message-broker,neonlink,redis-streams
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: grpcio-tools>=1.60.0
+Requires-Dist: grpcio>=1.60.0
+Requires-Dist: neoncontract-gen>=1.3.15
+Requires-Dist: protobuf>=4.25.0
+Provides-Extra: dev
+Requires-Dist: grpcio-testing>=1.60.0; extra == 'dev'
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# NeonLink Python SDK
+
+Official Python client library for NeonLink message broker. Full feature parity with the Go SDK.
+
+## Installation
+
+```bash
+pip install neonlink-client
+```
+
+Or install from source:
+
+```bash
+cd py3
+pip install -e .
+```
+
+For development:
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Requirements
+
+- Python >= 3.10
+- gRPC runtime (`grpcio`)
+- Protocol Buffers (`protobuf`)
+
+## Quick Start
+
+### Publishing Messages
+
+```python
+import asyncio
+from neonlink import NeonLinkClient, ConfigBuilder, MessageBuilder
+
+
+async def main():
+    config = (
+        ConfigBuilder()
+        .with_service_name("my-service")
+        .with_address("neonlink:9090")
+        .build()
+    )
+
+    async with NeonLinkClient(config) as client:
+        request = (
+            MessageBuilder()
+            .with_stream("my-stream")
+            .with_message_type("MyMessage")
+            .with_json_payload({"key": "value"})
+            .with_idempotency_fields("user-123", "action-456")
+            .build()
+        )
+
+        response = await client.publish(request)
+        print(f"Published: {response.message_id}")
+
+
+asyncio.run(main())
+```
+
+### Subscribing to Streams
+
+```python
+import asyncio
+from neonlink import NeonLinkClient, ConfigBuilder
+from neoncontract.messaging.v1 import messaging_pb2
+
+
+async def main():
+    config = (
+        ConfigBuilder()
+        .with_service_name("my-worker")
+        .with_address("neonlink:9090")
+        .build()
+    )
+
+    async with NeonLinkClient(config) as client:
+        client.enable_auto_reconnect()
+
+        request = messaging_pb2.SubscribeRequest(
+            stream="my-stream",
+            consumer_group="my-workers",
+        )
+
+        async for message in client.subscribe(request):
+            print(f"Received: {message.message_id}")
+
+            # Process message...
+
+            await client.ack(messaging_pb2.AckRequest(
+                message_id=message.message_id,
+                stream=message.stream,
+            ))
+
+
+asyncio.run(main())
+```
+
+## Configuration
+
+### From Code
+
+```python
+from neonlink import ConfigBuilder
+
+config = (
+    ConfigBuilder()
+    .with_service_name("my-service")
+    .with_address("neonlink:9090")
+    .with_timeout(30.0)
+    .with_retry_policy(max_retries=3, initial_backoff=0.1)
+    .with_tls(
+        cert_path="/path/to/cert.pem",
+        key_path="/path/to/key.pem",
+        ca_path="/path/to/ca.pem",
+    )
+    .build()
+)
+```
+
+### From Environment Variables
+
+```python
+from neonlink import NeonLinkConfig
+
+config = NeonLinkConfig.from_env()
+```
+
+Environment variables:
+- `NEONLINK_SERVICE_NAME` (required)
+- `NEONLINK_ADDRESS` (default: `localhost:9090`)
+- `NEONLINK_TIMEOUT` (default: `30`)
+- `NEONLINK_TLS_CERT`
+- `NEONLINK_TLS_KEY`
+- `NEONLINK_TLS_CA`
+- `NEONLINK_TLS_INSECURE`
+
+## Middleware
+
+Add middleware for logging, retries, timeouts, and metrics:
+
+```python
+from neonlink import (
+    NeonLinkClient,
+    LoggingMiddleware,
+    RetryMiddleware,
+    TimeoutMiddleware,
+    MetricsMiddleware,
+)
+
+middlewares = [
+    LoggingMiddleware(),
+    RetryMiddleware(max_retries=3),
+    TimeoutMiddleware(timeout=10.0),
+    MetricsMiddleware(my_metrics_collector),
+]
+
+client = NeonLinkClient(config, middlewares=middlewares)
+```
+
+## Idempotency
+
+Use the `MessageBuilder` to ensure idempotent message delivery:
+
+```python
+from neonlink import MessageBuilder
+
+# Option 1: Explicit idempotency key
+request = (
+    MessageBuilder()
+    .with_stream("my-stream")
+    .with_message_type("MyMessage")
+    .with_idempotency_key("unique-key-123")
+    .build()
+)
+
+# Option 2: Generate from fields (recommended)
+request = (
+    MessageBuilder()
+    .with_stream("my-stream")
+    .with_message_type("MyMessage")
+    .with_idempotency_fields("user-123", "action-456", "timestamp")
+    .build()
+)
+```
+
+## Proto Definitions
+
+The SDK uses protobuf definitions from the `neoncontract` package, which is automatically
+installed as a dependency. The package provides all message types for the NeonLink gRPC service.
+
+```python
+# Import protobuf types directly from neoncontract
+from neoncontract.messaging.v1 import messaging_pb2
+
+# Available types:
+# - messaging_pb2.PublishRequest
+# - messaging_pb2.PublishResponse
+# - messaging_pb2.SubscribeRequest
+# - messaging_pb2.StreamMessage
+# - messaging_pb2.AckRequest
+# - messaging_pb2.AckResponse
+# - messaging_pb2.NackRequest
+# - messaging_pb2.NackResponse
+```
+
+## Development
+
+### Running Tests
+
+```bash
+pytest
+```
+
+With coverage:
+
+```bash
+pytest --cov=neonlink --cov-report=html
+```
+
+### Type Checking
+
+```bash
+mypy neonlink
+```
+
+### Linting
+
+```bash
+ruff check neonlink
+```
+
+## Examples
+
+See the `examples/` directory for complete examples:
+
+- `publish.py` - Basic publishing
+- `subscribe.py` - Subscribing and processing
+- `middleware_example.py` - Using middleware
+- `finai_integration.py` - FinAI service integration
+- `retry_example.py` - Retry behavior
+
+## License
+
+MIT License - see LICENSE file.