[Python-checkins] bpo-28356: Document os.rename() behavior on Windows for differing volumes (GH-27376)
miss-islington
webhook-mailer at python.org
Mon Jan 9 16:52:29 EST 2023
https://github.com/python/cpython/commit/5c4afdf8bdcbd63f9833ca1223066d767f177001
commit: 5c4afdf8bdcbd63f9833ca1223066d767f177001
branch: 3.10
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2023-01-09T13:52:22-08:00
summary:
bpo-28356: Document os.rename() behavior on Windows for differing volumes (GH-27376)
(cherry picked from commit e098137cd3250af05f19380590b8dec79dc5942f)
Co-authored-by: Ryan Ozawa <ryan.ozawa21 at gmail.com>
files:
M Doc/library/os.rst
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 7a5efcf5d79b..e5fc63afdcf5 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -2302,6 +2302,8 @@ features:
will fail with an :exc:`OSError` subclass in a number of cases:
On Windows, if *dst* exists a :exc:`FileExistsError` is always raised.
+ The operation may fail if *src* and *dst* are on different filesystems. Use
+ :func:`shutil.move` to support moves to a different filesystem.
On Unix, if *src* is a file and *dst* is a directory or vice-versa, an
:exc:`IsADirectoryError` or a :exc:`NotADirectoryError` will be raised
More information about the Python-checkins
mailing list