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 zach.ware
Recipients docs@python, nanjekyejoannah, orsenthil, syadlapalli, zach.ware
Date 2019-09-04.16:40:10
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1567615210.83.0.275039174655.issue37970@roundup.psfhosted.org>
In-reply-to
Content
I see.  I don't think we need to describe each returned component in the docstring; they're some combination of self-explanatory, described in the reference docs, or just industry-standard terms that are easily defined from other sources.  I'm not suggesting to add anything to the docstring about the `scheme` return component, but rather the *scheme* argument (which is the default value for the `scheme` return component when it's not found in the *url*).  The subcomponents of netloc should be mentioned because the docstring currently gives the impression that the user has to parse them out for themselves, which is not true.

Off the top of my head, I'd suggest changing the `urlsplit` docstring to something like:

```
Parse *url* and return a SplitResult.

SplitResult is a named 5-tuple of the following components:
<scheme>://<netloc>/<path>?<query>#<fragment>

The ``username``, ``password``, ``hostname``, and ``port``
sub-components of ``netloc`` can also be accessed as
attributes of the SplitResult object.

The *scheme* argument provides the default value of the
``scheme`` component when no scheme is found in *url*.

If *allow_fragments* is False, no attempt is made to
separate the ``fragment`` component from the previous
component, which can be either ``path`` or ``query``.

Note that % escapes are not expanded.
```
History
Date User Action Args
2019-09-04 16:40:10zach.waresetrecipients: + zach.ware, orsenthil, docs@python, nanjekyejoannah, syadlapalli
2019-09-04 16:40:10zach.waresetmessageid: <1567615210.83.0.275039174655.issue37970@roundup.psfhosted.org>
2019-09-04 16:40:10zach.warelinkissue37970 messages
2019-09-04 16:40:10zach.warecreate