10. Arquivos#

Arquivos em Python#

Antes de utilizar qualquer arquivo é necessário abri-lo. Para isso, existe a função open(), que recebe pelo menos dois argumentos: a localização do arquivo e o modo de abertura. Depois de utilizar o arquivo é muito importante lembrar de fechá-lo. Muitos problemas podem acontecer se você esquecer de fechar o programa. Para isso devemos usar a função close().

# Modo tradicional de ler um arquivo
arquivo = open('arquivo_texto.txt', 'r')
conteudo = arquivo.read()
arquivo.close() # O que acontece se não fechar?

# Imprime o conteúdo
print(conteudo)

Abrindo arquivos com o with#

Como dissemos anteriormente, é muito importante se lembrar de fechar o arquivo depois de utilizá-lo. Na verdade, isso é tão importante que existe uma maneira de escrevermos um código que fecha o arquivo automaticamente depois que terminamos de utilizá-lo:

# Abre um arquivo para a leitura.
with open('arquivo_texto.txt', 'r') as arquivo:
    conteudo = arquivo.read()
# Quando sai do bloco do 'with', fecha o arquivo automaticamente.

# Imprime o conteúdo
print(conteudo)

A sintaxe do código acima é um pouco diferente, então vamos por partes. O with define um bloco dentro do qual o arquivo será utilizado. Assim que o bloco termina, o que é indicado pelo fim da indentação, o arquivo será automaticamente fechado. A função open() não foi alterada, mas agora ao invés de arquivo = open('arquivo_texto.txt', 'r') nós temos open('arquivo_texto.txt', 'r') as arquivo. O resultado será o mesmo: o arquivo aberto será armazenado na variável arquivo. Essa inversão da ordem é feita apenas em conjunto com o with.

Modos de abertura de um arquivo#

Comentamos que existem dois tipos de arquivo: arquivos binários e arquivos de texto. Nos exemplos acima nós trabalhamos com a leitura de um arquivo de texto. Para isso o modo de abertura do arquivo foi o 'r', ou seja, leitura (read). Para abrir um arquivo binário para leitura devemos utilizar o modo 'rb' (read binary). Tanto o modo 'r' quanto o modo 'rb' permitem apenas a leitura de um arquivo existente. Não é possível adicionar (escrever) nenhuma informação a ele.

Para adicionar dados a um arquivo devemos abri-lo com algum dos modos de escrita. Os modos disponíveis são 'w' e 'a'. O modo 'w' cria um novo arquivo no modo escrita (write). Importante: se já existir um arquivo com o mesmo nome ele apaga o antigo. O modo 'a' (append) é um modo de escrita alternativo que adiciona o novo conteúdo ao final do arquivo se ele já existir, sem apagar o conteúdo anterior

# Cria o arquivo para escrita (limpa o antigo se já existir)
with open('arquivo_texto.txt', 'w') as arquivo:
    # Escrevendo um texto
    arquivo.write("algum dado\n")

# Abre/Cria o arquivo para escrita SEM apagar o que tinha antes.
with open('arquivo_texto.txt', 'a') as arquivo:
    # Escrevendo um texto
    arquivo.write("novo dado\n")

novo dado
algum dado

algum dado novo dado

algum dado\n
novo dado\n

algum dado
novo dado

A seguir apresentamos um resumo dos principais modos de abertura de arquivos (para mais detalhes consulte a documentação):

• 'r': modo de leitura de arquivo texto;
• 'rb': modo de leitura de arquivo binário;
• 'w': modo de escrita de arquivo texto;
• 'wb': modo de escrita de arquivo binário;
• 'a': modo de escrita de arquivo texto, sem apagar o conteúdo anterior;
• 'ab': modo de escrita de arquivo binário, sem apagar o conteúdo anterior.

Salve o arquivo cancao_do_exilio.txt (disponível neste link) na mesma pasta onde você fez os outros testes deste handout. Depois disso, teste o programa abaixo:

Programa 1#

# Lendo tudo de uma vez
with open('cancao_do_exilio.txt', 'r') as arquivo:
    conteudo_completo = arquivo.read()
print(conteudo_completo)

No Programa 1 usamos o método para leitura de arquivo .read() que retorna todo o conteúdo do arquivo em formato de string.

A seguir vamos ver outros métodos de leitura de arquivo.

Resumo dos métodos de arquivos:#

Abaixo você encontra um resumo dos principais métodos de arquivos. Para mais detalhes, consulte a documentação.

Para arquivos abertos no modo de leitura#

• read: retorna todo o conteúdo do arquivo em uma única string;
• readline: retorna uma string contendo apenas a próxima linha;
• readlines: retorna uma lista de strings, contendo uma string para cada linha.

Para arquivos abertos no modo de escrita#

• write: escreve no arquivo a string passada como argumento;
• writelines: recebe uma lista de strings e escreve todas no arquivo.

O formato JSON#

O formato JSON é uma forma de trocar informação de modo estruturado, simples e rápido entre sistemas. Ele é muito parecido com um dicionário do Python, contudo o JSON é um texto (string) e não uma estrutura de dados. Por ser um texto, ele pode ser armazenado em um arquivo. Assim esses dados continuam existindo, mesmo depois que o programa termina. Exemplo:

{"Alunos":[
     { "nome": "João", "notas": [ 8, 9, 5 ]  },
     { "nome": "Maria", "notas": [ 8, 10, 7 ] },
     { "nome": "José", "notas": [ 10, 10, 9 ] }
]}

O JSON acima contém os nomes e notas de 3 alunos. Esse poderia ser o conteúdo de um arquivo de texto chamado, por exemplo, alunos.json. Para utilizar os dados presentes nele será necessário processar a string JSON para obter um dicionário. Para isso utilizamos o módulo json do Python:

import json

with open('alunos.json', 'r') as arquivo_json:
    texto = arquivo_json.read()

print(texto)
# Para verificar que é realmente um texto (string),
# vamos usar um fatiamento:
print(texto[:15])

# Criando um dicionário a partir das informações no texto
dicionario = json.loads(texto)

# Para verificar que é um dicionário,
# vamos imprimir o valor armazenado na chave "Alunos"
print(dicionario['Alunos'])

# Adicionando um novo aluno no dicionário
novo_aluno = {'nome': 'Alice', 'notas': [10, 7, 8]}
dicionario['Alunos'].append(novo_aluno)

# Transformando de volta para JSON (texto)
novo_json = json.dumps(dicionario)

# Salvando o arquivo
with open('alunos.json', 'w') as arquivo_json:
    arquivo_json.write(novo_json)

# Abra o arquivo alunos.json e verifique seu conteúdo.

{"Alunos":[
     { "nome": "João", "notas": [ 8, 9, 5 ]  },
     { "nome": "Maria", "notas": [ 8, 10, 7 ] },
     { "nome": "José", "notas": [ 10, 10, 9 ] },
     { "nome": "Alice", "notas": [10, 7, 8] }
]}

 { "nome": "Alice", "notas": [10, 7, 8] }

{"Alunos":[
    { "nome": "Alice", "notas": [10, 7, 8] }
]}

{"Alunos":[
     { "nome": "João", "notas": [ 8, 9, 5 ]  },
     { "nome": "Maria", "notas": [ 8, 10, 7 ] },
     { "nome": "José", "notas": [ 10, 10, 9 ] }
]}

{"Alunos":[
     { "nome": "João", "notas": [ 8, 9, 5 ]  },
     { "nome": "Maria", "notas": [ 8, 10, 7 ] },
     { "nome": "José", "notas": [ 10, 10, 9 ] },
     { "nome": "Alice", "notas": [10, 7, 8] }
]}