[docs] [issue35183] os.path.splitext documentation needs typical example
Shaun Griffith
report at bugs.python.org
Wed Nov 7 06:49:13 EST 2018
New submission from Shaun Griffith <shaun.griffith.1964 at gmail.com>:
As with many entries on the os.path doc page, splitext needs a typical example. Not grokking the bare minimum text, I had to actually try it in the interpreter to see what it did.
The one example that *is* there is an edge case, and does nothing to explain the normal behavior, or why this is the correct behavior for the edge case.
Here is where I tripped up:
Split the pathname path into a pair (root, ext) such that root + ext == path, and ext is empty or begins with a period and contains at most one period.
One interpretation of this is that ext is either empty, or has a period, _and nothing else_.
Here are 2 examples for typical use:
>>> splitext('readme.txt')
('readme', '.txt')
>>> splitext('/some/long/pathname/warble.csv')
('/some/long/pathname/warble', '.csv')
----------
assignee: docs at python
components: Documentation
messages: 329414
nosy: docs at python, shaungriffith
priority: normal
severity: normal
status: open
title: os.path.splitext documentation needs typical example
type: enhancement
versions: Python 3.6
_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35183>
_______________________________________
More information about the docs
mailing list