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 shaungriffith
Recipients docs@python, shaungriffith
Date 2018-11-07.11:49:12
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1541591353.01.0.788709270274.issue35183@psf.upfronthosting.co.za>
In-reply-to
Content
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')
History
Date User Action Args
2018-11-07 11:49:13shaungriffithsetrecipients: + shaungriffith, docs@python
2018-11-07 11:49:13shaungriffithsetmessageid: <1541591353.01.0.788709270274.issue35183@psf.upfronthosting.co.za>
2018-11-07 11:49:12shaungriffithlinkissue35183 messages
2018-11-07 11:49:12shaungriffithcreate