Metadata-Version: 2.4
Name: shadowob-sdk
Version: 0.2.3
Summary: Shadow SDK — Python client for Shadow server REST API and Socket.IO real-time events
License-Expression: MIT
Requires-Python: >=3.10
Requires-Dist: httpx<1,>=0.27
Requires-Dist: python-socketio[client]<6,>=5.11
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Description-Content-Type: text/markdown

# Shadow Python SDK

Python client for the Shadow server REST API and Socket.IO real-time events.

## Installation

```bash
pip install shadowob-sdk
```

## Quick Start

```python
from shadowob_sdk import ShadowClient, ShadowSocket

# REST API
client = ShadowClient("https://shadowob.com", token="your-jwt-token")
me = client.get_me()
print(f"Logged in as {me['username']}")

# Send a message
msg = client.send_message("channel-id", "Hello from Python!")
print(f"Sent message: {msg['id']}")

# Real-time events
socket = ShadowSocket("https://shadowob.com", token="your-jwt-token")
socket.on("message:new", lambda msg: print(f"New message: {msg['content']}"))
socket.connect()
socket.join_channel("channel-id")
socket.wait()  # Block until disconnected
```

## API Reference

See the [full documentation](https://shadow-docs.example.com) for complete API reference.
