The best answers to the question “How to move a file in Python?” in the category Dev.
I looked into the Python
os interface, but was unable to locate a method to move a file. How would I do the equivalent of
$ mv ... in Python?
>>> source_files="/PATH/TO/FOLDER/*" >>> destination_folder="PATH/TO/FOLDER" >>> # equivalent of $ mv source_files destination_folder
shutil.move() will both rename files, the command that is closest to the Unix mv command is
shutil.move(). The difference is that
os.rename() doesn’t work if the source and destination are on different disks, while
shutil.move() doesn’t care what disk the files are on.
All employ the same syntax:
import os import shutil os.rename("path/to/current/file.foo", "path/to/new/destination/for/file.foo") os.replace("path/to/current/file.foo", "path/to/new/destination/for/file.foo") shutil.move("path/to/current/file.foo", "path/to/new/destination/for/file.foo")
Note that you must include the file name (
file.foo) in both the source and destination arguments. If it is changed, the file will be renamed as well as moved.
Note also that in the first two cases the directory in which the new file is being created must already exist. On Windows, a file with that name must not exist or an exception will be raised, but
os.replace() will silently replace a file even in that occurrence.
As has been noted in comments on other answers,
shutil.move simply calls
os.rename in most cases. However, if the destination is on a different disk than the source, it will instead copy and then delete the source file.
For either the os.rename or shutil.move you will need to import the module.
No * character is necessary to get all the files moved.
We have a folder at /opt/awesome called source with one file named awesome.txt.
in /opt/awesome ○ → ls source ○ → ls source awesome.txt python >>> source="/opt/awesome/source" >>> destination = '/opt/awesome/destination' >>> import os >>> os.rename(source, destination) >>> os.listdir('/opt/awesome') ['destination']
We used os.listdir to see that the folder name in fact changed.
Here’s the shutil moving the destination back to source.
>>> import shutil >>> shutil.move(destination, source) >>> os.listdir('/opt/awesome/source') ['awesome.txt']
This time I checked inside the source folder to be sure the awesome.txt file I created exists. It is there 🙂
Now we have moved a folder and its files from a source to a destination and back again.
After Python 3.4, you can also use
Path to move file.
from pathlib import Path Path("path/to/current/file.foo").rename("path/to/new/destination/for/file.foo")