Author asvetlov
Recipients asvetlov, docs@python, pitrou
Date 2016-08-28.19:07:12
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1472411232.42.0.47360960084.issue27886@psf.upfronthosting.co.za>
In-reply-to
Content
Hi.

On reading the doc for pathlib I've stuck with `.rename()` and `.replace()` (https://docs.python.org/3/library/pathlib.html#pathlib.Path.rename).

What's the difference?

Going to pathlib's source code I've figured out that methods are use different functions from `os` module: `os.rename()` and `os.replace()`.

But the documentation for `os` module is not obvious too: 
the docs for both functions are almost equal from my perspective, the only significant difference is that `os.rename()` suggests to use `os.replace()` for cross-compatibility.

Could anybody explain the difference?

Also, at least the doc for `pathlib.Path.rename` worth to have a sentence like borrowed from `os.rename`: "If you want cross-platform overwriting of the destination, use replace()."
History
Date User Action Args
2016-08-28 19:07:12asvetlovsetrecipients: + asvetlov, pitrou, docs@python
2016-08-28 19:07:12asvetlovsetmessageid: <1472411232.42.0.47360960084.issue27886@psf.upfronthosting.co.za>
2016-08-28 19:07:12asvetlovlinkissue27886 messages
2016-08-28 19:07:12asvetlovcreate