The SoundCloud API comes with a small testsuite. It can be run automatically through either setuptools or nose.
Before you can run the tests, you need to configure them. You do this using the
test.ini file in the
root of your working copy. Create a test app at http://soundcloud.com/you/apps/new and enter the appropriate credentials
You will then need to obtain an access token for the tests to run with. Run
and follow the instructions. Your browser bring you to the SoundCloud "connect" page. Connect with your app, and
your browser will be redirected to an URL with a query parameter called "code". Copy and paste this value to the
bootstrap_tests.py prompt, wait a moment, and check that the script finishes with a access_token=... line.
Copy and paste this line into your
Now you can run the tests!
You can run the whole testsuite through setuptools_ by doing ::
$ python setup.py test
If you want a more fine-grained control over which tests to run, you can use the
Then to run individual tests, you can e.g. do::
$ nosetests -s soundcloud.tests.soundcloud_tests:SoundcloudTests.test_setting_permissions
See the nose_-website for more options.
.. _nose: http://somethingaboutorange.com/mrl/projects/nose/ .. _setuptools: http://peak.telecommunity.com/DevCenter/setuptools .. _ConfigObj: http://www.voidspace.org.uk/python/configobj.html
Do:: epydoc -v --name="SoundCloud API" --html -o docs/api soundcloud --exclude="os|mimetypes|urllib2|exceptions|mimetools"