Metadata-Version: 1.0
Name: timetric
Version: 1.2
Summary: Client library for Timetric (http://timetric.com/)
Home-page: http://github.com/jacobian/timetric
Author: Jacob Kaplan-Moss
Author-email: jacob@jaobian.org
License: UNKNOWN
Description: Python Timetric client
        ======================
        
        A client for Timetric (http://timetric.com/).
        
        Requirements (easy-installable, listed as prereqs in setup.py):
        
        * httplib2
        * python-dateutil
        * oauth
        * simplejson
        
        Usage::
        
        >>> 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
        >>> webbrowser.open(client.get_authorize_url())
        
        # 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()
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet
