Files
DataStack/sdk/python/datastack/config.datastack.example.py
Team Dark Devil 0c2e49cd47 feat: refactor Python SDK and enhance API error reporting
- Relocated Python SDK to `sdk/python/datastack` with new auto-configuration support via `config.datastack.py`
- Updated SDK installation and usage documentation
- Enhanced `/api/events` response format to include specific error codes for revoked and rotated credentials
- Updated SDK dashboard snippet generator to support new configuration pattern
2026-11-18 02:23:01 +06:00

52 lines
1.8 KiB
Python

"""
config.datastack.py — Official DataStack Python SDK Configuration File
======================================================================
Place a copy of this file named `config.datastack.py` in the root directory
of your Python application. When you initialize `DataStack()`, the SDK will
automatically discover and load these settings.
"""
DATASTACK_CONFIG = {
# Port 4000 Dedicated Socket.IO Ingestion Service URL
"SERVER_URL": "http://localhost:4000",
# Port 3000 Next.js Web & HTTP Fallback Ingestion API URL
"API_URL": "http://localhost:3000",
# Client JWT Token generated from the DataStack Admin Console (/vcon/clients)
"CLIENT_TOKEN": "REPLACE_WITH_YOUR_CLIENT_JWT_TOKEN",
# Optional explicit client identifier override (defaults to JWT sub/clientId)
"CLIENT_ID": "",
# Automatically connect on DataStack() instantiation
"AUTO_CONNECT": True,
# Automatically switch to HTTP POST /api/events when WebSocket disconnects
"ENABLE_HTTP_FALLBACK": True,
# Heartbeat interval (in seconds) when probing to repair WebSocket or recover from offline state
"HEARTBEAT_INTERVAL_SEC": 5.0,
# Socket & HTTP request timeout in seconds
"REQUEST_TIMEOUT_SEC": 8.0,
# Maximum retry attempts on transient network errors or 429 RATE_LIMIT_EXCEEDED
"MAX_RETRIES": 3,
# Base delay (in seconds) for exponential backoff with jitter
"RETRY_BACKOFF_BASE_SEC": 0.5,
# Default records per batch when streaming .csv / .json / .jsonl files via send_file()
"BATCH_CHUNK_SIZE": 250,
# Offline Disk Spooling: safely persist events to disk when device is completely offline
"OFFLINE_SPOOL_ENABLED": True,
# Local directory path for offline event spooling
"OFFLINE_SPOOL_DIR": ".datastack_spool",
# Maximum disk spool file size in megabytes (MB)
"MAX_SPOOL_SIZE_MB": 50,
}