Issue 29976: urllib.parse clarify what ' ' in schemes mean (original) (raw)

urllib.parse has the following information in this module.

# A classification of schemes ('' means apply by default)
uses_relative = ['ftp', 'http', 'gopher', 'nntp', 'imap',
                 'wais', 'file', 'https', 'shttp', 'mms',
                 'prospero', 'rtsp', 'rtspu', '', 'sftp',
                 'svn', 'svn+ssh', 'ws', 'wss']

Note the '' in the list.

1. First it needs to be first one for easy identification.
2. It needs to be clarified. '' means apply by default does not help the reader.

https://github.com/python/cpython/pull/984 proposes a change. I'll need some reviews on this changed text.

Note: I am aware that there is an issue (long pending), which suggests deal away with these schemes at the top. If we get to that immediately, I will be happy, if not, consider this PR as the improvement over the status quo.