mixcloud 0.0.1

Bindings for the mixcloud.com API

Mixcloud.com API access from Python

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.1

release date: 2015-01-28

• Initial release