[issue24852] Python 3.5.0rc1 "HOWTO Use Python in the web" needs fix
New submission from John Hagen: https://docs.python.org/3.5/howto/webservers.html#setting-up-fastcgi The "HOWTO Use Python in the web" documentation for 3.5.0rc1 prescribes to use flup in its example, which is not compatible with Python 3. This has led to some confusion: https://stackoverflow.com/questions/23482357/fastcgi-wsgi-library-in-python-... Perhaps the whole article could be given a once over to ensure it is still the best advice as of 2015. ---------- assignee: docs@python components: Documentation messages: 248491 nosy: John Hagen, docs@python priority: normal severity: normal status: open title: Python 3.5.0rc1 "HOWTO Use Python in the web" needs fix type: enhancement versions: Python 3.5 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue24852> _______________________________________
Berker Peksag added the comment: +1 I'd delete most of the CGI section, add a note about PEP 3333 and mention Gunicorn, uwsgi and Waitress. The frameworks section also needs a cleanup. Do you want to work on a patch? ---------- nosy: +berker.peksag stage: -> needs patch versions: +Python 3.4, Python 3.6 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue24852> _______________________________________
Georg Brandl added the comment: It's probably better to remove the document for now, and add a rewritten version back when it arrives. Although, this topic sees lot of change regularly, so it is probably not a good one for the standard documentation after all. ---------- nosy: +georg.brandl _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue24852> _______________________________________
John Hagen added the comment: A couple other notes I saw: The examples (https://docs.python.org/3.5/howto/webservers.html#setting-up-fastcgi) do not follow PEP 8 (should not have an encoding statement if it is UTF-8 Python 3) or the current guidance in PEP 394 to use "python3" in the shebang rather than "python". Unfortunately, I think I should defer writing the patch/new page to someone with more experience in the Python/web world. I am still pretty new to it. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue24852> _______________________________________
Raymond Hettinger added the comment:
It's probably better to remove the document for now
I concur.
Although, this topic sees lot of change regularly, so it is probably not a good one for the standard documentation after all.
This makes sense. We typically use wiki pages for this kind of material. For example, see the debugging tools page at: https://wiki.python.org/moin/PythonDebuggingTools ---------- nosy: +rhettinger _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue24852> _______________________________________
Berker Peksag added the comment: See issue 26497 for another report about this. I will remove Doc/howto/webservers.rst. ---------- versions: -Python 3.4 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue24852> _______________________________________
Roundup Robot added the comment: New changeset b8ee8f79a024 by Berker Peksag in branch '3.5': Issue #24852: Remove outdated "HOWTO Use Python in the web" document https://hg.python.org/cpython/rev/b8ee8f79a024 New changeset ee1d44f7d3e7 by Berker Peksag in branch 'default': Issue #24852: Remove outdated "HOWTO Use Python in the web" document https://hg.python.org/cpython/rev/ee1d44f7d3e7 ---------- nosy: +python-dev _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue24852> _______________________________________
Changes by Berker Peksag <berker.peksag@gmail.com>: ---------- resolution: -> fixed stage: needs patch -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue24852> _______________________________________
participants (5)
-
Berker Peksag -
Georg Brandl
-
John Hagen
-
Raymond Hettinger
-
Roundup Robot