napari.utils.events.TypedMutableSequence

class napari.utils.events.TypedMutableSequence(data: Iterable[napari.utils.events.containers._typed._T] = (), *, basetype: Union[Type[napari.utils.events.containers._typed._T], Sequence[Type[napari.utils.events.containers._typed._T]]] = (), lookup: Optional[Dict[Type[napari.utils.events.containers._typed._L], Callable[[napari.utils.events.containers._typed._T], Union[napari.utils.events.containers._typed._T, napari.utils.events.containers._typed._L]]]] = None)

Bases: MutableSequence[napari.utils.events.containers._typed._T]

List mixin that enforces item type, and enables custom indexing.

Parameters

• data (iterable, optional) – Elements to initialize the list with.

• basetype (type or sequence of types, optional) – Type of the elements in the list. If a basetype (or multiple) is provided, then a TypeError will be raised when attempting to add an item to this sequence if it is not an instance of one of the types in basetype.

• lookup (dict of Type[L] : function(object) -> L) – Mapping between a type, and a function that converts items in the list to that type. This is used for custom indexing. For example, if a lookup of {str: lambda x: x.name} is provided, then you can index into the list using list['frank'] and it will search for an object whos attribute .name equals 'frank'.

Methods

append(value)	S.append(value) -- append value to the end of the sequence
clear()
copy()	Return a shallow copy of the list.
count(value)
extend(values)	S.extend(iterable) -- extend sequence by appending elements from the iterable
index(value[, start, stop])	Return first index of value.
insert(index, value)	S.insert(index, value) -- insert value before index
pop([index])	Raise IndexError if list is empty or index is out of range.
remove(value)	S.remove(value) -- remove first occurrence of value.
reverse()	S.reverse() -- reverse IN PLACE

Details

append(value)

S.append(value) – append value to the end of the sequence

clear() → None -- remove all items from S

copy() → napari.utils.events.containers._typed.TypedMutableSequence[napari.utils.events.containers._typed._T]

Return a shallow copy of the list.

count(value) → integer -- return number of occurrences of value

extend(values)

S.extend(iterable) – extend sequence by appending elements from the iterable

index(value: napari.utils.events.containers._typed._L, start: int = 0, stop: Optional[int] = None) → int

Return first index of value.

Parameters

• value (Any) – A value to lookup. If type(value) is in the lookups functions provided for this class, then values in the list will be searched using the corresponding lookup converter function.

• start (int, optional) – The starting index to search, by default 0

• stop (int, optional) – The ending index to search, by default None

Returns

The index of the value

Return type

int

Raises

ValueError – If the value is not present

insert(index: int, value: napari.utils.events.containers._typed._T)

S.insert(index, value) – insert value before index

pop([index]) → item -- remove and return item at index (default last).

Raise IndexError if list is empty or index is out of range.

remove(value)

S.remove(value) – remove first occurrence of value. Raise ValueError if the value is not present.

reverse()

S.reverse() – reverse IN PLACE

previous

napari.utils.events.SupportsEvents

next

napari.utils.notifications