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

CKTIS / Python

dataclasses.field

Configura as opções de um campo anotado.

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

Sintaxe

dataclasses.field(default_factory=list)

Configura as opções de um campo anotado.

MISSING indica ausência de configuração e None é um valor predefinido possível. metadata é um mapeamento só de leitura. A fábrica é chamada uma vez para esse campo em cada instância que usa o valor predefinido. Quando é necessário um valor predefinido, default_factory chama a fábrica sem argumentos, pelo que se passa list. Fornecer default e default_factory em conjunto gera ValueError. Cada Bag recebe a sua lista e acrescentar 8 a a deixa b vazia.

Desde 3.14 doc documenta o campo.

from dataclasses import dataclass, field
@dataclass
class Queue:
    values: list = field(default_factory=list, repr=False)
a, b = Queue(), Queue()
assert a.values is not b.values and repr(a) == "Queue()"
try:
    field(default=[], default_factory=list)
except ValueError:
    pass
else:
    raise AssertionError
from dataclasses import MISSING, fields
assert fields(Queue)[0].default is MISSING
explicit = []
assert Queue(explicit).values is explicit

Exemplos

import dataclasses
@dataclasses.dataclass
class Bag:
    items: list = dataclasses.field(default_factory=list)

a, b = Bag(), Bag()
a.items.append(8)
print(a.items, b.items)

Resultado

[8] []

Desde 3.14 doc documenta o campo.

Fontes