diff options
| author | Barney Gale <barney.gale@gmail.com> | 2021-04-23 20:48:52 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-04-23 20:48:52 (GMT) |
| commit | f24e2e5464ba6498e7b8d73c3f9b417d59fd1b26 (patch) | |
| tree | cef5b64a2c1c204cc45ec778be4689f0ed5d811d /Doc/whatsnew | |
| parent | e047239eafefe8b19725efffe7756443495cf78b (diff) | |
| download | cpython-f24e2e5464ba6498e7b8d73c3f9b417d59fd1b26.zip cpython-f24e2e5464ba6498e7b8d73c3f9b417d59fd1b26.tar.gz cpython-f24e2e5464ba6498e7b8d73c3f9b417d59fd1b26.tar.bz2 | |
bpo-39950: add `pathlib.Path.hardlink_to()` method that supersedes `link_to()` (GH-18909)
The argument order of `link_to()` is reversed compared to what one may expect, so:
a.link_to(b)
Might be expected to create *a* as a link to *b*, in fact it creates *b* as a link to *a*, making it function more like a "link from". This doesn't match `symlink_to()` nor the documentation and doesn't seem to be the original author's intent.
This PR deprecates `link_to()` and introduces `hardlink_to()`, which has the same argument order as `symlink_to()`.
Diffstat (limited to 'Doc/whatsnew')
| -rw-r--r-- | Doc/whatsnew/3.10.rst | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/Doc/whatsnew/3.10.rst b/Doc/whatsnew/3.10.rst index 86cf11f..247749a 100644 --- a/Doc/whatsnew/3.10.rst +++ b/Doc/whatsnew/3.10.rst @@ -1007,6 +1007,11 @@ Added negative indexing support to :attr:`PurePath.parents <pathlib.PurePath.parents>`. (Contributed by Yaroslav Pankovych in :issue:`21041`) +Added :meth:`Path.hardlink_to <pathlib.Path.hardlink_to>` method that +supersedes :meth:`~pathlib.Path.link_to`. The new method has the same argument +order as :meth:`~pathlib.Path.symlink_to`. +(Contributed by Barney Gale in :issue:`39950`.) + platform -------- @@ -1363,6 +1368,10 @@ Deprecated (Contributed by Jelle Zijlstra in :issue:`21574`.) +* :meth:`pathlib.Path.link_to` is deprecated and slated for removal in + Python 3.12. Use :meth:`pathlib.Path.hardlink_to` instead. + (Contributed by Barney Gale in :issue:`39950`.) + Removed ======= |