Metadata-Version: 2.1
Name: hoom
Version: 0.1.3
Summary: Build your own HomeKit Bridge & Accessories with Hoom
Home-page: https://github.com/berrysauce/hoom
License: GPL-3.0-only
Author: Paul Haedrich
Author-email: hey@foerstal.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Home Automation
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Dist: base36 (>=0.1.1,<0.2.0)
Requires-Dist: colorama (>=0.4.6,<0.5.0)
Requires-Dist: fastapi (>=0.100.0,<0.101.0)
Requires-Dist: hap-python (>=4.7.0,<5.0.0)
Requires-Dist: jinja2 (>=3.1.2,<4.0.0)
Requires-Dist: pyqrcode (>=1.2.1,<2.0.0)
Requires-Dist: uvicorn (>=0.23.1,<0.24.0)
Project-URL: Documentation, https://github.com/berrysauce/hoom
Project-URL: Repository, https://github.com/berrysauce/hoom
Description-Content-Type: text/markdown

<h1 align="center">🏡 Hoom</h1>
<p align="center">Build your own HomeKit Bridge & Accessories with Hoom</p>

### ✨ Features
- [x] HomeKit Bridge
- [x] Minimalist Web UI
- [x] Create custom HomeKit Accessories with function decorators
- [x] Customizable
- [x] Easy to use

### 📦 Installation
You can easily install Hoom using pip:

```bash
pip install hoom
```

> **Note**: Hoom requires Python 3.8 or higher

### How to use
Here's a demo script which shows how easy Hoom is to use:

```python
from hoom import Hoom
from hoom.accessory_types import Lightbulb

hoom = Hoom(name="Hoom Bridge")

@hoom.accessory("Lamp", Lightbulb)
def lamp(response: Lightbulb.Response):
    if response.state:
        print("Lamp is now on")
    else:
        print("Lamp is now off")
        
    return

hoom.run()
```

As you can see, Hoom is very similar to frameworks like FastAPI. No need for complicated classes with lots of methods. Just use the `@hoom.accessory` decorator and you're good to go.

### 📣 Credits
A special thanks goes out to these Python packages/frameworks and their authors:

- [HAP-python](https://github.com/ikalchev/HAP-python) - Hoom wouldn't be possible without this HomeKit Accessory Protocol implementation by [Ivan Kalchev](https://github.com/ikalchev)
- [FastAPI](https://github.com/tiangolo/fastapi) - Hoom uses FastAPI by [Sebastián Ramírez](https://github.com/tiangolo) for its web server & UI and is heavily inspired by it
