NamedKeyDict

class lsst.daf.butler.NamedKeyDict(*args: Any)

Bases: NamedKeyMutableMapping[K, V]

Dictionary wrapper for named keys.

Requires keys to have a .name attribute, and permits lookups using either key objects or their names.

Names can be used in place of keys when updating existing items, but not when adding new items.

It is assumed (but asserted) that all name equality is equivalent to key equality, either because the key objects define equality this way, or because different objects with the same name are never included in the same dictionary.

Parameters:
*argstyping.Any

All positional constructor arguments are forwarded directly to dict. Keyword arguments are not accepted, because plain strings are not valid keys for NamedKeyDict.

Raises:
AttributeError

Raised when an attempt is made to add an object with no .name attribute to the dictionary.

AssertionError

Raised when multiple keys have the same name.

Attributes Summary

names

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

Methods Summary

byName()

Return a dict with names as keys and the self values.

clear()

copy()

Return a new NamedKeyDict with the same elements.

freeze()

Disable all mutators.

get(k[,d])

items()

keys()

pop(k[,d])

If key is not found, d is returned if given, otherwise KeyError is raised.

popitem()

as a 2-tuple; but raise KeyError if D is empty.

setdefault(k[,d])

update([E, ]**F)

If E present and has a .keys() method, does: for k in E: D[k] = E[k] If E present and lacks .keys() method, does: for (k, v) in E: D[k] = v In either case, this is followed by: for k, v in F.items(): D[k] = v

values()

Attributes Documentation

names

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

(KeysView).

Methods Documentation

byName() dict[str, V]

Return a dict with names as keys and the self values.

clear() None.  Remove all items from D.
copy() NamedKeyDict[K, V]

Return a new NamedKeyDict with the same elements.

freeze() NamedKeyMapping[K, V]

Disable all mutators.

Effectively transforms self into an immutable mapping.

Returns:
selfNamedKeyMapping

While self is modified in-place, it is also returned with a type annotation that reflects its new, frozen state; assigning it to a new variable (and considering any previous references invalidated) should allow for more accurate static type checking.

get(k[, d]) D[k] if k in D, else d.  d defaults to None.
items() a set-like object providing a view on D's items
keys() a set-like object providing a view on D's keys
pop(k[, d]) v, remove specified key and return the corresponding value.

If key is not found, d is returned if given, otherwise KeyError is raised.

popitem() (k, v), remove and return some (key, value) pair

as a 2-tuple; but raise KeyError if D is empty.

setdefault(k[, d]) D.get(k,d), also set D[k]=d if k not in D
update([E, ]**F) None.  Update D from mapping/iterable E and F.

If E present and has a .keys() method, does: for k in E: D[k] = E[k] If E present and lacks .keys() method, does: for (k, v) in E: D[k] = v In either case, this is followed by: for k, v in F.items(): D[k] = v

values() an object providing a view on D's values