cpython/Lib/pathlib
Barney Gale 01d91500ca
GH-128520: Make `pathlib._abc.WritablePath` a sibling of `ReadablePath` (#129014)
In the private pathlib ABCs, support write-only virtual filesystems by
making `WritablePath` inherit directly from `JoinablePath`, rather than
subclassing `ReadablePath`.

There are two complications:

- `ReadablePath.open()` applies to both reading and writing
- `ReadablePath.copy` is secretly an object that supports the *read* side
  of copying, whereas `WritablePath.copy` is a different kind of object
  supporting the *write* side

We untangle these as follow:

- A new `pathlib._abc.magic_open()` function replaces the `open()` method,
  which is dropped from the ABCs but remains in `pathlib.Path`. The
  function works like `io.open()`, but additionally accepts objects with
  `__open_rb__()` or `__open_wb__()` methods as appropriate for the mode.
  These new dunders are made abstract methods of `ReadablePath` and
  `WritablePath` respectively.  If the pathlib ABCs are made public, we
  could consider blessing an "openable" protocol and supporting it in
  `io.open()`, removing the need for `pathlib._abc.magic_open()`.
- `ReadablePath.copy` becomes a true method, whereas `WritablePath.copy` is
  deleted. A new `ReadablePath._copy_reader` property provides a
  `CopyReader` object, and similarly `WritablePath._copy_writer` is a
  `CopyWriter` object. Once GH-125413 is resolved, we'll be able to move
  the `CopyReader` functionality into `ReadablePath.info` and eliminate
  `ReadablePath._copy_reader`.
2025-01-21 18:35:37 +00:00
..
__init__.py GH-127807: pathlib ABCs: remove `PathBase._unsupported_msg()` (#127855) 2024-12-12 17:39:24 +00:00
_abc.py GH-128520: Make `pathlib._abc.WritablePath` a sibling of `ReadablePath` (#129014) 2025-01-21 18:35:37 +00:00
_local.py GH-128520: Make `pathlib._abc.WritablePath` a sibling of `ReadablePath` (#129014) 2025-01-21 18:35:37 +00:00
_os.py GH-127807: pathlib ABCs: move private copying methods to dedicated class (#127810) 2024-12-22 02:22:08 +00:00
_types.py GH-128520: Divide pathlib ABCs into three classes (#128523) 2025-01-11 19:27:47 +00:00