Renomear um arquivo em Python

Najwa Riyaz 30 janeiro 2023
  1. Renomear um arquivo em Python usando os.rename()
  2. Renomear um arquivo em Python usando shutil.move()
Renomear um arquivo em Python

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.

Artigo relacionado - Python File