Issue 23780: Surprising behaviour when passing list to os.path.join. (original) (raw)

Created on 2015-03-26 08:02 by The Compiler, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
join_datatype_check.patch r.david.murray,2015-03-26 14:56 review
join_datatype_check_2.patch serhiy.storchaka,2015-05-16 18:43 review
Messages (9)
msg239314 - (view) Author: Florian Bruhin (The Compiler) * Date: 2015-03-26 08:02
I just accidentally passed a list (instead of unpacking it) to os.path.join. I was surprised when it just returned the list unmodified: >>> os.path.join([1, 2, 3]) [1, 2, 3] Looking at the source, it simply returns the first argument (path = a; ...; return path) when the '*p' part is empty. I think a "genericpath._check_arg_types('join', a)" or similiar should be added at the top, or it should ensure the "*p" part is not empty (as the docstring says "two or more pathname components").
msg239315 - (view) Author: BoĊĦtjan Mejak (PedanticHacker) * Date: 2015-03-26 08:41
Using Python 3.4.3 on Windows 7 Home Premium 64 bit, Service Pack 1: >>> import os >>> os.path.join([1, 2, 3]) Traceback (most recent call last): File "", line 1, in File "C:\Program Files\Python 3.4\lib\ntpath.py", line 108, in join result_drive, result_path = splitdrive(path) File "C:\Program Files\Python 3.4\lib\ntpath.py", line 161, in splitdrive normp = p.replace(_get_altsep(p), sep) AttributeError: 'list' object has no attribute 'replace' I think this atribute error should be handled differently, like informing the programmer that you cannot use a list in the join method.
msg239335 - (view) Author: R. David Murray (r.david.murray) * (Python committer) Date: 2015-03-26 14:56
Python's philosophy is one of duck typing, which means that in general we just let the functions fail with whatever error they produce when the in put datatype is wrong. The error message in this case is fairly straightforward: you passed a list and it says that that data type doesn't work. The linux case is a bit more problematic in that it *doesn't* produce an error for invalid input. The problem there is that we can't raise an error if there's only one argument for backward compatibility reasons: there almost certainly exists code that depends on single argument path returning the argument. In theory there shouldn't be code that depends on that single argument being an incorrect data type, but it would still only be something we'd consider changing in a feature release. I'm not sure it is worth fixing, frankly, but I've attached a patch we could consider applying to 3.5. (aside: the isinstance check in _get_sep looks like a bug report waiting to happen...it will do the wrong thing if passed a bytearray or memoryview...) There may be others who will advocate for a stricter type check or a try/except with a "better" error message...I'd be OK with the better error message as long as it doesn't break the duck typing rule.
msg239340 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2015-03-26 15:33
Error message for ntpath is improved in 3.5. >>> import ntpath >>> ntpath.join([1, 2, 3]) Traceback (most recent call last): File "", line 1, in File "/home/serhiy/py/cpython/Lib/ntpath.py", line 111, in join genericpath._check_arg_types('join', path, *paths) File "/home/serhiy/py/cpython/Lib/genericpath.py", line 143, in _check_arg_types (funcname, s.__class__.__name__)) from None TypeError: join() argument must be str or bytes, not 'list' I'm not sure that the case of single argument in posixpath.join needs a fix. First, any argument checks have a cost. Second, currently os.path works with string-like objects if they implement enough string methods. But David's proposition looks enough harmless (but this line should be added inside the try block). Do you want to add tests David? If apply it to posixpath, it should by applied to ntpath too, because currently ntpath.join doesn't raise an exceptions for empty list. > (aside: the isinstance check in _get_sep looks like a bug report waiting to happen...it will do the wrong thing if passed a bytearray or memoryview...) It is documented that os.path only works with strings and bytes objects. It also can work with str-like objects if lucky.
msg239344 - (view) Author: R. David Murray (r.david.murray) * (Python committer) Date: 2015-03-26 15:58
No, I'm not going to write tests...my goal is to commit other people's patches, and I haven't even found time for that lately. And like you, I'm not convinced the fix is needed. There is one argument I can think of in favor, though: currently code that doesn't raise an error on posix will raise an error on Windows, and there is some portability value in making this consistent. (Side note: the fact that join works with things that look enough like strings is important, because I'm sure that there are pathlib-like libraries out there that pretend to be strings so that they can be used in things like path.join.)
msg243334 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2015-05-16 16:58
Here is extended patch, with tests.
msg243350 - (view) Author: Florian Bruhin (The Compiler) * Date: 2015-05-16 18:26
Serhiy, I don't see a new patch added - did you forget to attach it or am I missing something? :)
msg243355 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2015-05-16 18:43
Oh, sorry, I forget to attach it.
msg243565 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2015-05-19 08:00
New changeset 84af71e8c051 by Serhiy Storchaka in branch 'default': Issue #23780: Improved error message in os.path.join() with single argument. https://hg.python.org/cpython/rev/84af71e8c051
History
Date User Action Args
2022-04-11 14:58:14 admin set github: 67968
2015-05-21 16:21:25 serhiy.storchaka set status: open -> closedresolution: fixedstage: patch review -> resolved
2015-05-19 08:00:55 python-dev set nosy: + python-devmessages: +
2015-05-16 18:43:07 serhiy.storchaka set files: + join_datatype_check_2.patchmessages: +
2015-05-16 18:26:24 The Compiler set messages: +
2015-05-16 16:58:39 serhiy.storchaka set assignee: serhiy.storchakastage: patch reviewmessages: + versions: - Python 3.4
2015-03-26 15:58:26 r.david.murray set messages: +
2015-03-26 15:33:52 serhiy.storchaka set messages: +
2015-03-26 14:56:55 r.david.murray set files: + join_datatype_check.patchnosy: + r.david.murraymessages: + keywords: + patch
2015-03-26 08:46:07 PedanticHacker set versions: + Python 3.5
2015-03-26 08:41:01 PedanticHacker set nosy: + PedanticHackermessages: +
2015-03-26 08:02:03 The Compiler create