Metadata-Version: 2.1
Name: pyblueiris
Version: 0.2.9
Summary: An async python api for Blue Iris
Home-page: https://github.com/nwesterhausen/pyblueiris
Author: Nicholas Westerhausen
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.5.3
Description-Content-Type: text/markdown
Requires-Dist: aiohttp


# README

## Blue Iris Python Library

An async python library for the Blue Iris JSON API.

## Overview
For more in-depth documentation, visit [the documentation]().

Creating a BlueIris object requires you provide an async web session for it.

```python
import pyblueiris
from aiohttp import ClientSession

PROTOCOL = 'http'
HOST = 192.168.1.5
USER = 'pyserv'
PASS = 'secret-password'

def main():  
  async with ClientSession(raise_for_status=True) as sess:
    blue = pyblueiris.BlueIris(sess, USER, PASS, PROTOCOL, HOST)

if __name__ == '__main__':
  main()
```

From there you can simply call a command you want it to execute. There is a command `update_all_information()` which will call all data-gathering commands to fill out information about the server.

```python
def main():  
  async with ClientSession(raise_for_status=True) as sess:
    blue = pyblueiris.BlueIris(sess, USER, PASS, PROTOCOL, HOST)
    await blue.update_all_information()
```

All of the information the BlueIris object knows about the server is stored in the attributes property \(dictionary\).

```python
print(blue.attributes)
```



