Cmpnts

class zixy.container.cmpnts.Cmpnts(impl: ImplT, indexer: slice = slice(None, None, None))

Bases: Generic[ImplT, SpecT], ViewableSequence[Cmpnt[ImplT, SpecT], ImplT]

A collection of components.

An array-like container of components that may be an owning instance referencing a contiguous Rust-bound data object, or a view on a slice of the elements in another collection.

__eq__(other: object) → bool

Return whether self and other are equal.

__getitem__(indexer: int | slice) → Cmpnt[ImplT, SpecT] | Self

Overloads:

• self, indexer (int) → Cmpnt[ImplT, SpecT]

• self, indexer (builtins.slice) → Self

Get the element or elements selected by indexer.

Parameters:

indexer – Index or slice selecting the element(s) to return.

Returns:

Element or slice selected by indexer.

__init__(impl: ImplT, indexer: slice = slice(None, None, None))

Initialize the component array.

Parameters:

• impl – Rust-bound object storing the data.

• indexer – Slice of elements within Rust-bound array that are to be viewed by self. The default value of slice(None) indicates that self is taken to be an owning view on all elements of impl.

__iter__() → Iterator[T]

Iterate over the elements of self.

__len__() → int

Get the number of elements in self.

__repr__() → str

Return a string representation of self.

__setitem__(indexer: int | slice, source: SpecT | Cmpnt[ImplT, SpecT] | Cmpnts[ImplT, SpecT] | None) → None

Set the component at indexer in self to source.

Parameters:

• indexer – Index of the string or slice of strings within self to assign.

• source – Value specifying the component or a view of many components to assign at indexer.

append(source: SpecT | Cmpnt[ImplT, SpecT] | None = None) → Self

Append source to the end of self.

Parameters:

source – Value to append.

Note

This method operates in-place.

append_iterable(source: Iterable[SpecT | Cmpnt[ImplT, SpecT] | None] = ()) → Self

Append many values from an iterable source.

Parameters:

source – Iterable over any component specifiers.

Note

This method operates in-place.

append_n(n: int, source: SpecT | Cmpnt[ImplT, SpecT] | None = None) → Self

Append source to the end of self n times.

Parameters:

• n – Number of times to repeatedly append source.

• source – Specification for the value to append.

Note

This method operates in-place.

as_view() → Self

Return a view of self.

Returns:

If self is owning, a new view on the same underlying data, otherwise self.

clone() → Self

Return a deep copy of self.

cmpnt_type: type[Cmpnt[ImplT, SpecT]]

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

filter_map(f: Callable[[Cmpnt[ImplT, SpecT]], bool]) → Self

Eagerly evaluate a filter-map operation over the components of self.

Parameters:

f – Function which may mutate copies of the components of self, returning True if those mutated copies are to be included in the generator. The function signature should take a single Cmpnt instance as an argument, and return a boolean.

Returns:

New instance containing the occurrences of selected (and possibly mutated) components of self according to f.

filter_populated() → Self

Eagerly filter components of self, retaining only those that are not clear.

filter_unique() → Cmpnts[ImplT, SpecT]

Get a new Cmpnts instance containing the unique components of self.

classmethod from_cmpnt(cmpnt: Cmpnt[ImplT, SpecT]) → Self

Create a new one-element instance from a single component.

Parameters:

cmpnt – Component to copy into the new instance.

Returns:

New owning instance containing only cmpnt.

classmethod from_iterable(iterable: Iterable[SpecT | Cmpnt[ImplT, SpecT]], *args: Any, **kwargs: Any) → Self

Create a new instance of cls from an iterable.

Parameters:

• iterable – Iterable returning specifiers of all the components to be appended.

• args – Positional arguments to forward to the constructor of cls.

• kwargs – Keyword arguments to forward to the constructor of cls.

Returns:

New instance of cls containing the components specified by iterable.

classmethod from_size(n: int) → Self

Create a new instance of cls with the given size.

Parameters:

n – The size of the new instance.

Returns:

An instance of cls with the given size.

classmethod from_view(source: Self) → Self

Create a new instance of cls from a view.

Parameters:

source – View to clone into the new instance.

Returns:

An owning clone of source.

into(t: type[OutT]) → OutT

Clone self into a new related container of type t.

Parameters:

t – Type of the new container to create.

Returns:

A new instance of t containing the same data as self.

is_owning() → bool

Check if self is owning (i.e. not a view).

iter_filter_map(f: Callable[[Cmpnt[ImplT, SpecT]], bool]) → Iterator[Cmpnt[ImplT, SpecT]]

Lazily evaluate a filter-map operation over the components of self.

Parameters:

f – Function which may mutate copies of the components of self, returning True if those mutated copies are to be included in the generator. The function signature should take a single Cmpnt instance as an argument, and return a boolean.

Returns:

Iterator over the selected (and possibly mutated) components of self according to f.

iter_filter_populated() → Iterator[Cmpnt[ImplT, SpecT]]

Lazily filter components of self, retaining only those that are not clear.

map_index(i: int) → int

Map an index in self to an index in the underlying data.

Parameters:

i – Index in self.

Returns:

Corresponding index in the underlying data.

new_clear_cmpnt() → Cmpnt[ImplT, SpecT]

Get a new Cmpnt instance using the same implementation as self.

reordered(inds: Sequence[int]) → Self

Get a new instance with the elements of self in a new order.

Parameters:

inds – Sequence of indices defining the new order. Should be a permutation of range(len(self)).

Returns:

A new instance with the reordered elements.

resize(n: int) → Self

Resize the underlying container.

Parameters:

n – The new size of the container.

Note

This method operates in-place.

Raises:

ValueError – If the container is a view.