Metadata-Version: 2.4
Name: heiman-connect
Version: 1.0.10
Summary: Python library for Heiman smart home devices
Author-email: Heiman Team <support@heiman.com>
License: MIT
Project-URL: Homepage, https://github.com/yourusername/heiman-connect
Project-URL: Bug Tracker, https://github.com/yourusername/heiman-connect/issues
Project-URL: Documentation, https://github.com/yourusername/heiman-connect/blob/main/README.md
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
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 :: Home Automation
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: aiomqtt>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: black>=22.0; extra == "dev"
Requires-Dist: ruff>=0.0.200; extra == "dev"
Requires-Dist: mypy>=0.950; extra == "dev"

# Heiman Connect Library

Python library for communicating with Heiman smart home devices.

## Installation

```bash
pip install heiman-connect
```

## Usage

```python
import asyncio
from heimanconnect import HeimanHttpClient, HeimanCloudClient

async def main():
    # Initialize HTTP client with access token
    http_client = HeimanHttpClient(
        api_url="https://api.heiman.cn",
        access_token="your_access_token",
    )
    
    # Create cloud client
    cloud_client = HeimanCloudClient(http_client)
    
    # Get homes
    homes = await cloud_client.async_get_homes()
    
    # Get devices
    devices = await cloud_client.async_get_devices(home_id=homes[0].home_id)
    
    # Control device
    await cloud_client.async_control_device(
        device_id=device_id,
        property_identifier="Switch",
        value=True,
    )

asyncio.run(main())
```

## Features

- HTTP API client
- MQTT real-time communication
- Device management
- Property control
- Simplified authentication (bring your own token)

## License

MIT License
