Ler e escrever JSON em Python
Nesta lição, você vai converter uma string JSON em dicionário Python e vice-versa com o módulo json da biblioteca padrão.
Introdução
O problema
Programas trocam dados o tempo todo: uma API web envia um usuário, um arquivo de configuração guarda opções, outro programa espera os seus resultados. Para isso, os dois lados precisam de um formato de texto comum. JSON é esse formato, e o Python precisa convertê-lo em dicionários e listas, e também fazer o caminho de volta.
Pense assim
O JSON é como um formulário preenchido num modelo padrão que qualquer repartição consegue ler. json.loads lê o formulário preenchido e transforma em dados Python com que você pode trabalhar. json.dumps escreve seus dados Python de volta no mesmo modelo padrão, para que qualquer outro programa consiga ler.
json.loads(...)📥 Leia o formulário e transforme em dados Pythonuser["score"] = 95🖊️ Acrescente um campojson.dumps(user, indent=2)📤 Escreva de novo no modelo padrãotrue🔤 O true do JSON vira o True do PythonJSON é um formato de texto para dados. O módulo json converte texto JSON em valores Python (json.loads) e valores Python em texto JSON (json.dumps).
Pontos-chave
json.loads(...)transforma o texto JSON em um dicionário Python, e otruedo JSON viraTrue.user["score"] = 95muda os dados como em qualquer outro dicionário.json.dumps(user, indent=2)escreve de volta como texto JSON, indentado para pessoas lerem.- Na saída, o
Truedo Python é escrito de novo comotruedo JSON.
Quando usar?
- Ler respostas de APIs web e enviar dados para elas.
- Guardar configurações ou pequenos conjuntos de dados em um arquivo legível.
- Passar dados entre programas escritos em linguagens diferentes.
Quando não é preciso
- Datas, sets ou as suas próprias classes: JSON não guarda isso direto, então converta antes para strings ou dicionários.
- Tabelas enormes de números: CSV ou um banco de dados é menor e mais rápido.
Código de exemplo
import json
user = json.loads('{"name": "Ada", "active": true}')
user["score"] = 95
print(json.dumps(user, indent=2))
Resultado da execução
{
"name": "Ada",
"active": true,
"score": 95
}
Explicação do código
A função json.loads() lê uma string JSON e retorna um dicionário, em que o valor true do JSON vira True no Python. Depois de adicionar a chave score, a função json.dumps() converte o dicionário de volta em string JSON. O parâmetro indent=2 recua o resultado para facilitar a leitura.
Altere os valores e execute o programa no compilador Python online CodeUtility sem instalar Python.
Exercícios práticos
Tente modificar o código seguindo as sugestões abaixo. Mudar o código e observar o resultado ajuda você a entender muito mais do que só ler.
- Mude os dados de entrada e tente prever o resultado antes de executar.
- Adicione uma verificação para dados vazios ou inválidos.
- Coloque a lógica em uma função separada e teste com vários conjuntos de dados.
Erros comuns
Confundir loads e load
loads lê uma string; load lê de um arquivo aberto. O s vem de string.
with open("user.json") as f:
user = json.loads(f)
with open("user.json") as f:
user = json.load(f)
Escrever JSON com aspas simples
JSON exige aspas duplas em volta de chaves e strings.
json.loads("{'name': 'Ada'}")
json.loads('{"name": "Ada"}')
Terminou esta lição?
Marque como aprendida para acompanhar seu progresso.
Pratique com um desafio
Use o conteúdo desta lição para resolver um problema real. Cada desafio roda no navegador, com testes instantâneos e uma revisão por IA.
- Montar um objeto JSON Transforme chaves e valores em uma string de objeto JSON, escapando aspas e barras invertidas corretamente. Fácil
- Somar um objeto JSON plano Analise um objeto JSON plano cujos valores são inteiros e some os valores. Fácil