Python - How To Rename a File in Python

ID : 411

viewed : 158

Tags : PythonPython File

vote vote

99

If you wish to rename a file in Python, choose one of the following options.

  1. Use os.rename() to rename a file.
  2. Use shutil.move() to rename a file.

Rename a File in Python Using os.rename()

The function os.rename() can be used to rename a file in Python.

For example,

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)

In the above example,

file_oldname - the old file name.

file_newname_newfile - the new file name.

Result:

  1. The file named file_oldname is renamed to file_newname_newfile
  2. The content which was present in file_oldname will be found in file_newname_newfile.

Pre-requisites:

  • Import the os module.
    import os
  • Be aware of the current directory.

    If the source/destination file doesn’t exist in the current directory where the code is executed, mention the absolute or relative path to the files.

  • The source file should exist. Otherwise it displays the following error.
    [WinError 2] The system cannot find the file specified
  • The destination file should not exist. Else the following error is displayed -
    [WinError 183] Cannot create a file when that file already exists

Rename a File in Python Using shutil.move()

The function shutil.move() can also be used to rename a file in Python.

For example,

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)

In the above example,

file_oldname: the old file name.

file_newname_newfile: the new file name.

Result:

  1. The file named file_oldname is renamed to file_newname_newfile
  2. The content which was present in file_oldname will now be found in file_newname_newfile.
  3. The return value - newFileName, which is the new file name.

Pre-requisites:

  • Import the shutil module as,
    import shutil
  • Be aware of the current directory.

    If the source/destination file doesn’t exist in the current directory where the code is executed, mention the absolute or relative path to the files.

  • The source file should exist. Else the following error is displayed -
    [WinError 2] The system cannot find the file specified.
  • If the destination file already exists, no error is displayed. Also, if any content was present in the destination file, it is overwritten with the content in the source file.

  • Related HOW TO?

    Python - How To Check Operating System
    Python - How To Conditional Assignment Operator in Python
    Python - How To Assignment Operators in Python
    Python - How To What Does // Mean in Python
    Python - How To Logical AND Operator in Python
    Python - How To Ternary Conditional Operator in Python
    Python - How To XOR in Python
    Python - How To Play Mp3 File
    Python - How To Convert Text to Speech in Python
    Python - How To Remove Commas From String in Python
    Python - How To Check a String Is Empty in a Pythonic Way
    Python - How To Convert a String to Variable Name in Python
    Python - How To Remove Whitespace From a String in Python
    Python - How To Extract Numbers From a String in Python
    Python - How To Convert String to Datetime in Python
    Python - How To Convert String to Lowercase in Python 2 and 3
    Python - How To Check Whether a String Contains Substring in Python
    Python - How To Convert a List to String in Python
    Python - How To Convert Bytes to String in Python 2 and Python 3
    Python - How To Convert String to Float or Int in Python
    Python - How To Read One File Line by Line to a List in Python
    Python - How To Convert String to Bytes in Python
    Python - How To Check a String Contains a Number in Python
    Python - How To Split String Based on Multiple Delimiters in Python
    Python - How To Convert a String to a Float Value in Python
    Python - How To Fix Python Cannot Concatenate STR and Int Objects Error
    Python - How To Fix String Must Be Indices Error in Python
    Python - How To Fix TypeError: Not Enough Arguments for Format String Error in Python
    Python - How To Strip Multiple Characters in Python
    Python - How To Check if a String Is a Number in Python