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.
Created on 2008年01月02日 18:31 by barry, last changed 2022年04月11日 14:56 by admin. This issue is now closed.
| Messages (7) | |||
|---|---|---|---|
| msg59102 - (view) | Author: Barry A. Warsaw (barry) * (Python committer) | Date: 2008年01月02日 18:33 | |
urllib.splithost() and .splittype() are included in urllib's __all__ but are not documented in urllib's module documentation. They are used quite extensively in the module so they should be documented |
|||
| msg59483 - (view) | Author: Georg Brandl (georg.brandl) * (Python committer) | Date: 2008年01月07日 19:22 | |
There are quite a lot more functions in __all__, more than 10 split* functions... should they all be documented? Also, isn't urlparse meant to do such tasks? |
|||
| msg59577 - (view) | Author: Senthil Kumaran (orsenthil) * (Python committer) | Date: 2008年01月09日 00:32 | |
> Georg Brandl added the comment: > > There are quite a lot more functions in __all__, more than 10 split* > functions... should they all be documented? > > Also, isn't urlparse meant to do such tasks? I agree. I too feel that not everything in the __all__ list should be documented. And in this specific case of splithost, it is more appropriate for the user to use urlparse. |
|||
| msg113210 - (view) | Author: Terry J. Reedy (terry.reedy) * (Python committer) | Date: 2010年08月07日 21:27 | |
When internal functions lack '_', perhaps the doc should say "xys,uie, and ooe are intentionally undocumented internal functions." Otherwise, how is one supposed to know? |
|||
| msg188014 - (view) | Author: Nathan Housel (plasticgap) | Date: 2013年04月28日 19:06 | |
This has been fixed in trunk, the split* methods have documentation and appear in the module docs.
See:
>>> help('urllib')
|
|||
| msg188263 - (view) | Author: Roundup Robot (python-dev) (Python triager) | Date: 2013年05月02日 12:50 | |
New changeset c3656dca65e7 by Senthil Kumaran in branch '2.7': # 1722 - Add a note on urllib helper functions like splittype, splithost etc. http://hg.python.org/cpython/rev/c3656dca65e7 |
|||
| msg188264 - (view) | Author: Senthil Kumaran (orsenthil) * (Python committer) | Date: 2013年05月02日 12:53 | |
I had added a note in the documentation c3656dca65e7 conveying that splittype, splithost should not be relied upon, and urlparse should be used for parsing. Also, Python3 does not include these in __all__ - It is in Python2 for backwards compatibility purposes. It is not possible provide deprecation warning to things we leave off from __all__ from subsequent versions of python. I consider this request as resolved. Thanks! |
|||
| History | |||
|---|---|---|---|
| Date | User | Action | Args |
| 2022年04月11日 14:56:29 | admin | set | github: 46063 |
| 2013年05月02日 12:53:36 | orsenthil | set | status: open -> closed resolution: fixed messages: + msg188264 versions: - Python 3.1, Python 3.2 |
| 2013年05月02日 12:50:36 | python-dev | set | nosy:
+ python-dev messages: + msg188263 |
| 2013年04月28日 19:06:57 | plasticgap | set | nosy:
+ plasticgap messages: + msg188014 |
| 2010年09月18日 18:38:01 | BreamoreBoy | set | assignee: georg.brandl -> docs@python nosy: + docs@python |
| 2010年08月07日 21:27:40 | terry.reedy | set | nosy:
+ terry.reedy messages: + msg113210 versions: - Python 2.6 |
| 2010年01月17日 07:26:00 | ezio.melotti | set | nosy:
+ ezio.melotti |
| 2010年01月15日 22:06:16 | brian.curtin | set | keywords:
+ easy stage: needs patch type: enhancement versions: + Python 2.6, Python 3.1, Python 2.7, Python 3.2, - Python 2.5 |
| 2008年01月09日 00:32:44 | orsenthil | set | nosy:
+ orsenthil messages: + msg59577 |
| 2008年01月07日 19:22:09 | georg.brandl | set | messages: + msg59483 |
| 2008年01月02日 18:47:22 | gvanrossum | set | assignee: georg.brandl nosy: + georg.brandl |
| 2008年01月02日 18:33:00 | barry | set | messages: + msg59102 |
| 2008年01月02日 18:31:39 | barry | create | |