Message 257664 - Python tracker

➜

This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author	benhoyt
Recipients	benhoyt, ethan.furman, gvanrossum, pitrou, serhiy.storchaka, vstinner
Date	2016-01-07.01:06:52
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1452128813.43.0.0294991548565.issue26032@psf.upfronthosting.co.za>
In-reply-to

Content
Guido, it's true that in almost all cases you get the speedup (no system call), and it's very much worth using. But the idea with the docs being non-committal is because being specific would make the docs fairly complex. I believe it's as follows for is_file/is_dir/is_symlink: * no system call required on Windows or Unix if the entry is not a symlink * unless you're on Unix with some different file system (maybe a network FS?) where d_type is DT_UNKNOWN * some other edge case which I've probably forgotten :-) Do you think the docs should try to make this more specific?

Guido, it's true that in almost all cases you get the speedup (no system call), and it's very much worth using. But the idea with the docs being non-committal is because being specific would make the docs fairly complex. I believe it's as follows for is_file/is_dir/is_symlink:

* no system call required on Windows or Unix if the entry is not a symlink
* unless you're on Unix with some different file system (maybe a network FS?) where d_type is DT_UNKNOWN
* some other edge case which I've probably forgotten :-)

Do you think the docs should try to make this more specific?

History
Date	User	Action	Args
2016-01-07 01:06:53	benhoyt	set	recipients: + benhoyt, gvanrossum, pitrou, vstinner, ethan.furman, serhiy.storchaka
2016-01-07 01:06:53	benhoyt	set	messageid: <1452128813.43.0.0294991548565.issue26032@psf.upfronthosting.co.za>
2016-01-07 01:06:53	benhoyt	link	issue26032 messages
2016-01-07 01:06:52	benhoyt	create