json — codificação e descodificação JSON

Este módulo converte entre objetos Python e o formato de dados JSON. Utilize dumps()/loads() para (de)serializar de/para uma string, ou dump()/load() para ler ou escrever JSON a partir de um fluxo como um ficheiro ou socket.

Funções

json.dump(obj: Any, stream: Any, separators: Tuple[str, str] | None = None) → None

Serializa obj para uma string JSON, escrevendo-a no stream indicado.

Se especificado, os separadores devem ser um tuplo (item_separator, key_separator). O valor predefinido é (', ', ': '). Para obter a representação JSON mais compacta, deverá especificar (',', ':') para eliminar espaços em branco.

json.dumps(obj: Any, separators: Tuple[str, str] | None = None) → str

Devolve obj representado como uma string JSON.

Os argumentos têm o mesmo significado que em dump().

json.load(stream: Any) → Any

Analisa o stream indicado, interpretando-o como uma string JSON e desserializando os dados para um objeto Python. O objeto resultante é devolvido.

A análise continua até ao fim do ficheiro. É levantada uma ValueError se os dados no stream não estiverem corretamente formados.

json.loads(str: str | bytes) → Any

Analisa a string JSON str e devolve um objeto. Levanta ValueError se a string não estiver corretamente formada.