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.7.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | dac8e7853ac3e561a91fe9c23ed2f63d80fc59d5bfc33e186b0f4ac726ed7715 |
|
MD5 | 888b1ec03b0f8db6fd9da3e51d71dac1 |
|
BLAKE2b-256 | 84b03a90966dcacd0465e3a1d474c31b6b7346e26e2bf591bc416c7cf3708131 |