{ "info": { "author": "SoundCloud", "author_email": "api@soundcloud.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Internet", "Topic :: Multimedia :: Sound/Audio", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "=================\nsoundcloud-python\n=================\n\n.. image:: https://travis-ci.org/soundcloud/soundcloud-python.svg\n :target: https://travis-ci.org/soundcloud/soundcloud-python\n\nA friendly wrapper around the `Soundcloud API`_.\n\n.. _Soundcloud API: http://developers.soundcloud.com/\n\nInstallation\n------------\n\nTo install soundcloud-python, simply: ::\n\n pip install soundcloud\n\nOr if you're not hip to the pip: ::\n\n easy_install soundcloud\n\nBasic Use\n---------\n\nTo use soundcloud-python, you must first create a `Client` instance,\npassing at a minimum the client id you obtained when you `registered\nyour app`_: ::\n\n import soundcloud\n\n client = soundcloud.Client(client_id=YOUR_CLIENT_ID)\n\nThe client instance can then be used to fetch or modify resources: ::\n\n tracks = client.get('/tracks', limit=10)\n for track in tracks:\n print track.title\n app = client.get('/apps/124')\n print app.permalink_url\n\n.. _registered your app: http://soundcloud.com/you/apps/\n\nAuthentication\n--------------\n\nAll `OAuth2 authorization flows`_ supported by the Soundcloud API are\navailable in soundcloud-python. If you only need read-only access to\npublic resources, simply provide a client id when creating a `Client`\ninstance: ::\n\n import soundcloud\n\n client = soundcloud.Client(client_id=YOUR_CLIENT_ID)\n track = client.get('/tracks/30709985')\n print track.title\n\nIf however, you need to access private resources or modify a resource,\nyou will need to have a user delegate access to your application. To do\nthis, you can use one of the following OAuth2 authorization flows.\n\n**Authorization Code Flow**\n\nThe `Authorization Code Flow`_ involves redirecting the user to soundcloud.com\nwhere they will log in and grant access to your application: ::\n\n import soundcloud\n\n client = soundcloud.Client(\n client_id=YOUR_CLIENT_ID,\n client_secret=YOUR_CLIENT_SECRET,\n redirect_uri='http://yourapp.com/callback'\n )\n redirect(client.authorize_url())\n\nNote that `redirect_uri` must match the value you provided when you\nregistered your application. After granting access, the user will be\nredirected to this uri, at which point your application can exchange\nthe returned code for an access token: ::\n\n access_token, expires, scope, refresh_token = client.exchange_token(\n code=request.args.get('code'))\n render_text(\"Hi There, %s\" % client.get('/me').username)\n\n\n**User Credentials Flow**\n\nThe `User Credentials Flow`_ allows you to exchange a username and\npassword for an access token. Be cautious about using this flow, it's\nnot very kind to ask your users for their password, but may be\nnecessary in some use cases: ::\n\n import soundcloud\n\n client = soundcloud.Client(\n client_id=YOUR_CLIENT_ID,\n client_secret=YOUR_CLIENT_SECRET,\n username='jane@example.com',\n password='janespassword'\n )\n print client.get('/me').username\n\n.. _`OAuth2 authorization flows`: http://developers.soundcloud.com/docs/api/authentication\n.. _`Authorization Code Flow`: http://developers.soundcloud.com/docs/api/authentication#user-agent-flow\n.. _`User Credentials Flow`: http://developers.soundcloud.com/docs/api/authentication#user-credentials-flow\n\nExamples\n--------\n\nResolve a track and print its id: ::\n\n import soundcloud\n\n client = soundcloud.Client(client_id=YOUR_CLIENT_ID)\n\n track = client.get('/resolve', url='http://soundcloud.com/forss/flickermood')\n\n print track.id\n\nUpload a track: ::\n\n import soundcloud\n\n client = soundcloud.Client(access_token=\"a valid access token\")\n\n track = client.post('/tracks', track={\n 'title': 'This is a sample track',\n 'sharing': 'private',\n 'asset_data': open('mytrack.mp4', 'rb')\n })\n\n print track.title\n\nStart following a user: ::\n\n import soundcloud\n\n client = soundcloud.Client(access_token=\"a valid access token\")\n user_id_to_follow = 123\n client.put('/me/followings/%d' % user_id_to_follow)\n\nUpdate your profile description: ::\n\n import soundcloud\n\n client = soundcloud.Client(access_token=\"a valid access token\")\n client.put('/me', user={\n 'description': \"a new description\"\n })\n\nProxy Support\n-------------\n\nIf you're behind a proxy, you can specify it when creating a client: ::\n\n import soundcloud\n\n proxies = {\n 'http': 'example.com:8000'\n }\n client = soundcloud.Client(access_token=\"a valid access token\",\n proxies=proxies)\n\nThe proxies kwarg is a dictionary with protocols as keys and host:port as values.\n\nRedirects\n---------\n\nBy default, 301 or 302 redirects will be followed for idempotent methods. There are certain cases where you may want to disable this, for example: ::\n\n import soundcloud\n\n client = soundcloud.Client(access_token=\"a valid access token\")\n track = client.get('/tracks/293/stream', allow_redirects=False)\n print track.location\n\nWill print a tracks streaming URL. If ``allow_redirects`` was omitted, a binary stream would be returned instead.\n\nRunning Tests\n-------------\n\nTo run the tests, run: ::\n\n $ pip install -r requirements.txt\n $ nosetests --with-doctest\n ..................\n\nSuccess!\n\nContributing\n------------\n\nContributions are awesome. You are most welcome to `submit issues`_,\nor `fork the repository`_.\n\nsoundcloud-python is published under a `BSD License`_.\n\n.. _`submit issues`: https://github.com/soundcloud/soundcloud-python/issues\n.. _`fork the repository`: https://github.com/soundcloud/soundcloud-python\n.. _`BSD License`: https://github.com/soundcloud/soundcloud-python/blob/master/README\n", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/soundcloud/soundcloud-python", "keywords": null, "license": "BSD", "maintainer": null, "maintainer_email": null, "name": "soundcloud", "package_url": "https://pypi.org/project/soundcloud/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/soundcloud/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/soundcloud/soundcloud-python" }, "release_url": "https://pypi.org/project/soundcloud/0.5.0/", "requires_dist": null, "requires_python": null, "summary": "A friendly wrapper library for the Soundcloud API", "version": "0.5.0" }, "last_serial": 1772974, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "ac0b1ffc1eb11d675eb6a8d3ef71028a", "sha256": "11adede9dbddf77c4fb5f3de4ddecdf0e658e78c93c5dd8bcc3037a6e4303434" }, "downloads": -1, "filename": "soundcloud-0.1.tar.gz", "has_sig": false, "md5_digest": "ac0b1ffc1eb11d675eb6a8d3ef71028a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4355, "upload_time": "2012-02-11T20:43:09", "url": "https://files.pythonhosted.org/packages/31/e5/dfaf044ce2cc67baceb25951f1591664166a1cb014932ba659bcc36dc4b8/soundcloud-0.1.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "08218a952eda8e6394606b1e91edf3f0", "sha256": "22c987cac1acac70d98955991974213645fa58fc129502664a94382423e080ab" }, "downloads": -1, "filename": "soundcloud-0.2.tar.gz", "has_sig": false, "md5_digest": "08218a952eda8e6394606b1e91edf3f0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4885, "upload_time": "2012-03-02T22:27:13", "url": "https://files.pythonhosted.org/packages/91/8f/f5d0ce7e15fcc431c8385cc898bdf68212c81004c7f4ece9ab6b7a38d4f8/soundcloud-0.2.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "c6743a0db4d9032a2481dcebcb38d30b", "sha256": "de8918732727c11e8675cbd59f48e6eb8c73c99bcdc8796d506aaa90ebb1d2dc" }, "downloads": -1, "filename": "soundcloud-0.3.tar.gz", "has_sig": false, "md5_digest": "c6743a0db4d9032a2481dcebcb38d30b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4940, "upload_time": "2012-03-06T04:21:47", "url": "https://files.pythonhosted.org/packages/a8/b7/f751ea69451299c675647cc4d99d04fb399e74087d7d5d4e0cfad8bfb958/soundcloud-0.3.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "006691d57c8b749910544e91e95cea5a", "sha256": "27e2af9339706b41c752a02452b11338ab8d5e705c50d4819179df483c59ef12" }, "downloads": -1, "filename": "soundcloud-0.3.1.tar.gz", "has_sig": false, "md5_digest": "006691d57c8b749910544e91e95cea5a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4956, "upload_time": "2012-07-25T14:14:03", "url": "https://files.pythonhosted.org/packages/74/c1/e1a93d6759994a926ccf658d15ffc63e31041cf3f9146f5c711a90ececc6/soundcloud-0.3.1.tar.gz" } ], "0.3.2": [], "0.3.3": [], "0.3.4": [ { "comment_text": "", "digests": { "md5": "83d569c98f4af244e1d2c2f6c73f4a03", "sha256": "a03e33646315a1f03e92bb86c265b98c3d67b89223edc8765320a7dd50949ed0" }, "downloads": -1, "filename": "soundcloud-0.3.4.macosx-10.7-x86_64.exe", "has_sig": false, "md5_digest": "83d569c98f4af244e1d2c2f6c73f4a03", "packagetype": "bdist_wininst", "python_version": "any", "requires_python": null, "size": 69178, "upload_time": "2012-11-24T09:38:49", "url": "https://files.pythonhosted.org/packages/41/ab/896bad3293ba98d96f910e2aaf2391b5af2a9e54ed8a8451570ce1b3484d/soundcloud-0.3.4.macosx-10.7-x86_64.exe" }, { "comment_text": "", "digests": { "md5": "5e4bd5ff523196662d17cccb2a36e7b5", "sha256": "33f78f875621c67e3f88e2ead017db6115b1732e4859745e5716d24ed2ee46eb" }, "downloads": -1, "filename": "soundcloud-0.3.4.tar.gz", "has_sig": false, "md5_digest": "5e4bd5ff523196662d17cccb2a36e7b5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5824, "upload_time": "2012-11-24T09:38:47", "url": "https://files.pythonhosted.org/packages/0f/60/837f58f8ceffc603f57adf6227d05d6f4468f55c53ce805bb0a5450afbf4/soundcloud-0.3.4.tar.gz" } ], "0.3.5": [ { "comment_text": "", "digests": { "md5": "ad9e2ec9207a11932a37f519bf00b20a", "sha256": "030071918fccf962f72ad54ea21123f7f5e1fe7a652cd4c52ffbc6958dced7db" }, "downloads": -1, "filename": "soundcloud-0.3.5.tar.gz", "has_sig": false, "md5_digest": "ad9e2ec9207a11932a37f519bf00b20a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5831, "upload_time": "2012-11-30T11:28:38", "url": "https://files.pythonhosted.org/packages/9b/a5/a4f00668563c4514627f84e304bacb9066d82e97fa17ccc907ec33118bc8/soundcloud-0.3.5.tar.gz" } ], "0.3.6": [ { "comment_text": "", "digests": { "md5": "eee0e64ac1856bac26c5f5af05178b0b", "sha256": "bf303fcef42f358397b261dd2b2d7e56c6a317b433f3a13e4d8ec1ee7fa8a674" }, "downloads": -1, "filename": "soundcloud-0.3.6.tar.gz", "has_sig": false, "md5_digest": "eee0e64ac1856bac26c5f5af05178b0b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7630, "upload_time": "2013-02-14T02:08:51", "url": "https://files.pythonhosted.org/packages/d3/5a/c9a6c5143788797fede96257f3fee51ffd091c1af827406e38fe4d11145b/soundcloud-0.3.6.tar.gz" } ], "0.3.7": [ { "comment_text": "", "digests": { "md5": "21c4505c981b58c5b7d98a1594559a6a", "sha256": "03aff95bc02c8a3dd629016e294094eefa47e44e37824cc6759082d948e35336" }, "downloads": -1, "filename": "soundcloud-0.3.7.tar.gz", "has_sig": false, "md5_digest": "21c4505c981b58c5b7d98a1594559a6a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5902, "upload_time": "2013-09-19T04:18:07", "url": "https://files.pythonhosted.org/packages/35/cf/2b9960b5062df5526137cf352201b6df29dbc48896fa91a26e952ee14ae6/soundcloud-0.3.7.tar.gz" } ], "0.3.8": [ { "comment_text": "", "digests": { "md5": "e19fcd72be60069cc99417338d45e8b7", "sha256": "ec285be45817ed620aa59f9a60b1621b697a181d834f84e2a15ac04ee6b1ed63" }, "downloads": -1, "filename": "soundcloud-0.3.8.tar.gz", "has_sig": false, "md5_digest": "e19fcd72be60069cc99417338d45e8b7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5199, "upload_time": "2013-09-30T14:57:50", "url": "https://files.pythonhosted.org/packages/53/07/115cae96f5d2fd7462848e9846c9072120d79eceb1a8f67d1d23f84e49b0/soundcloud-0.3.8.tar.gz" } ], "0.3.9": [ { "comment_text": "", "digests": { "md5": "b7f521324da8ba212aa589824db44310", "sha256": "dca515e1514f375c285558238d3c2b578053e172d7790cf06068788cfe5e8e62" }, "downloads": -1, "filename": "soundcloud-0.3.9.tar.gz", "has_sig": false, "md5_digest": "b7f521324da8ba212aa589824db44310", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7003, "upload_time": "2013-10-01T18:19:54", "url": "https://files.pythonhosted.org/packages/a7/cc/f5008039d6c25365c5507d8c9fab0bf7a3f10db5feeffe202e3ce56b3ecf/soundcloud-0.3.9.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "6a9a104b6fb116c2a68bb9bd29871f00", "sha256": "76787bd5bef1854f1ebce1e2b04de7b80334145979ad3d5e91d8ba6d04c37f68" }, "downloads": -1, "filename": "soundcloud-0.4.0.tar.gz", "has_sig": false, "md5_digest": "6a9a104b6fb116c2a68bb9bd29871f00", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7016, "upload_time": "2013-10-19T17:42:03", "url": "https://files.pythonhosted.org/packages/48/57/9f6c52361943f47d566d26df5600ee5886e23ad93adfa0a9da5b53d6dee8/soundcloud-0.4.0.tar.gz" } ], "0.4.1": [ { "comment_text": "", "digests": { "md5": "e1fda76eb450fa7e33685031186be8cd", "sha256": "48245162338d8cad84dac8a83aeab88072816a6492339beec62a560a5dab3e89" }, "downloads": -1, "filename": "soundcloud-0.4.1.tar.gz", "has_sig": false, "md5_digest": "e1fda76eb450fa7e33685031186be8cd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15497, "upload_time": "2013-10-24T23:45:01", "url": "https://files.pythonhosted.org/packages/02/c7/0a0e4fc9a84c591383723f43b76078f0fea3cf9ba50a3180d1c56ccdf6c3/soundcloud-0.4.1.tar.gz" } ], "0.4.2": [ { "comment_text": "", "digests": { "md5": "b9f11c395e0deced00c4bdf4530977b0", "sha256": "ae4c683f7c1dd788435a7f81eae247dc2991ab01bda3905c11b3881e775907ee" }, "downloads": -1, "filename": "soundcloud-0.4.2-py2-none-any.whl", "has_sig": false, "md5_digest": "b9f11c395e0deced00c4bdf4530977b0", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 12441, "upload_time": "2015-10-15T12:24:35", "url": "https://files.pythonhosted.org/packages/c7/72/a593d2fb783e637a9e244940dd25f36a2e562b187c2c8b0cda89ddf236fc/soundcloud-0.4.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1c25bdad6e4e016b2c263b5aca29b2eb", "sha256": "c957bfebf8893138261c3004d953fe715a4ed2dadfec0b5e67b2a429171f7fb0" }, "downloads": -1, "filename": "soundcloud-0.4.2.tar.gz", "has_sig": false, "md5_digest": "1c25bdad6e4e016b2c263b5aca29b2eb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15591, "upload_time": "2015-10-15T12:24:28", "url": "https://files.pythonhosted.org/packages/5b/77/4b66cf1f080f05976d0bd3ef968b8cc81194e01c5ee293616503c1d1b25a/soundcloud-0.4.2.tar.gz" } ], "0.5.0": [ { "comment_text": "", "digests": { "md5": "a4e52317c37391c370e3f719d19cb96b", "sha256": "16ac26b6942b7c8ff76f32fdccefdb70c22f430e65b256c28e5b1c53ef573d1f" }, "downloads": -1, "filename": "soundcloud-0.5.0-py2-none-any.whl", "has_sig": false, "md5_digest": "a4e52317c37391c370e3f719d19cb96b", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 12596, "upload_time": "2015-10-17T12:25:19", "url": "https://files.pythonhosted.org/packages/68/f2/b6ddd262786f3a31db342ad223feebb9774e4809672106b9cfc9b4798d87/soundcloud-0.5.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "40c1d32afd019ed11ec1fbee3e84e31f", "sha256": "aad2003592cec945f835f158f7b41ba8bf805c5738a2fcc5629668ea1df653d5" }, "downloads": -1, "filename": "soundcloud-0.5.0.tar.gz", "has_sig": false, "md5_digest": "40c1d32afd019ed11ec1fbee3e84e31f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10861, "upload_time": "2015-10-17T12:25:15", "url": "https://files.pythonhosted.org/packages/17/b5/fb20e83bae6dfbebb6f36e566111d2e8eb39ad068ddb93b4f04bb42a2b57/soundcloud-0.5.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a4e52317c37391c370e3f719d19cb96b", "sha256": "16ac26b6942b7c8ff76f32fdccefdb70c22f430e65b256c28e5b1c53ef573d1f" }, "downloads": -1, "filename": "soundcloud-0.5.0-py2-none-any.whl", "has_sig": false, "md5_digest": "a4e52317c37391c370e3f719d19cb96b", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 12596, "upload_time": "2015-10-17T12:25:19", "url": "https://files.pythonhosted.org/packages/68/f2/b6ddd262786f3a31db342ad223feebb9774e4809672106b9cfc9b4798d87/soundcloud-0.5.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "40c1d32afd019ed11ec1fbee3e84e31f", "sha256": "aad2003592cec945f835f158f7b41ba8bf805c5738a2fcc5629668ea1df653d5" }, "downloads": -1, "filename": "soundcloud-0.5.0.tar.gz", "has_sig": false, "md5_digest": "40c1d32afd019ed11ec1fbee3e84e31f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10861, "upload_time": "2015-10-17T12:25:15", "url": "https://files.pythonhosted.org/packages/17/b5/fb20e83bae6dfbebb6f36e566111d2e8eb39ad068ddb93b4f04bb42a2b57/soundcloud-0.5.0.tar.gz" } ] }