Key lookup on a sequence of maps.
| 200 | |
| 201 | |
| 202 | class ChainMap(MutableMapping): |
| 203 | """Key lookup on a sequence of maps.""" |
| 204 | |
| 205 | key_t = None |
| 206 | changes = None |
| 207 | defaults = None |
| 208 | maps = None |
| 209 | _observers = () |
| 210 | |
| 211 | def __init__(self, *maps, **kwargs): |
| 212 | # type: (*Mapping, **Any) -> None |
| 213 | maps = list(maps or [{}]) |
| 214 | self.__dict__.update( |
| 215 | key_t=kwargs.get('key_t'), |
| 216 | maps=maps, |
| 217 | changes=maps[0], |
| 218 | defaults=maps[1:], |
| 219 | _observers=[], |
| 220 | ) |
| 221 | |
| 222 | def add_defaults(self, d): |
| 223 | # type: (Mapping) -> None |
| 224 | d = force_mapping(d) |
| 225 | self.defaults.insert(0, d) |
| 226 | self.maps.insert(1, d) |
| 227 | |
| 228 | def pop(self, key, *default): |
| 229 | # type: (Any, *Any) -> Any |
| 230 | _key = self._key(key) |
| 231 | try: |
| 232 | return self.maps[0].pop(_key, *default) |
| 233 | except KeyError: |
| 234 | raise KeyError( |
| 235 | f'Key not found in the first mapping: {key!r}') |
| 236 | |
| 237 | def __missing__(self, key): |
| 238 | # type: (Any) -> Any |
| 239 | raise KeyError(key) |
| 240 | |
| 241 | def _key(self, key): |
| 242 | # type: (Any) -> Any |
| 243 | return self.key_t(key) if self.key_t is not None else key |
| 244 | |
| 245 | def __getitem__(self, key): |
| 246 | # type: (Any) -> Any |
| 247 | _key = self._key(key) |
| 248 | for mapping in self.maps: |
| 249 | try: |
| 250 | return mapping[_key] |
| 251 | except KeyError: |
| 252 | pass |
| 253 | return self.__missing__(key) |
| 254 | |
| 255 | def __setitem__(self, key, value): |
| 256 | # type: (Any, Any) -> None |
| 257 | self.changes[self._key(key)] = value |
| 258 | |
| 259 | def __delitem__(self, key): |
no outgoing calls