lsst.afw.typehandling._SimpleGenericMap.SimpleGenericMap Class Reference

Inheritance diagram for lsst.afw.typehandling._SimpleGenericMap.SimpleGenericMap:

Public Member Functions
def	fromkeys (cls, iterable, value=None)
def	pop (self, key, default=None)
def	__repr__ (self)
def	__eq__ (self, other)
def	__call__ (cls, *args, **kwargs)

Static Public Attributes
	setdefault = MutableMapping.setdefault
	update = MutableMapping.update
	keys = Mapping.keys
	values = Mapping.values
	items = Mapping.items

Detailed Description

A `dict`-like `~collections.abc.MutableMapping` for use when sharing a
map between C++ and Python.

For compatibility with C++, ``SimpleGenericMap`` has the following
restrictions:

    - all keys must be of the same type
    - values must be built-in types or subclasses of
      `lsst.afw.typehandling.Storable`. Almost any user-defined class in
      C++ or Python can have `~lsst.afw.typehandling.Storable` as a mixin.

As a safety precaution, `~lsst.afw.typehandling.Storable` objects that are
added from C++ may be copied when you retrieve them from Python, making it
impossible to modify them in-place. This issue does not affect objects that
are added from Python, or objects that are always passed by
:cpp:class:`shared_ptr` in C++.

Parameters
----------
mapping : `collections.abc.Mapping`, optional
iterable : iterable, optional
dtype : `type`, optional
    The type of key the map accepts. Not required if ``mapping`` or
    ``iterable`` is provided.
**kwargs
    Aside from the ``dtype`` keyword, a ``SimpleGenericMap`` takes the same
    input arguments as `dict`.

Definition at line 29 of file _SimpleGenericMap.py.

Member Function Documentation

__call__()

def lsst.afw.typehandling._GenericMap.AutoKeyMeta.__call__ (   cls, *  args, **  kwargs  )

inherited

Definition at line 135 of file _GenericMap.py.

    def __call__(cls, *args, **kwargs):  # noqa N805, non-self first param
        if len(cls.TEMPLATE_PARAMS) != 1:
            raise ValueError("AutoKeyMeta requires exactly one template parameter")
        dtypeKey = cls.TEMPLATE_PARAMS[0]
        dtype = kwargs.get(dtypeKey, None)
 
        # Try to infer dtype if not provided
        if dtype is None and len(args) >= 1:
            dtype = cls._guessKeyType(args[0])
            if dtype is not None:
                kwargs[dtypeKey] = dtype
 
        return super().__call__(*args, **kwargs)
 

__eq__()

def lsst.afw.typehandling._GenericMap.GenericMap.__eq__ (   self,   other  )

inherited

Definition at line 55 of file _GenericMap.py.

    def __eq__(self, other):
        if len(self) != len(other):
            return False
 
        for key, value in self.items():
            try:
                if (value != other[key]):
                    return False
            except KeyError:
                return False
        return True
 

__repr__()

def lsst.afw.typehandling._GenericMap.GenericMap.__repr__ (   self )

inherited

Definition at line 49 of file _GenericMap.py.

    def __repr__(self):
        className = type(self).__name__
        return className + "({" + ", ".join("%r: %r" % (key, value) for key, value in self.items()) + "})"
 

fromkeys()

def lsst.afw.typehandling._SimpleGenericMap.SimpleGenericMap.fromkeys	(		cls,
			iterable,
			value = None
	)

Definition at line 59 of file _SimpleGenericMap.py.

    def fromkeys(cls, iterable, value=None):
        return cls({key: value for key in iterable})
 
 
SimpleGenericMap.register(str, SimpleGenericMapS)
 
 
# pybind11-generated constructor, can only create empty map

pop()

def lsst.afw.typehandling._GenericMap.MutableGenericMap.pop (   self,   key,   default = None  )

inherited

Definition at line 106 of file _GenericMap.py.

    def pop(self, key, default=None):
        try:
            value = self[key]
            del self[key]
            return value
        except KeyError:
            if default is not None:
                return default
            else:
                raise
 
 
MutableGenericMap.register(str, MutableGenericMapS)
MutableMapping.register(MutableGenericMapS)
 
 

Member Data Documentation

items

lsst.afw.typehandling._GenericMap.GenericMap.items = Mapping.items

staticinherited

Definition at line 70 of file _GenericMap.py.

keys

lsst.afw.typehandling._GenericMap.GenericMap.keys = Mapping.keys

staticinherited

Definition at line 68 of file _GenericMap.py.

setdefault

lsst.afw.typehandling._GenericMap.MutableGenericMap.setdefault = MutableMapping.setdefault

staticinherited

Definition at line 102 of file _GenericMap.py.

update

lsst.afw.typehandling._GenericMap.MutableGenericMap.update = MutableMapping.update

staticinherited

Definition at line 103 of file _GenericMap.py.

values

lsst.afw.typehandling._GenericMap.GenericMap.values = Mapping.values

staticinherited

Definition at line 69 of file _GenericMap.py.

---

The documentation for this class was generated from the following file:

• /j/snowflake/release/lsstsw/stack/lsst-scipipe-0.7.0/Linux64/afw/22.0.1-42-gca6935d93+ba5e5ca3eb/python/lsst/afw/typehandling/_SimpleGenericMap.py