# Huehue

A Rust wrapper for [Hue API v2](https://developers.meethue.com/develop/hue-api-v2/).

Note that the Hue API v2 is in early access at the time of writing, so an upgrade to it could break applications in
unpredictable way.

## Features
- Hue Bridge certificate validation.
- Bridge discovery:
  - through mDNS.
  - through [discovery.meethue.com](https://discovery.meethue.com).
  - user specified IPv4 address.
- Devices:
  - list devices.
- Light:
  - switch on/off.
  - color in the [CIE 1931 color space](https://en.wikipedia.org/wiki/CIE_1931_color_space).
  - color in the sRGB color space.
  - dimming.
- Smart plug:
  - switch on/off.
  - **note**: smart plug is exposed as a light, since it is also listed as a light by Hue. 
- XY to RGB and RGB to XY conversion.

## Examples

The [examples](https://github.com/vgobbo/huehue/tree/main/examples) folder has fully functional sample applications to 
demonstrate some implemented features. The examples aim to be trivial to understand by focusing on specific
functionality, and should be easy to copy and build your own application.

Simply use `cargo` to run the desired example:
```bash
$ cargo run --example scan

Scanning for bridges for 5 seconds.
1 bridges found.

> Bridge #1:
        Identifier: 1231231231231234
        Model: BSB002
        Version: 1948086000
        Address: 192.168.2.124
        Supported: true
```

## Code Style

Code style is enforced. It requires a nightly profile and `rustfmt` to be installed. Once they are installed, create a 
Git pre-commit hook, so you don't ever have to worry about it again.

```bash
$ ln -sr pre-commit .git/hooks/pre-commit
```