Disruptive Technologies Python API.
Project description
Disruptive Technologies Python Client
Documentation
Installation
The package can be installed through pip:
pip install --upgrade disruptive
or from source:
pip install .
Requirements
- Python 3.7+
Authentication
Using Service Account credentials, setting disruptive.default_auth
authenticates the package:
import disruptive as dt
# Using Service Account credentials, authenticate the package.
dt.default_auth = dt.Auth.service_account(key_id, secret, email)
Usage
Assuming you have authenticated correctly, most functionality is accessed through methods grouped under various Resources on the form disruptive.<Resource>.<method>()
.
import disruptive as dt
# Fetch a specific sensor from a project.
sensor = dt.Device.get_device(device_id)
# Print the sensor information wil list all attributes and values.
print(sensor)
# Set a new label on the sensor.
dt.Device.set_label(sensor.device_id, sensor.project_id, key='nb', value='99')
# Get touch- and temperature event history for the sensor.
history = dt.EventHistory.list_events(
sensor.device_id,
sensor.project_id,
event_types=['touch', 'temperature']
)
# Set up a real-time event stream of all device in project.
for event in dt.Stream.event_stream(sensor.project_id):
# Print the data in new events as they arrive.
print(event.data)
Logging
The simplest method is enabled by setting disruptive.log_level
with a string level.
dt.log_level = 'info'
If more fine-grained control is desired, the standard library logging
module can also be used.
logging.basicConfig(
filename='example.log',
format='[%(asctime)s.%(msecs)03d] %(levelname)-8s - %(message)s',
datefmt='%Y-%m-%d %H:%M:%S',
)
logging.getLogger('disruptive').setLevel(logging.INFO)
For both methods, the standard levels debug
, info
, warning
, error
, and critical
are available.
Examples
A few examples has been provided. Before running, the required environment variables listed at the start of each example must be set.
python examples/example_name.py
Exceptions
If a request is unsuccessful or has been provided with invalid parameters, an exception is raised. A list of available exceptions are available in the API Reference.
Development
Set up the development virtualenv environment:
make
Run unit-tests against the currently active python version:
make test
Lint the package code using MyPy and flake8:
make lint
Build the package distribution:
make build
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for disruptive-0.5.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5d99e8b56bfe516cae3f0e2647a30f8f0f07f325999ed2ba4fb279e5835fbd44 |
|
MD5 | 7cd3d8a47bdf507d3351e0c178ca17ee |
|
BLAKE2b-256 | 573911d5316356bdaaa89cb093c6dd000aae556318d28636002bc23edf55bc35 |