The official pythonic wrapper library for the Xively™ API
Python
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
examples
xively
.gitignore
.travis.yml
CONTRIBUTING.md
LICENSE.md
MANIFEST.in
NOTES.md
README.rst
README_fixture.py
fixtures.py
requirements.txt
setup.cfg
setup.py
tests.py
tox.ini

README.rst

Warning

This library is for an older, deprecated version of Xively. For the current version of Xively, please refere to www.xively.com

xively-python

Build Status

This is the official pythonic wrapper library for the Xively V2 API.

Requirements

  • Python 2.7, 3.3 or PyPy
  • Requests 1.1.0 (or greater)

Create a Feed

>>> import xively
>>> # Connect to the API using your API key.
>>> api = xively.XivelyAPIClient("API_KEY")
>>> # Create a new Feed object.
>>> feed = api.feeds.create(title="My Xively Feed")
>>> # Let's give it one datastream with id 'temperature'
>>> datastream = feed.datastreams.create(id='temperature')

Create a Datapoint

The datapoint creation endpoint takes an array of datapoints

>>> datastream.datapoints.create(value=42)  # doctest: +ELLIPSIS
xively.Datapoint(datetime.datetime(...), 42)

Alternatively you can update the datastream's current value and a new datapoint will be created.

>>> datastream.current_value = 42
>>> # We only want to change current_value.
>>> datastream.update(fields=['current_value'])

Without specifying the fields to update, all fields would be sent to the Xively API which would include the updated_at field with the time that the old value was updated. This is probably not what you want but is the intended behaviour of the API.

githalytics.com