🔌 Collections

🔌 Collections#

It defines some protocols for collections:

class ExtensibleCollection(*args, **kwargs)#

It represents extensible collections.

abstractmethod extend(iterable)#

Extend the collection by adding the elements of the iterable.

Other elements can be added by the method in order to maintain the algebraic consistency of the structures involved.

Parameters:: iterable (Iterable[TypeVar(_E)]) – An iterable of values
Raises:: NotImplementedError –
Return type:: None

class MutableCollection(*args, **kwargs)#

It represents mutable collections.

abstractmethod add(value)#

Add a value to the collection.

abstractmethod clear()#

Clear the collection.

abstractmethod discard(value)#

Discard a value from the collection.

abstractmethod extend(iterable)#

Extend the collection by adding the elements of the iterable.

Other elements can be added by the method in order to maintain the algebraic consistency of the structures involved.

Parameters:: iterable (Iterable[TypeVar(_E)]) – An iterable of values
Raises:: NotImplementedError –
Return type:: None

abstractmethod pop()#

Remove and return an arbitrary element from the collection.

This method can raise a KeyError if the collection is empty.

abstractmethod remove(value)#

Remove a value from the collection.

This method can raise a KeyError if the value does not belong to the collection.