Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Unofficial API for Brunt

Project description

Brunt

Unofficial python SDK for Brunt, based on the npm version here https://github.com/MattJeanes/brunt-api

This package allows you to control your Brunt devices from code.

Sample script

This script shows the usage and how to use the output of the calls, off course if you already know the name of your device you do not need to call getThings.

This script checks the current position of a blind called 'Blind' and if that is 100 (fully open), sets it to 90 and vice versa.

from brunt.brunt import BruntAPI

bapi = BruntAPI()
print("Calling Brunt")

bapi.login('username', 'password')
print("    Logged in, gettings things.")

things = bapi.getThings()['things']
print(f"    { len(things) } thing(s) found.")

state = bapi.getState(thing='Blind')['thing']
print(f"    Current status of { state['NAME'] } is position { state['currentPosition'] }")
newPos = 100
if int(state['currentPosition']) == 100:
    newPos = 90
print(f"    Setting { state['NAME'] } to position { newPos }")

res = bapi.changePosition(thing='Blind', newPos)
print('    Success!' if res else '    Fail!')

BruntAPI

BruntAPI()

login

BruntAPI.login(self, username, password)

Login method using username and password

:param username: the username of your Brunt account :param password: the password of your Brunt account

:return: True if successfull :raises: errors from Requests call

getThings

BruntAPI.getThings(self)

Get the things registered in your account

:return: dict with things registered in the logged in account and API call status :raises: errors from Requests call

getState

BruntAPI.getState(self, **kwargs)

Get the state of a thing

:param thing: a string with the name of the thing, which is then checked using getThings. :param thingUri: Uri (string) of the thing you are getting the state from, not checked against getThings.

:return: a dict with the state of the Thing. :raises: ValueError if the requested thing does not exists. NameError if not logged in. SyntaxError when not exactly one of the params is given.

changePosition

BruntAPI.changePosition(self, position, **kwargs)

Changes the position of the thing.

:param position: The new position for the slide (0-100) :param thing: a string with the name of the thing, which is then checked using getThings. :param thingUri: Uri (string) of the thing you are getting the state from, not checked against getThings.

:return: a dict with the state of the Thing. :raises: ValueError if the requested thing does not exists or the position is not between 0 and 100. NameError if not logged in. SyntaxError when not exactly one of the params is given.

Project details


Release history Release notifications

This version
History Node

0.1.1

History Node

0.1

History Node

0.0.4

History Node

0.0.3

History Node

0.0.2

History Node

0.0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
brunt-0.1.1-py3-none-any.whl (4.7 kB) Copy SHA256 hash SHA256 Wheel py3 Jun 12, 2018
brunt-0.1.1.tar.gz (4.2 kB) Copy SHA256 hash SHA256 Source None Jun 12, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page