REQUIREMENTS
------------

- Python with JSON support. Python 2.6+ has it built in, Python 2.5 and under
  need 'simplejson' module.  You can install simplejson with command:
  'easy_install simplejson'.

- 'nose' test runner.  http://somethingaboutorange.com/mrl/projects/nose/.

- 'nose-testconfig' plugin.  To install nose-testconfig, run command:
  'easy_install nose-testconfig'.

TEST CONFIGURATION
------------------

Test configuration for things like which host to point at, usernames,
passwords, etc - are all stored in Python ConfigParser files (INI-style
format).

Provided along with the tests are configs to run against:

- https://snaptic.com (config.ini)

You specify the configuration file to use via the '--tc-file' option.
You also need to add username/password/email of the account you want to test
against to config.ini.

HOW TO RUN THE TESTS
--------------------

To start the tests, type 'nosetests --tc-file=<CONFIG FILE>' in the same
directory as the test source files.  More verbose output can be seen by passing
the -v flag: 'nosetests -v --tc-file=<CONFIG FILE>'.

E.g. to run the tests against https://api.snaptic.com you would execute:

$ nosetests -v --tc-file=config.ini