About the Tutorial

os.renames() Method 
Description 
The method renames() is recursive directory or file renaming function. It does the same 
functioning as os.rename(), but it also moves a file to a directory, or a whole tree of 
directories, that do not exist. 
Syntax 
Following is the syntax for renames() method- 
os.renames(old, new) 
Parameters 

old
- This is the actual name of the file or directory to be renamed. 

---

Python 3 
305 

new
- This is the new name of the file or directory.It can even include a file to a 
directory, or a whole tree of directories, that do not exist. 
Return Value 
This method does not return any value. 
Example 
The following example shows the usage of renames() method. 
# !/usr/bin/python3 
import os, sys 
os.chdir("d:\\tmp") 
print ("Current directory is: %s" %os.getcwd()) 
# listing directories 
print ("The dir is: %s"%os.listdir(os.getcwd())) 
# renaming file "aa1.txt" 
os.renames("foo.txt","newdir/foonew.txt") 
print ("Successfully renamed.") 
# listing directories after renaming and moving "foo.txt" 
print ("The dir is: %s" %os.listdir(os.getcwd())) 
os.chdir("newdir") 
print ("The dir is: %s" %os.listdir(os.getcwd())) 
When we run the above program, it produces the following result- 
Current directory is: d:\tmp 
The dir is: ['Applicationdocs.docx', 'book.zip', 'foo.txt', 'Java Multiple 
Inheritance.htm', 'Java Multiple Inheritance_files', 'java.ppt', 'python2'] 
Successfully renamed. 
The dir is: ['Applicationdocs.docx', 'book.zip', 'Java Multiple Inheritance.htm', 
'Java Multiple Inheritance_files', 'java.ppt', 'newdir', 'python2'] 
The file foo.txt is not visible here, as it is been moved to newdir and renamed 
as foonew.txt. The directory newdir and its contents are shown below: 
The dir is: ['foonew.txt']