coherence.backends.swr3_storage (module)

class Item(parent, id, title, url)

Bases: coherence.backend.BackendItem

get_item()

Called by the CDS and the MediaServer web.

Returns

• an UPnP ContentDirectoryServer DIDLLite object

• or a Deferred

class Container(id, store, parent_id, title)

Bases: coherence.backend.BackendItem

add_child(child)

get_children(start=0, end=0)

Called by the CDS and the MediaServer web.

Parameters

• start (int) – the start.

• end (int) – the end.

Returns

• a list of its childs, from start to end.

• or a Deferred

get_child_count()

Called by the CDS.

Returns

• the number of its childs - len(childs)

• or a Deferred

get_path()

Called by the MediaServer web.

Returns

the filepath where to find the media file that this item does refer to.

get_item()

Called by the CDS and the MediaServer web.

Returns

• an UPnP ContentDirectoryServer DIDLLite object

• or a Deferred

get_name()

Called by the MediaServer web.

Returns

the name of the item, it is always expected to be in unicode.

get_id()

class SWR3Store(server, *args, **kwargs)

Bases: coherence.backend.BackendStore, coherence.backend.BackendRssMixin

implements = ['MediaServer']

parse_opml()

get_next_id()

get_by_id(id)

Parameters

id (object) – is the id property of our DIDLLite item

Returns

• None when no matching item for that id is found,

• a BackendItem,

• or a Deferred

Called by the CDS or the MediaServer web.

Note

if this MediaServer implements containers that can share their content, like ‘all tracks’, ‘album’ and ‘album_of_artist’ (they all have the same track item as content), then the id may be passed by the CDS like this:

‘id@container’ or ‘id@container@container@container…’

therefore a

if isinstance(id, basestring):
    id = id.split('@',1)
    id = id[0]

may be appropriate as the first thing to do when entering this method.

upnp_init()

This method gets called after the device is fired, here all initializations of service related state variables should happen, as the services aren’t available before that point.

parse_data(xml_data, container)

Extract media info and create BackendItems