Skip to main content

Bindings for the mixcloud.com API

Project description

Mixcloud.com API access from Python

Build Status Coverage Status

This provides a Python API for the http://mixcloud.com website.

Example

from mixcloud import Mixcloud
m = Mixcloud()
u = m.user('michelplatiniste')
for c in u.cloudcasts():
    print c.name

Uploading

It is possible to use this module to upload cloudcasts. In order to do that you need to be authenticated. To do that, provide an API token to the constructor.

m = mixcloud.Mixcloud(access_token=acces_token)
cc = Cloudcast(...)
with open(mp3_path) as mp3:
    r = m.upload(cc, mp3)

YML file support

It is possible to represent cloudcasts as YAML files. See example.yml.

The relevant keys are:

Key

Type

title

String

desc

String

tags

List of strings

tracks

List of tracks

Each track is a dict with the following keys:

Key

Type

start

Integer

artist

String

track

String

You can leverage YAML syntax for the “start” field: 2:54 will be parsed directly as 174 (then number of seconds).

It is possible to parse such a file with:

with open(yml_path) as yml:
    cc = mixcloud.Cloudcast.from_yml(yml, None)

Mocking

A mock server is provided for testing purposes in mixcloud.mock.

Changelog

0.0.3

release date: 2015-03-15

  • Pictures can be uploaded and retrieved (#6)

  • Include LICENSE in tarball (#8)

0.0.2

release date: 2015-01-28

  • Switch from requirements.txt to install_requires (#7)

  • Add HISTORY.rst to MANIFEST.in

0.0.1

release date: 2015-01-28

  • Initial release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mixcloud-0.0.3.tar.gz (6.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page