Lendo e gravando arquivos JSON

Gravando um arquivo com json.dump

Até aqui você converteu dados de e para strings. Para guardar algo entre uma execução e outra do programa, é preciso gravar em disco. A função json.dump, sem o s, faz isso: em vez de devolver uma string, ela escreve o JSON direto em um arquivo. Você abre o arquivo em modo de escrita com with open e passa o objeto de arquivo como segundo argumento. Veja o padrão completo, já com os cuidados de indentação e acentos.

import json

agenda = {
    "contatos": [
        {"nome": "João", "cidade": "São Paulo"},
        {"nome": "Íris", "cidade": "Belém"},
    ]
}

with open("agenda.json", "w", encoding="utf-8") as arquivo:
    json.dump(agenda, arquivo, indent=2, ensure_ascii=False)

print("Arquivo agenda.json gravado.")

json.dump grava direto no arquivo. O with open cuida de abrir e fechar com segurança.

Depois desse código, existe um arquivo chamado agenda.json na pasta do programa, com o conteúdo indentado e os acentos preservados. O with open abre o arquivo, e o bloco indentado é onde você trabalha com ele; ao sair do bloco, o Python fecha o arquivo sozinho, garantindo que tudo foi gravado. O modo "w" significa escrita e cria o arquivo se ele não existir, ou substitui o conteúdo se já existir.

Lendo o arquivo de volta com json.load

Gravar só faz sentido se depois você recupera os dados. A função json.load, também sem o s, lê um arquivo aberto em modo de leitura e devolve os dados do Python de volta. O modo agora é "r", de leitura, e o encoding continua sendo utf-8. O resultado é o mesmo dicionário ou lista que você gravou, pronto para usar. Este é o ciclo completo: dump para salvar, load para recuperar.

import json

with open("agenda.json", "r", encoding="utf-8") as arquivo:
    agenda = json.load(arquivo)

print(type(agenda))   # <class 'dict'>

for contato in agenda["contatos"]:
    print(contato["nome"], "-", contato["cidade"])
# João - São Paulo
# Íris - Belém

json.load lê o arquivo e reconstrói os dados. Os acentos voltam intactos graças ao utf-8.

O detalhe do encoding merece atenção porque é uma fonte silenciosa de bugs. Se você grava com utf-8 e lê sem informar o encoding, ou vice-versa, os acentos podem sair embaralhados ou o programa pode falhar. A regra é simples: informe encoding="utf-8" em toda abertura de arquivo de texto. Assim o mesmo código funciona igual no Windows, no Linux e no macOS, sem surpresas com o São Paulo virando algo ilegível.

As quatro funções, lado a lado

Agora você conhece as quatro funções principais do módulo json, e vale organizá-las na cabeça. A diferença é entre trabalhar com strings ou com arquivos, e entre ir ou voltar. As funções com s no nome, dumps e loads, lidam com strings na memória. As sem s, dump e load, lidam com arquivos. E dentro de cada par, dump escreve e load lê. Essa tabela resume tudo.

Com esse mapa, escolher a função certa vira automático. Recebeu uma string de uma API e quer os dados? loads. Tem dados e quer salvar em disco? dump. Quer só ver o JSON impresso na tela? dumps. Quer carregar de um arquivo salvo antes? load. As quatro seguem a mesma lógica de tipos e aceitam os mesmos argumentos de formatação, então o que você aprendeu nas aulas anteriores continua valendo aqui, agora aplicado a arquivos reais.