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 _______________________________________
-
anatoly techtonik -
Ezio Melotti
-
Georg Brandl
-
Giampaolo Rodola'
-
R. David Murray
-
Zachary Ware