[issue8940] *HTTPServer need a summary page with API inheritance table
New submission from anatoly techtonik <techtonik@gmail.com>: The abundance of methods and hierarchy depth of various servers from "Internet Protocols and Support" section makes it extremely hard to navigate information. You need a strong OOP background to be able to use this doc effectively, as examples are not intuitive otherwise. Usually you need a decent IDE (such as Eclipse) to get a picture of class hierarchy and a table of all available methods with a mark where they were inherited from. Such table (at least Class Hierarchy view screenshot from Eclipse) should be available in reference for descendant classes. ---------- assignee: docs@python components: Documentation messages: 107321 nosy: docs@python, techtonik priority: normal severity: normal status: open title: *HTTPServer need a summary page with API inheritance table versions: Python 2.7, Python 3.1, Python 3.2 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8940> _______________________________________
Ezio Melotti <ezio.melotti@gmail.com> added the comment: Can you provide a patch? ---------- nosy: +ezio.melotti stage: -> needs patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8940> _______________________________________
anatoly techtonik <techtonik@gmail.com> added the comment: No. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8940> _______________________________________
Georg Brandl <georg@python.org> added the comment: May I ask why? ---------- nosy: +georg.brandl _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8940> _______________________________________
Changes by Giampaolo Rodola' <g.rodola@gmail.com>: ---------- nosy: +giampaolo.rodola _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8940> _______________________________________
anatoly techtonik <techtonik@gmail.com> added the comment: 1. No time 2. Looks complicated ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8940> _______________________________________
Changes by R. David Murray <rdmurray@bitdance.com>: ---------- status: open -> languishing _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8940> _______________________________________
Zachary Ware <zachary.ware@gmail.com> added the comment: Lacking a clearer description of exactly what should be changed and with an official warning in the docs against using the http.server module in production, I'm going to go ahead and close the issue (which happened to be the last issue with "languishing" status). ---------- nosy: +zach.ware resolution: -> rejected stage: needs patch -> resolved status: languishing -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue8940> _______________________________________
participants (6)
-
anatoly techtonik -
Ezio Melotti
-
Georg Brandl
-
Giampaolo Rodola'
-
R. David Murray
-
Zachary Ware