xecurecode-reliability-sdk 0.1.1__tar.gz

xecurecode_reliability_sdk-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 XecureTrace
+
+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.

xecurecode_reliability_sdk-0.1.1/PKG-INFO

@@ -0,0 +1,247 @@
+Metadata-Version: 2.4
+Name: xecurecode-reliability-sdk
+Version: 0.1.1
+Summary: AI-driven reliability SDK for Python applications
+Author-email: XecureCode Team <team@xecurecode.in>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.100; extra == "fastapi"
+Provides-Extra: flask
+Requires-Dist: flask>=2.0; extra == "flask"
+Provides-Extra: django
+Requires-Dist: django>=3.0; extra == "django"
+Dynamic: license-file
+
+# XecureCode Reliability SDK - Python
+
+AI-driven reliability SDK for Python applications.
+
+The official Python SDK for the XecureCode Reliability Platform — a human-first failure analysis and recovery recommendation system.
+
+---
+
+## Why This SDK Exists
+
+Modern backend systems fail in unpredictable ways.
+
+This SDK:
+
+- Captures structured runtime errors
+- Generates deterministic fingerprints
+- Classifies error types (DATABASE, NETWORK, VALIDATION, etc.)
+- Determines severity
+- Sends non-blocking telemetry to your backend
+- Never crashes your application
+
+**AI assists. Humans decide. Nothing executes automatically.**
+
+---
+
+## Requirements
+
+- Python 3.8+
+- FastAPI, Flask, or Django (optional)
+
+---
+
+## Installation
+
+```bash
+pip install xecurecode-reliability-sdk
+```
+
+Or install with framework support:
+
+```bash
+pip install xecurecode-reliability-sdk[fastapi,flask,django]
+```
+
+---
+
+## Quick Start
+
+### 1️⃣ Initialize the SDK
+
+```python
+from reliability import ReliabilityClient, ReliabilityConfig
+
+config = ReliabilityConfig(
+    api_key="your-api-key",
+    service_id="your-service",
+    mode="development"
+)
+client = ReliabilityClient(config)
+```
+
+**Configuration Options:**
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `api_key` | Yes | Your API key |
+| `service_id` | Yes | Service identifier |
+| `mode` | Yes | `development` or `production` |
+| `timeout` | No | Request timeout (default: 5000ms) |
+
+---
+
+### 2️⃣ Automatic Global Error Capture
+
+The SDK automatically handles:
+- Uncaught exceptions
+- Thread exceptions
+
+```python
+# This will be automatically captured
+raise ValueError("Database timeout")
+```
+
+---
+
+### 3️⃣ FastAPI Integration
+
+```python
+from fastapi import FastAPI
+from reliability import ReliabilityClient, ReliabilityConfig
+from reliability.fastapi_integration import FastAPIMiddleware
+
+config = ReliabilityConfig(...)
+client = ReliabilityClient(config)
+
+app = FastAPI()
+app.add_middleware(FastAPIMiddleware, client=client)
+```
+
+---
+
+### 4️⃣ Flask Integration
+
+```python
+from flask import Flask
+from reliability import ReliabilityClient, ReliabilityConfig
+from reliability.flask_integration import init_flask
+
+config = ReliabilityConfig(...)
+client = ReliabilityClient(config)
+
+app = Flask(__name__)
+init_flask(app, client)
+```
+
+---
+
+### 5️⃣ Django Integration
+
+In `settings.py`:
+
+```python
+RELIABILITY_API_KEY = "your-api-key"
+RELIABILITY_SERVICE_ID = "your-service"
+RELIABILITY_MODE = "development"
+```
+
+In `settings.py` MIDDLEWARE:
+
+```python
+MIDDLEWARE = [
+    ...
+    'reliability.django_integration.ReliabilityMiddleware',
+    ...
+]
+```
+
+---
+
+### 6️⃣ Manual Capture
+
+```python
+try:
+    risky_operation()
+except Exception as e:
+    client.capture(e)
+
+# With request context
+client.capture(e, request)
+```
+
+---
+
+## What Gets Sent
+
+Example structured payload:
+
+```json
+{
+  "message": "Database connection failed",
+  "name": "ValueError",
+  "fingerprint": "a8c39c21...",
+  "timestamp": 1700000000000,
+  "service": "my-service",
+  "environment": "development",
+  "severity": "critical",
+  "errorType": "DATABASE",
+  "serviceContext": {
+    "pid": 12345,
+    "runtime": "python",
+    "runtimeVersion": "3.11.0",
+    "pythonVersion": "3.11.0",
+    "platform": "Linux-5.10.0",
+    "hostname": "server-01"
+  },
+  "requestContext": {
+    "method": "GET",
+    "url": "/api/users",
+    "ip": "10.0.0.5"
+  },
+  "occurrenceCount": 1
+}
+```
+
+---
+
+## Error Classification
+
+| Type | Example |
+|------|---------|
+| DATABASE | Timeout, SQL errors, connection issues |
+| NETWORK | HTTP failures, socket errors |
+| VALIDATION | Invalid input, type errors |
+| AUTH | Permission denied |
+| RUNTIME | Standard Python errors |
+
+---
+
+## Severity Detection
+
+- **Critical** → Database, timeout, connection errors
+- **Medium** → Validation, recoverable issues
+
+---
+
+## Design Guarantees
+
+- Non-blocking HTTP calls
+- Timeout protected (5s default)
+- Retry logic (3 attempts)
+- Deduplication (1-minute window)
+- Rate limiting (max 100 concurrent)
+- Never throws inside SDK
+- Never crashes host application
+- Works with FastAPI, Flask, Django
+
+---
+
+## License
+
+MIT

