Module bundle

source code

A bundle is a collection of objects implementing the _getUri_ method, returning a URI which is supposed to uniquely identify the corresponding instance.

A bundle is homogeneous to both a list and a dictionary: every element of the list is also indexed by its URI. Hence the 'bundle[index]' notation can be used with integers or strings.

Since bundle may list/dict views of complex underlying data, many operations which are usual with simple python lists, are just meaningless for bundles.

Permitted list operations are

• len(b)
• b.append
• b.insert
• b.pop
• b.remove
• b[x]
• b[x:y]
• del b[x]
• del b[x:y]
• v in b
• b1 + b2

Permitted dict operations are

• b.clear
• b.get
• b.has_key
• b.items
• b.iteritems
• b.iterkeys
• b.itervalues
• b.keys
• b.popitem
• values
• k in b
• b[k]

Note also that iter(b) iterates over its values (as for lists). Iterating over keys required the _iterkeys_ method.