Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

collections.ChainMap

Reúne vários mapeamentos numa vista de configuração.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

collections.ChainMap(*maps)

Reúne vários mapeamentos numa vista de configuração.

A leitura usa o primeiro valor encontrado a contar da esquerda. A vista guarda referências e reflete alterações posteriores nos valores de base. A escrita e a remoção atuam no primeiro mapeamento. Remover uma chave presente apenas na base gera KeyError.

No exemplo mode passa a b apenas em override.

from collections import ChainMap
defaults = {"timeout": 30}
config = ChainMap({}, defaults)
defaults["timeout"] = 60
assert config["timeout"] == 60
try:
    del config["timeout"]
except KeyError:
    assert defaults == {"timeout": 60}
else:
    raise AssertionError

Exemplos

import collections
base = {"rate": 2, "mode": "a"}
override = {"rate": 5}
config = collections.ChainMap(override, base)
config["mode"] = "b"
print(config["rate"], config["mode"])
print(base["mode"], override["mode"])

Resultado

5 b
a b

No exemplo mode passa a b apenas em override.

Fontes