Issue 27182: PEP 519 support in the stdlib (original) (raw)

Issue27182

Created on 2016-06-02 17:16 by ethan.furman, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
issue27182-open.patch JelleZijlstra,2016-06-03 18:45 patch adding fspath support to builtins.open review
issue27182-path_type.patch JelleZijlstra,2016-06-04 17:36 review
test_fspath.py ethan.furman,2016-06-04 22:31
os.diff brett.cannon,2016-08-12 19:27 Support for os.walk() and os.fwalk() (depends on path_converter) review
Messages (21)
msg266891 - (view) Author: Ethan Furman (ethan.furman) * (Python committer) Date: 2016-06-02 17:16
Meta issue to track adding PEP 519 support in the various stdlib modules.
msg266892 - (view) Author: Ethan Furman (ethan.furman) * (Python committer) Date: 2016-06-02 17:18
posix module:
msg266893 - (view) Author: Ethan Furman (ethan.furman) * (Python committer) Date: 2016-06-02 17:21
importlib:
msg266897 - (view) Author: Ethan Furman (ethan.furman) * (Python committer) Date: 2016-06-02 17:30
nt module:
msg266901 - (view) Author: Ethan Furman (ethan.furman) * (Python committer) Date: 2016-06-02 18:23
os.fspath():
msg266908 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2016-06-02 18:36
Isn't the nt module just an alias of the posix module?
msg266953 - (view) Author: Ethan Furman (ethan.furman) * (Python committer) Date: 2016-06-02 21:11
Nope. There is a posixpath.py and an ntpath.py, and they are not the same.
msg267123 - (view) Author: Jelle Zijlstra (JelleZijlstra) * (Python committer) Date: 2016-06-03 18:01
FYI, I'm working on a patch for builtins.open to call PyOS_FSPath.
msg267131 - (view) Author: Jelle Zijlstra (JelleZijlstra) * (Python committer) Date: 2016-06-03 18:45
This patch makes the Python and C versions of open()/io.open() support the fspath protocol.
msg267132 - (view) Author: Ethan Furman (ethan.furman) * (Python committer) Date: 2016-06-03 18:45
Sorry, Serhiy, I had my module names mixed up. `nt` and `posix` are the same, but `ntpath` and `posixpath` are not (I may have those first two names wrong again, but hopefully you get the idea).
msg267280 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2016-06-04 17:19
New changeset 00991aa5fdb5 by Ethan Furman in branch 'default': : update fsencode and fsdecode for os.path(); patch by Dusty Phillips https://hg.python.org/cpython/rev/00991aa5fdb5
msg267282 - (view) Author: Jelle Zijlstra (JelleZijlstra) * (Python committer) Date: 2016-06-04 17:24
In the patch that was just committed, the path_type variables are undefined (os.py lines 892 and 908). There is also no test for these error cases—we should test the cases where the path has no __fspath__ or does not return a bytes or str.
msg267287 - (view) Author: Jelle Zijlstra (JelleZijlstra) * (Python committer) Date: 2016-06-04 17:36
Attached patch fixes the undefined variable and adds additional tests.
msg267335 - (view) Author: Ethan Furman (ethan.furman) * (Python committer) Date: 2016-06-04 22:31
Currently, os.fspath will raise an exception if the thing passed in is not str/bytes/PathLike, and that error message will proclaim that str or bytes or PathLike is required; however, this is not true in cases such as Path (which doesn't allow bytes), and incomplete in cases such as os.open (which also allows ints). On the other hand, if the thing has a functional __fspath__ (meaning calling it doesn't raise an exception) then os.fspath will return whatever that method returns, which could be complete garbage. So os.fspath is being too strict, too open, and too lax all at the same time. Given Guido's reluctance to check the output of __fspath__(), plus the current difficulty of painless integration with existing functions, I think we should have os.fspath() only raise an exception if obj.__fspath__ exists and calling it raises an exception, otherwise we return the result of calling obj.__fspath__(), or obj if it doesn't have __fspath__. In case that wasn't clear, attached is a unit test that passes when the above changes are implemented.
msg267340 - (view) Author: Jelle Zijlstra (JelleZijlstra) * (Python committer) Date: 2016-06-04 22:59
If we do that, then os.* functions that accept fds would also work on objects whose __fspath__ method returns an integer. I don't think that is desirable (I was just writing a test to ensure that fspath returning an integer throws an error).
msg267457 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2016-06-05 18:45
Functions that only accept file descriptors should not be updated to work with __fspath__() as it will never return an int/fd. As for Ethan's suggestion, are you saying you want to toss the str/bytes check from os.fspath()? If so then you will need to go to python-dev and bring that up as the PEP clearly specifies that str/bytes is checked for and specifically in the order of the Python code. The thinking behind the current design is that since __fspath__() has to be explicitly implemented that people will do so properly, versus accidentally passing in some type that isn't str/bytes like the pre-PEP 519 world (i.e. trust the __fspath__() implementors to do the right thing and only protect against someone passing in something wrong from complicated code flow). There has been discussion about using the ``path.__fspath__() if hasattr(path, '__fspath__') else path`` idiom in os.path so that the pre-existing type-checks can do their thing instead of checking twice, although that's different from how os.fspath() works (then again, since this is all new code we could argue that going our own route in os.path is acceptable in the name of performance).
msg268065 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2016-06-09 22:58
New changeset 6239673d5e1d by Brett Cannon in branch 'default': Issue #27182: Document os.PathLike. https://hg.python.org/cpython/rev/6239673d5e1d
msg272063 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2016-08-05 22:00
Just a quick update: between the patches for issue #26027 and issue #26667, the necessary code to make os.path work with path-like objects is done. At this point I'm just waiting for code reviews on those patches.
msg272559 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2016-08-12 19:27
Here is an odd patch because I don't know where else to put it ATM that adds the remaining support in the os module/package not covered by other issues w/ patches (specifically os.walk() and os.fwalk()). I think everything else simply falls through thanks to os.path and path_converter.
msg273737 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2016-08-26 21:49
The os and os.path modules are now done! The means PEP 519 is finished. At this point individual modules will need to be checked to see if they do (not) support os.PathLike.
msg274712 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2016-09-07 02:36
New changeset 3417d324cbf9 by Brett Cannon in branch 'default': Issue #27182: Add support for path-like objects to PyUnicode_FSDecoder(). https://hg.python.org/cpython/rev/3417d324cbf9
History
Date User Action Args
2022-04-11 14:58:31 admin set github: 71369
2020-11-06 19:37:09 brett.cannon set status: open -> closedresolution: fixedstage: resolved
2016-09-07 02:36:31 python-dev set messages: +
2016-08-26 21:49:44 brett.cannon set assignee: brett.cannon ->
2016-08-26 21:49:37 brett.cannon set messages: +
2016-08-12 19:27:20 brett.cannon set files: + os.diffmessages: +
2016-08-05 22:00:35 brett.cannon set messages: +
2016-06-24 20:43:30 brett.cannon set dependencies: - Add a "What's New" entry for PEP 519
2016-06-09 23:02:31 brett.cannon set assignee: brett.cannondependencies: + Add a "What's New" entry for PEP 519
2016-06-09 22:58:15 python-dev set messages: +
2016-06-05 18:45:39 brett.cannon set messages: +
2016-06-04 22:59:34 JelleZijlstra set messages: +
2016-06-04 22:31:40 ethan.furman set files: + test_fspath.pymessages: +
2016-06-04 20:30:27 ethan.furman set messages: +
2016-06-04 19:10:17 ethan.furman set messages: -
2016-06-04 17:36:12 JelleZijlstra set files: + issue27182-path_type.patchmessages: +
2016-06-04 17:24:54 JelleZijlstra set messages: +
2016-06-04 17:19:55 python-dev set nosy: + python-devmessages: +
2016-06-03 18:45:52 ethan.furman set messages: +
2016-06-03 18:45:49 JelleZijlstra set files: + issue27182-open.patchkeywords: + patchmessages: +
2016-06-03 18:01:55 JelleZijlstra set nosy: + JelleZijlstramessages: +
2016-06-02 21:11:39 ethan.furman set messages: +
2016-06-02 18:36:55 serhiy.storchaka set messages: +
2016-06-02 18:23:01 ethan.furman set dependencies: + add os.fspath()messages: +
2016-06-02 17:39:35 ethan.furman set type: behavior -> enhancement
2016-06-02 17:38:54 ethan.furman set dependencies: + Support Path objects in the posix module, Update importlib to accept pathlib.Path objects, Support path objects in the ntpath moduletype: behaviorversions: + Python 3.6
2016-06-02 17:30:33 ethan.furman set messages: +
2016-06-02 17:21:29 ethan.furman set messages: +
2016-06-02 17🔞33 ethan.furman set messages: +
2016-06-02 17:16:29 ethan.furman create