NamedValueMutableSet

class lsst.daf.butler.NamedValueMutableSet

Bases: NamedValueAbstractSet[K], MutableSet[K]

Mutable variant of NamedValueAbstractSet.

Methods that can add new elements to the set are unchanged from their MutableSet definitions, while those that only remove them can generally accept names or element instances. pop can be used in either its MutableSet form (no arguments; an arbitrary element is returned) or its MutableMapping form (one or two arguments for the name and optional default value, respectively). A MutableMapping-like __delitem__ interface is also included, which takes only names (like NamedValueAbstractSet.__getitem__).

Attributes Summary

names

Return set of names associated with the keys, in the same order.

Methods Summary

add(value)

Add an element.

asMapping()

Return a mapping view with names as keys.

clear()

This is slow (creates N new iterators!) but effective.

discard(element)

Remove an element from the set if it exists.

get(key[, default])

Return the element with the given name.

isdisjoint(other)

Return True if two sets have a null intersection.

pop(*args)

Remove and return an element from the set.

remove(element)

Remove an element from the set.

Attributes Documentation

names

Return set of names associated with the keys, in the same order.

(Set [ str ]).

Methods Documentation

abstract add(value)

Add an element.

abstract asMapping() Mapping[str, K_co]

Return a mapping view with names as keys.

Returns:
dictMapping

A dictionary-like view with values() == self.

clear()

This is slow (creates N new iterators!) but effective.

abstract discard(element: str | K) Any

Remove an element from the set if it exists.

Does nothing if no matching element is present.

Parameters:
elementobject or str

Element to remove or the string name thereof. Assumed to be an element if it has a .name attribute.

get(key: Any, default: Any = None) Any

Return the element with the given name.

Parameters:
keytyping.Any

The name of the element to be requested.

defaulttyping.Any, optional

The value returned if no such element is present.

Returns:
resulttyping.Any

The value of the element.

isdisjoint(other)

Return True if two sets have a null intersection.

abstract pop(*args: str) K

Remove and return an element from the set.

Parameters:
*argsstr, optional

Name of the element to remove and return. Must be passed positionally. If not provided, an arbitrary element is removed and returned.

Raises:
KeyError

Raised if name is provided but default is not, and no matching element exists.

abstract remove(element: str | K) Any

Remove an element from the set.

Parameters:
elementobject or str

Element to remove or the string name thereof. Assumed to be an element if it has a .name attribute.

Raises:
KeyError

Raised if an element with the given name does not exist.