Skip to main content

Client library for Timetric (

Project description

A client for Timetric (

Requirements (easy-installable, listed as prereqs in

  • httplib2
  • python-dateutil
  • oauth
  • simplejson


>>> import timetric

# You need a config dict with at minimum your secret and key from Timetric
# (see the "Applications" pane of the settings page). In a real app you'll
# want to make this config persistant (the shelve module is a lightweight
# place to start) because the library will store OAuth authentication
# information back to this config.
>>> conf = {'consumer_secret': 'XXX', 'consumer_key': 'XXX'}
>>> client = timetric.TimetricClient(conf)

# The first time through you'll need to authorize your key with Timetric
# by sending the user to an authorization request page.
>>> import webbrowser

# Once the user has authorized at that page, you can continue.
>>> client.get_access_token()

# Now you're authorized and can read and write the user's series.
# It appears there's no API method to get a list of a particular
# user's series, so you need to somehow "know" the series ID.
>>> series = client.series('p-DpewL0TO-iBE4nMBCTsQ')

# Get the latest value
>>> series.latest()
(1236707269.0, 2.0)

# Iterate over the whole dataset
>>> for (timestamp, value) in series:
...     print timestamp, value
1236463646.39 3.0
1236486562.94 5.0
1236493503.37 6.0

# Update given a single value
>>> series.update(14)

# Update given an iterable of (time, value) pairs
>>> import time
>>> data = [(time.time() - 100, 11), (time.time() + 100, 15)]
>>> series.update(data)

# Update given a file of CSV data
>>> series.update(open('/tmp/data.csv'))

# Clear all the data out of the series
>>> series.delete()

Project details

Download files

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

Files for timetric, version 1.2
Filename, size File type Python version Upload date Hashes
Filename, size timetric-1.2.tar.gz (6.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page