HOWTO · Python

Renomear um arquivo em Python

Este artigo o orienta sobre como você pode renomear um arquivo em Python

Por Najwa RiyazPublicado 2021-07-13Atualizado 2023-01-30

Se você deseja renomear um arquivo em Python, escolha uma das seguintes opções.

  1. Use os.rename() para renomear um arquivo.
  2. Use shutil.move() para renomear um arquivo.

Renomear um arquivo em Python usando os.rename()

A função os.rename() pode ser usada para renomear um arquivo em Python.

Por exemplo,

import os

file_oldname = os.path.join("c:\\Folder-1", "OldFileName.txt")
file_newname_newfile = os.path.join("c:\\Folder-1", "NewFileName.NewExtension")

os.rename(file_oldname, file_newname_newfile)

No exemplo acima,

file_oldname - o nome do arquivo antigo.

file_newname_newfile - o novo nome do arquivo.

Resultado:

  1. O arquivo denominado file_oldname é renomeado para file_newname_newfile
  2. O conteúdo que estava presente em file_oldname será encontrado em file_newname_newfile.

Pré-requisitos:

  • Importe o módulo os.
    import os
  • Esteja ciente do diretório atual.

    Se o arquivo de origem / destino não existir no diretório atual onde o código é executado, mencione o caminho absoluto ou relativo para os arquivos.

  • O arquivo de origem deve existir. Caso contrário, ele exibe o seguinte erro.
    [WinError 2] The system cannot find the file specified
  • O arquivo de destino não deve existir. Caso contrário, o seguinte erro é exibido -
    [WinError 183] Cannot create a file when that file already exists

Renomear um arquivo em Python usando shutil.move()

A função shutil.move() também pode ser usada para renomear um arquivo em Python.

Por exemplo,

import shutil

file_oldname = os.path.join("c:\\Folder-1", "OldFileName.txt")
file_newname_newfile = os.path.join("c:\\Folder-1", "NewFileName.NewExtension")

newFileName = shutil.move(file_oldname, file_newname_newfile)

print("The renamed file has the name:", newFileName)

No exemplo acima,

file_oldname: o nome do arquivo antigo.

file_newname_newfile: o novo nome do arquivo.

Resultado:

  1. O arquivo denominado file_oldname é renomeado para file_newname_newfile
  2. O conteúdo que estava presente em file_oldname agora será encontrado em file_newname_newfile.
  3. O valor de retorno - newFileName, que é o novo nome do arquivo.

Pré-requisitos:

  • Importar o módulo shutil como,
    import shutil
  • Esteja ciente do diretório atual.

    Se o arquivo de origem / destino não existir no diretório atual onde o código é executado, mencione o caminho absoluto ou relativo para os arquivos.

  • O arquivo de origem deve existir. Caso contrário, o seguinte erro é exibido -
    [WinError 2] The system cannot find the file specified.
  • Se o arquivo de destino já existir, nenhum erro será exibido. Além disso, se algum conteúdo estiver presente no arquivo de destino, ele será substituído pelo conteúdo do arquivo de origem.

Sobre o autor

Najwa Riyaz

Ver perfil do autor