Mailman 3 April 2017 - docs

[issue29983] Reference TOC: expand 'Atoms' and 'Primaries'
by Terry J. Reedy April 4, 2017

April 4, 2017

New submission from Terry J. Reedy: Today there is a fairly long python-list thread about the difficult of finding info on 'dict comprehensions' in the doc. Point 1 is missing index entries. I opened #29981 for this. Point 2 is something I have also noticed: the obscurity of 'Atoms' and 'Primaries' as titles of sections in the Expressions chapter. These are fairly esoteric Computer Science language theory terms. Compare these to beginner-friendly 'Binary arithmetic operators' and '… [View More]

1 1

[issue29968] Document that no characters are allowed to proceed \ in explicit line joining
by Jim Fasarakis-Hilliard April 4, 2017

April 4, 2017

New submission from Jim Fasarakis-Hilliard: After looking through the code, the tokenizer only allows a new line character to proceed `\` in explicit line joining [1]. The Devguide section on it [2] actually states many of the limitations of using `\` but not directly that nothing is allowed after it (it does have a remark on comments). Would it be a good idea to amend it to state that no characters are allowed after `\`? [1]: https://github.com/python/cpython/blob/… [View More]

3 7

[issue29973] Travis CI docs broken: UnboundLocalError: local variable 'prefix' referenced before assignment
by STINNER Victor April 3, 2017

April 3, 2017

New submission from STINNER Victor: https://travis-ci.org/python/cpython/jobs/218107336 CPython: master branch Sphinx 1.5.4 make[1]: Entering directory `/home/travis/build/python/cpython/Doc' ./venv/bin/python -m sphinx -b suspicious -d build/doctrees -D latex_elements.papersize= -q -W . build/suspicious Exception occurred: File "/home/travis/virtualenv/python3.6.0/lib/python3.6/site-packages/sphinx/domains/python.py", line 317, in before_content if prefix: UnboundLocalError: local … [View More]

2 3

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by Dominic Mayers April 3, 2017

April 3, 2017

Dominic Mayers added the comment: The key point, IMHO, is that the BaseRequestHandler class is just provided as an option and its API (setup, handle and finish) is ignored by the code that we support. Some applications may have used the API, but these are details in applications. Simply, we keep BaseRequestHandler as it is so that we do not break these applications. So, yes, we should keep supporting the API, but we do not expect this API on our side. The latter is the key point. ---------… [View More]

1 0

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by Dominic Mayers April 3, 2017

April 3, 2017

Dominic Mayers added the comment: I started to look at the documentation to see what would need to be changed, assuming that we agree for a change in the API. Just for the purpose of this discussion, I created a patch that only change the comments in socketserver.py. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29947> _______________________________________

1 0

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by Dominic Mayers April 3, 2017

April 3, 2017

Changes by Dominic Mayers <dominic_mayers(a)yahoo.com>: ---------- keywords: +patch Added file: http://bugs.python.org/file46770/Issue29947_for_discussion.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29947> _______________________________________

1 0

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by Dominic Mayers April 3, 2017

April 3, 2017

Changes by Dominic Mayers <dominic_mayers(a)yahoo.com>: Removed file: http://bugs.python.org/file46768/factorymixinclass _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29947> _______________________________________

1 0

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by R. David Murray April 2, 2017

April 2, 2017

R. David Murray added the comment: Yes, the difficulty in renaming the parameter was why I suggested a doc change only. I'm not sure it it is worth it to go through a deprecation cycle for socketserver to change the name, though it certainly would be nice. Martin and I could make that decision, but it would be better to get input from other devs. And, if we make this the documentation issue, we should open a separate issue for the parameter rename. ---------- … [View More]

1 0

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by Dominic Mayers April 2, 2017

April 2, 2017

Dominic Mayers added the comment: I did not think very far when said that renaming the parameter could not possibly break the code ! Oh well ! But, renaming the parameter was not important in itself. It was to make the situation clearer and easier for those who write the documentation. Martin mentioned that it is a big change for the API. This is what I had in mind. And yes, I should have used 'factory function', not 'factory instance'. Oh well ! I am glad things are working and that we will … [View More]

1 0

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by Martin Panter April 2, 2017

April 2, 2017

Martin Panter added the comment: By “factory instance”, I presume you just mean a function (or class or method) that returns an appropriate object when called. (I think these are normally called “factory functions”. Instances are objects, the things that class constructors and factories return.) What is being proposed? The best idea that I understand is hinted in <https://bugs.python.org/issue29947#msg290976>. That is, to document and allow any function (not just a class or factory) to … [View More]

1 0