xecurecode_reliability_sdk-0.1.1/README.md

@@ -0,0 +1,221 @@
+# XecureCode Reliability SDK - Python
+
+AI-driven reliability SDK for Python applications.
+
+The official Python SDK for the XecureCode Reliability Platform — a human-first failure analysis and recovery recommendation system.
+
+---
+
+## Why This SDK Exists
+
+Modern backend systems fail in unpredictable ways.
+
+This SDK:
+
+- Captures structured runtime errors
+- Generates deterministic fingerprints
+- Classifies error types (DATABASE, NETWORK, VALIDATION, etc.)
+- Determines severity
+- Sends non-blocking telemetry to your backend
+- Never crashes your application
+
+**AI assists. Humans decide. Nothing executes automatically.**
+
+---
+
+## Requirements
+
+- Python 3.8+
+- FastAPI, Flask, or Django (optional)
+
+---
+
+## Installation
+
+```bash
+pip install xecurecode-reliability-sdk
+```
+
+Or install with framework support:
+
+```bash
+pip install xecurecode-reliability-sdk[fastapi,flask,django]
+```
+
+---
+
+## Quick Start
+
+### 1️⃣ Initialize the SDK
+
+```python
+from reliability import ReliabilityClient, ReliabilityConfig
+
+config = ReliabilityConfig(
+    api_key="your-api-key",
+    service_id="your-service",
+    mode="development"
+)
+client = ReliabilityClient(config)
+```
+
+**Configuration Options:**
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `api_key` | Yes | Your API key |
+| `service_id` | Yes | Service identifier |
+| `mode` | Yes | `development` or `production` |
+| `timeout` | No | Request timeout (default: 5000ms) |
+
+---
+
+### 2️⃣ Automatic Global Error Capture
+
+The SDK automatically handles:
+- Uncaught exceptions
+- Thread exceptions
+
+```python
+# This will be automatically captured
+raise ValueError("Database timeout")
+```
+
+---
+
+### 3️⃣ FastAPI Integration
+
+```python
+from fastapi import FastAPI
+from reliability import ReliabilityClient, ReliabilityConfig
+from reliability.fastapi_integration import FastAPIMiddleware
+
+config = ReliabilityConfig(...)
+client = ReliabilityClient(config)
+
+app = FastAPI()
+app.add_middleware(FastAPIMiddleware, client=client)
+```
+
+---
+
+### 4️⃣ Flask Integration
+
+```python
+from flask import Flask
+from reliability import ReliabilityClient, ReliabilityConfig
+from reliability.flask_integration import init_flask
+
+config = ReliabilityConfig(...)
+client = ReliabilityClient(config)
+
+app = Flask(__name__)
+init_flask(app, client)
+```
+
+---
+
+### 5️⃣ Django Integration
+
+In `settings.py`:
+
+```python
+RELIABILITY_API_KEY = "your-api-key"
+RELIABILITY_SERVICE_ID = "your-service"
+RELIABILITY_MODE = "development"
+```
+
+In `settings.py` MIDDLEWARE:
+
+```python
+MIDDLEWARE = [
+    ...
+    'reliability.django_integration.ReliabilityMiddleware',
+    ...
+]
+```
+
+---
+
+### 6️⃣ Manual Capture
+
+```python
+try:
+    risky_operation()
+except Exception as e:
+    client.capture(e)
+
+# With request context
+client.capture(e, request)
+```
+
+---
+
+## What Gets Sent
+
+Example structured payload:
+
+```json
+{
+  "message": "Database connection failed",
+  "name": "ValueError",
+  "fingerprint": "a8c39c21...",
+  "timestamp": 1700000000000,
+  "service": "my-service",
+  "environment": "development",
+  "severity": "critical",
+  "errorType": "DATABASE",
+  "serviceContext": {
+    "pid": 12345,
+    "runtime": "python",
+    "runtimeVersion": "3.11.0",
+    "pythonVersion": "3.11.0",
+    "platform": "Linux-5.10.0",
+    "hostname": "server-01"
+  },
+  "requestContext": {
+    "method": "GET",
+    "url": "/api/users",
+    "ip": "10.0.0.5"
+  },
+  "occurrenceCount": 1
+}
+```
+
+---
+
+## Error Classification
+
+| Type | Example |
+|------|---------|
+| DATABASE | Timeout, SQL errors, connection issues |
+| NETWORK | HTTP failures, socket errors |
+| VALIDATION | Invalid input, type errors |
+| AUTH | Permission denied |
+| RUNTIME | Standard Python errors |
+
+---
+
+## Severity Detection
+
+- **Critical** → Database, timeout, connection errors
+- **Medium** → Validation, recoverable issues
+
+---
+
+## Design Guarantees
+
+- Non-blocking HTTP calls
+- Timeout protected (5s default)
+- Retry logic (3 attempts)
+- Deduplication (1-minute window)
+- Rate limiting (max 100 concurrent)
+- Never throws inside SDK
+- Never crashes host application
+- Works with FastAPI, Flask, Django
+
+---
+
+## License
+
+MIT

xecurecode_reliability_sdk-0.1.1/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "xecurecode-reliability-sdk"
+version = "0.1.1"
+description = "AI-driven reliability SDK for Python applications"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "XecureCode Team", email = "team@xecurecode.in"}
+]
+requires-python = ">=3.8"
+dependencies = []
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+[project.optional-dependencies]
+fastapi = ["fastapi>=0.100"]
+flask = ["flask>=2.0"]
+django = ["django>=3.0"]
+
+[tool.setuptools.packages.find]
+where = ["src"]

xecurecode_reliability_sdk-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

xecurecode_reliability_sdk-0.1.1/src/reliability/__init__.py

@@ -0,0 +1,17 @@
+"""
+XecureCode Reliability SDK for Python
+"""
+
+from .config import ReliabilityConfig
+from .client import ReliabilityClient, init, get_client
+from .payload import create_error_payload
+
+__version__ = "0.1.1"
+
+__all__ = [
+    "ReliabilityConfig",
+    "ReliabilityClient",
+    "create_error_payload",
+    "init",
+    "get_client",
+]