Como verificar se um arquivo existe em Python

Em Python, verificar se um arquivo existe antes de tentar usá-lo é uma tarefa comum, especialmente se você estiver realizando operações de arquivo de forma programática, como ler ou gravar dados em um grande número de arquivos. Neste tutorial, vou guiar você por três métodos eficazes para verificar se um arquivo existe no Python.

Três métodos para verificar se um arquivo existe em Python

Há várias maneiras de verificar a existência de um arquivo em Python, cada uma delas adequada a diferentes cenários e estilos de programação. A seguir, exploraremos três métodos comuns que podem ser usados para verificar se os arquivos existem.

Pré-requisitos: Entendendo o diretório atual

Ao longo deste tutorial, verei maneiras de verificar se o arquivo my_file.txt será armazenado na pasta my_data. No entanto, antes de fazer isso, é essencial entender como é a sua estrutura de pastas atual para que você possa navegar pelo diretório de forma eficaz. Aqui estão algumas funções padrão para ajudar você a navegar pelas pastas e diretórios.

Obtenha seu diretório atual usando os.getcwd()

Para obter o diretório de trabalho atual em Python, você pode usar a função getcwd() do pacote os. Essa função retorna uma cadeia de caracteres que representa o caminho do diretório de trabalho atual. Por exemplo:

import os

# Get the current working directory
current_directory = os.getcwd()
print("The current working directory is:", current_directory)

Liste todos os arquivos e pastas em seu diretório usando os.listdir()

Para listar todas as pastas e arquivos no diretório atual em Python, você pode usar a função listdir() do pacote os. Essa função retorna uma lista que contém os nomes das entradas no diretório fornecido pelo caminho. Por exemplo, meu diretório atual contém a pasta my_data e um conjunto de dados chamado airbnb_data.csv. Aqui, eu uso o site listdir() para listá-los:

import os

# Get the current working directory
current_directory = os.getcwd()

# List all files and folders in the current directory
entries = os.listdir(current_directory)
print(entries) # Returns ['my_data, 'airbnb_data.csv'] 

Método 1: Usando o os.path.exists() função

Agora que aprendemos a navegar pelos diretórios, vamos verificar se alguns arquivos existem! A função os.path.exists() do módulo os é uma maneira direta de verificar a existência de um arquivo ou diretório. É simples de usar e entender. Aqui, eu uso uma instrução if que retorna “This file exists.” se o arquivo my_file.txt estiver presente em my_data e ”This file does not exist” caso contrário.

import os

# Specify the file path
file_path = 'my_data/my_file.txt'

# Check if the file exists
if os.path.exists(file_path):
   print("The file exists.")
else:
   print("The file does not exist.")

Método 2: Usando o pathlib.Path.exists() função

Para uma abordagem mais moderna e orientada a objetos, o método Path.exists() do pacote pathlib permite que você trabalhe com caminhos de arquivos de forma mais intuitiva, integrando-se perfeitamente aos recursos de manipulação de arquivos do Python.

from pathlib import Path

# Create a Path object
file_path = Path('my_data/my_file.txt')

# Check if the file exists
if file_path.exists():
   print("The file exists.")
else:
   print("The file does not exist.")

Método 3: Usando o try-except bloco com abertura de arquivo

Outro método é empregar um bloco try-except em combinação com a função open() para abrir o arquivo enquanto você verifica se ele existe. Esse método combina eficientemente a verificação de existência com o acesso ao arquivo.

try:
    # Attempt to open the file
    with open('my_data/my_file.txt', 'r') as file:
        print("The file exists.")
except FileNotFoundError:
    print("The file does not exist.")

Conclusão

Em conclusão, o Python oferece vários métodos para verificar se um arquivo existe em um diretório. O método escolhido depende do seu estilo de programação e do caso de uso! Para saber mais sobre o aprendizado de Python, confira nosso tutorial Como sair do Python ou Como converter uma cadeia de caracteres em um número inteiro em Python.