20 Jan 2013
New versions of the code are be published for download at PyPI - the Python Package Index periodically.
You can also get the latest development version of the code by cloning the Git repository for the project by running:
git clone git://github.com/aouyar/healthgraph-api
The code can be downloaded and installed automatically using pip:
pip install healthgraph-api
pip install git+https://github.com/aouyar/healthgraph-api.git#egg=healthgraph-api
The other option is to download and uncompress the code manually and execute the included setup.py script to start installation:
The Health Graph API uses OAuth 2.0 for security. Every application must be registered with the Applications Portal of Health Graph. Once registered, the application will be assigned a unique Client Identifier and the Client Secret for use with the Health Graph API.
The distribution includes a sample basic web application based on the Bottle Micro Web Framework for demonstrating how to use the library.
Installation and Configuration of the Sample Application
You can find the sample application in the following folder of the healthgraph-api distribution: ./samples/bottle.
Before running the sample application the prerequisite packages listed in requirements.txt must be installed. The prerequisite packages can easily installed using pip:
pip install -r requirements.txt
Note: The sample application requires fairly updated versions of the prerequisite packages. Using virtualenv is highly recommended for installing the application in a sandboxed environment with the latest versions of the packages.
The Client Identifier and the Client Secret must be placed in the configuration file for the sample application: runkeeper_demo.conf
The application can be run by executing:
python runkeeper_demo.py -c runkeeper_demo.conf
The web interface could be reached at localhost port 8000 by default: http://127.0.0.1:8000
Retrieval of the Access Token
Sending the Access Token to the client to be displayed in a web browser is a security risk. This page is provided just for testing. Normally, the _Access Token_ must never be sent to the client.
healthgraph-api is copyrighted free software made available under the terms of the GPL License Version 3 or later.
See the file COPYING that acompanies the code for full licensing information.