feat(sdk): refactor Python SDK documentation

- Standardize Python SDK (`datastack`) documentation with a new multi-file suite.
- Update `datastack-sdk` to serve as a backward-compatible shim for the canonical `datastack` package.
- Update project manifest and memory map to reflect current SDK structure and v2.2.0 features.
This commit is contained in:
Team Dark Devil committed 2026-11-18 10:03:40 +06:00
1 parent 4279da45bb
commit 40a6855724
38 files changed
+3315 -141

No files matched your search

+15 -6
View File
@@ -1,10 +1,19 @@
# Python SDK Manifest
# Python SDK Manifest (`datastack-sdk`)
## Purpose
Pip-installable Python client SDK (`datastack-sdk`) enabling Python services, IoT telemetry agents, and analytics applications to stream structured real-time events to DataStack.
Pip-installable Python client SDK compatibility alias (`datastack-sdk`), providing full backward compatibility for applications importing from `datastack_sdk` while sharing a single source of truth with the canonical `datastack` package (`sdk/python/datastack/`).
## Contents
- `setup.py`: Package metadata and dependencies (`python-socketio[client]`, `requests`).
- `datastack_sdk/__init__.py`: Exports `DataStackClient`.
- `datastack_sdk/client.py`: `DataStackClient` implementation featuring JWT handshake authentication, automatic reconnection, and thread-safe acknowledgment waiting (`threading.Event`) for `sync()` and `batch_sync()`.
- `README.md`: Installation instructions, quickstart example, and API reference.
- `setup.py`: Package distribution metadata and dependencies (`python-socketio[client]`, `requests`, `websocket-client`).
- `datastack_sdk/`:
- `__init__.py`: Package entry point re-exporting all canonical symbols (`DataStack`, `DataStackClient`, `DataStackConfig`, exceptions, `HeartbeatMonitor`, `DiskSpooler`).
- `client.py`: Re-export shim for `DataStack` / `DataStackClient`.
- `config.py`: Re-export shim for `load_config` and `DataStackConfig`.
- `exceptions.py`: Re-export shim for the full exception hierarchy.
- `heartbeat.py`: Re-export shim for `ConnectionState` and `HeartbeatMonitor`.
- `spool.py`: Re-export shim for `DiskSpooler`.
- `README.md`: Installation instructions, quickstart guide, API reference, and cross-references to the canonical documentation suite.
## Canonical Documentation
Full technical documentation (API reference, configuration, examples, error handling, and lifecycle) is maintained at:
`sdk/python/datastack/docs/`