flow-it-api 0.0.1.0b4__py3-none-any.whl

flow_it_api-0.0.1.0b4.dist-info/METADATA

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: flow-it-api
+Version: 0.0.1.0b4
+Summary: Python API library client for the FlowIt VMC machine
+Author-email: Alberto Geniola <albertogeniola@gmail.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: black>=24.0.0; extra == 'dev'
+Requires-Dist: hatch-vcs; extra == 'dev'
+Requires-Dist: isort>=5.13.0; extra == 'dev'
+Requires-Dist: mkdocs; extra == 'dev'
+Requires-Dist: mkdocs-material; extra == 'dev'
+Requires-Dist: mkdocstrings[python]; extra == 'dev'
+Requires-Dist: mypy>=1.9.0; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# FLOW-IT-API
+
+A Python API library client for FlowIt VMC (Ventilazione Meccanica Controllata) machines.
+
+This library provides a simple, asynchronous interface to interact with FlowIt VMC devices over a local network, supporting both REST API for commands/status and WebSockets for real-time updates.
+
+## Context
+
+FlowIt VMC devices use two fans to control airflow (Inflow and Outflow) and are equipped with multiple sensors (Temperature, Humidity, Pressure, IAQ). While these devices connect to FlowIt cloud services, they also expose a local LAN API for direct control.
+
+## Installation
+
+### Prerequisites
+- Python 3.11 or higher
+
+### Setup Virtual Environment
+```bash
+python -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+pip install -e .
+```
+
+For development:
+```bash
+pip install -e .[dev]
+# Install pre-commit hooks
+pre-commit install
+```
+
+## Usage
+
+The library uses `httpx` for asynchronous HTTP requests and `websockets` for real-time updates.
+
+### Basic Example
+
+```python
+import asyncio
+import logging
+from flow_it_api.client import FlowItVMCMachine
+from flow_it_api.const import Speed
+
+# Setup logging to see the library version and actions
+logging.basicConfig(level=logging.INFO)
+
+async def main():
+    host = "http://192.168.1.50"
+    # You can retrieve your API password from the device's menu using the on-board display
+    password = "your_api_password"
+
+    async with FlowItVMCMachine(host, password) as vmc:
+        # Get device info (Model, FW version, etc.)
+        info = await vmc.get_info()
+        print(f"Device: {info.model}, FW: {info.fw_ver}")
+
+        # Fetch initial state
+        state = await vmc.refresh_state()
+        print(f"Current Speed: {state.mode.speed}")
+        print(f"Temperature: {state.mode.temperatureIn_celsius}°C")
+
+        # Send a command
+        await vmc.send_command(Speed.LEVEL_3, flow_in=True, flow_out=True)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### Real-time Updates (WebSocket)
+
+The library can listen for real-time updates pushed by the device:
+
+```python
+async def on_data(data):
+    print(f"Update received! New IAQ: {data.mode.iaq}")
+
+# Initialize machine and websocket
+async with FlowItVMCMachine(host, password) as vmc:
+    vmc.websocket._on_data = on_data
+    vmc.websocket.start()
+    # Keep the loop running to receive events
+    await asyncio.sleep(60)
+```
+
+## Library Architecture
+
+### Key Components
+
+- **`FlowItVMCMachine`**: The primary entry point. Manages authentication, connection state, and coordination between REST and WebSocket clients.
+- **`Authenticator`**: Handles JWT token acquisition and automatic renewal.
+- **`FlowItWebSocket`**: Manages the persistent WebSocket connection and reconnection logic.
+- **`Models`**: Pydantic models providing type-safe access to machine data, including automatic Kelvin-to-Celsius conversions.
+
+### Features
+- **Asynchronous**: Built on `asyncio`.
+- **Automatic Auth**: Handles login and token refreshing transparently via decorators.
+- **Type Safety**: Full Pydantic v2 model support.
+- **Temperature Conversion**: Access temperatures in both Kelvin (raw) and Celsius (processed).
+- **Comprehensive Logging**: Detailed internal logging for debugging, including version tracking at load time.
+- **Dynamic Versioning**: Versioning is automatically managed via Git tags (VCS).
+
+## Development
+
+The project structure:
+- `src/flow_it_api/`: Library source code (src layout).
+- `tests/`: Unit tests (using `pytest`).
+- `specs/`: OpenAPI/YAML specifications for the device API.
+- `example.py`: A comprehensive CLI test client.
+
+### Quality Control
+This project uses several tools to ensure code quality:
+- **Linting & Formatting**: `black`, `isort`, and `mypy` for type checking.
+- **Git Hooks**: `pre-commit` is used to run all checks locally before every commit.
+- **CI/CD**: GitHub Actions runs the full test suite across multiple Python versions and handles automated releases to PyPI.
+
+To run tests locally:
+```bash
+pytest --cov=src --cov-report=term-missing
+```

flow_it_api-0.0.1.0b4.dist-info/RECORD

@@ -0,0 +1,11 @@
+flow_it_api/__init__.py,sha256=PeKhUR0BSOA4B5VVQ6O-RCdW8E4shpHHYsBCnzZgmag,369
+flow_it_api/auth.py,sha256=U7kTajeD-alzcUmh5rYIGffi3JEbqD8PwabbsL5suOE,2965
+flow_it_api/client.py,sha256=OYF5YfRpCua0aXl9hprlTMiu3VckTDnPZT0-1QWFEZ0,7475
+flow_it_api/const.py,sha256=A1ywNBayJVjgzWdY-282ef8ARPpnTL8kObkFCvfyWIQ,769
+flow_it_api/exceptions.py,sha256=LEgS4ambYIsxVbLfPMsXRMhrjhmYA82pV0qZ3fln5YQ,508
+flow_it_api/models.py,sha256=7gC7n5PExwmrQoVVNqY2ZEoTyG-3puIwz9VtDAYB_fk,4422
+flow_it_api/websocket.py,sha256=1StgbIhEs8azSe4Is2IpQ0OOe_mrPQ-rsHHeXpdqY2A,3188
+flow_it_api-0.0.1.0b4.dist-info/METADATA,sha256=Jp2I4EwUoNPBQ13rZp7hFnWaaZS7Qmu70v9K5swuFoQ,4978
+flow_it_api-0.0.1.0b4.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+flow_it_api-0.0.1.0b4.dist-info/licenses/LICENSE,sha256=-BeIbua7Ze0wmKeYex6XgWU9FccfhVic4NKvZjxm03M,34888
+flow_it_api-0.0.1.0b4.dist-info/RECORD,,

flow_it_api-0.0.1.0b4.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any