Skip to main content

A python wrapper for Global Sensor Networks API

Project description

===============================
Python wrapper for the Global Sensor Networks API
===============================

.. contents:: **Table of Contents**

-------------------------
Installation
-------------------------

> pip install gsn

-------------------------
Usage
-------------------------

The wrapper uses the `sanction`_ Oauth2 library to authenticate against GSN services.
Before starting you must create a "client" on GSN services and get the client_id, client_secret and redirect_uri.
As we will be using client_credentials, the client must be linked to the user from which it will inherit the access rights.
The value of redirect uri is not used, but must nevertheless match.

Then in your python code, you can use it this way::

> import gsn
> a = gsn.API(service_url="http://localhost:9000/ws", client_id="client", client_secret="secret", redirect_uri="http://localhost")
> s = a.get_latest_values("push")
> s.values = [[1469959498000, 18]]
> r = a.push_values(s)

.. _sanction: https://github.com/demianbrecht/sanction

Sensor object
===============================

This object abstract the json representation used by GSN for the stream elements. It has the following fields:

* fields: list of triples representing the name, type and units
* name: name of the sensor
* values: list of lists. The inner lists must have the same size as the fields list and represent the data of a stream element.
* location: (optional) a triple representing the location of the sensor as latitude, longitude, altitude.
=======
CHANGES
=======

v0.2.0
-------

* adding refresh token support
* automatically tracking the expiration of access token and refreshing if necessary


v0.1.0
-------

* initial release
* supports querying the latest values and pushing data
* compatible with GSN v2.0.0



Project details


Download files

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

Source Distribution

gsn-0.2.0.tar.gz (4.7 kB view hashes)

Uploaded Source

Built Distribution

gsn-0.2.0-py2.py3-none-any.whl (5.9 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page