Mailman 3 November 2016 - docs

[issue21501] submitting mmap example for use in documentation
by Steve Foley Nov. 6, 2016

Nov. 6, 2016

New submission from Steve Foley: Hello, I would like to submit an example for the mmap docs page. It demonstrates the use of shared memory and message passing between processes. Thanks! -------------------- import mmap, os, select NUM_CHILDREN = 30 MSG_LEN = 8 BUF_LEN = NUM_CHILDREN * MSG_LEN buf = mmap.mmap(-1, BUF_LEN) p = select.poll() def write_buffer(i): msg = '%s\t%d\n' % (i, os.getpid()) offset = MSG_LEN * i buf.seek(offset) buf.write(msg) def child(i, pipeout): write_buffer(i) os.write(pipeout, 'OK\0'.encode()) os._exit(0) def fork(i, p): pipein, pipeout = os.pipe() if os.fork() == 0: child(i, pipeout) else: p.register(pipein) def loop(msgs, p): while msgs: for fd, event in p.poll(): p.unregister(fd) msgs = msgs - 1 for i in range(NUM_CHILDREN): fork(i, p) loop(NUM_CHILDREN, p) buf.seek(0) print buf.read(BUF_LEN) ---------- assignee: docs@python components: Documentation messages: 218478 nosy: docs@python, hudson priority: normal severity: normal status: open title: submitting mmap example for use in documentation type: enhancement versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21501> _______________________________________

2 2

[issue28590] fstring's '{' from escape sequences does not start an expression
by Roundup Robot Nov. 6, 2016

Nov. 6, 2016

Roundup Robot added the comment: New changeset 1d8b8a67b657 by Jason R. Coombs in branch '3.6': Additionally show that a backslash-escaped opening brace is treated as a literal and thus triggers the single closing brace error, clarifying #28590. https://hg.python.org/cpython/rev/1d8b8a67b657 ---------- nosy: +python-dev _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28590> _______________________________________

1 0

[issue28590] fstring's '{' from escape sequences does not start an expression
by Jason R. Coombs Nov. 6, 2016

Nov. 6, 2016

Jason R. Coombs added the comment: The reason that those test_no_escapes_for_braces assertions pass is because they're only dealing with opening curly braces and in an f-string, they're treated as literal opening braces. In the example you've given, the error occurs when the f-string handler encounters the closing curly brace without an opening one. It's the same as if you had written: >>> f'{{4*10}' SyntaxError: f-string: single '}' is not allowed I will add a test to capture this specific case (backslash-escaped unicode opening bracken). ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28590> _______________________________________

1 0

[issue28590] fstring's '{' from escape sequences does not start an expression
by Jason R. Coombs Nov. 6, 2016

Nov. 6, 2016

Jason R. Coombs added the comment: I've got a patch ready for this and will be applying it shortly after we update the spec. ---------- assignee: docs@python -> jason.coombs nosy: +jason.coombs _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28590> _______________________________________

1 0

[issue28543] Incomplete fast path codecs aliases in codecs doc
by Xiang Zhang Nov. 6, 2016

Nov. 6, 2016

New submission from Xiang Zhang: The fast path codec aliases in codecs doc is complete especially after 99818330b4c0. ---------- assignee: docs@python components: Documentation files: codecs_doc.patch keywords: patch messages: 279538 nosy: docs@python, haypo, xiang.zhang priority: normal severity: normal stage: patch review status: open title: Incomplete fast path codecs aliases in codecs doc type: enhancement versions: Python 3.6, Python 3.7 Added file: http://bugs.python.org/file45241/codecs_doc.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28543> _______________________________________

2 1

Probable mistake in itertools docs
by Bo Bayles Nov. 5, 2016

Nov. 5, 2016

The docs for the itertools module (Python 2.7 and 3.5 at least) start with a section header and then a table with four columns: Iterator, Arguments, Results, Example. The first two sections fit this pattern. However, the third section, Combinatoric Generators, only has three columns in its table. The Example column is missing. Furthermore, the values in last four rows don't match their column header. It seems like the last four rows should have their values combined and placed in an Example column like the rest. Hope that makes sense. Many thanks! -Bo

1 0

[issue28616] sys.version_info.releaselevel - 'final' or 'release'
by Anish Tambe Nov. 4, 2016

Nov. 4, 2016

New submission from Anish Tambe: help(sys.version_info) suggests releaselevel is one among - | releaselevel | 'alpha', 'beta', 'candidate', or 'release' Notice that the last one is 'release'. But the implementation says current value is - 'final'. $ python Python 2.7.12 (default, Oct 11 2016, 05:24:00) [GCC 4.2.1 Compatible Apple LLVM 8.0.0 (clang-800.0.38)] on darwin Type "help", "copyright", "credits" or "license" for more information. >>> import sys >>> sys.version_info sys.version_info(major=2, minor=7, micro=12, releaselevel='final', serial=0) >>> $ python3 Python 3.5.2 (default, Oct 11 2016, 05:05:28) [GCC 4.2.1 Compatible Apple LLVM 8.0.0 (clang-800.0.38)] on darwin Type "help", "copyright", "credits" or "license" for more information. >>> import sys >>> sys.version_info sys.version_info(major=3, minor=5, micro=2, releaselevel='final', serial=0) >>> The documentation (https://docs.python.org/3/library/sys.html#sys.version_info or Doc/library/sys.rst) agrees with the implementation. The tests also agree with the implementation. grep for releaselevel and see - Lib/test/test_sys.py:504: self.assertIn(vi.releaselevel, ("alpha", "beta", "candidate", "final")) Hence, submitting a patch to change the help documentaion to reflect the correct value for releaselevel. [Motivation - I tried to print a warning to the user in case my app was not being run on a final release, and I tried to do that by equating releaselevel with 'release' as the help suggested.] ---------- assignee: docs@python components: Documentation files: releaselevel.patch keywords: patch messages: 280071 nosy: anish.tambe, docs@python priority: normal severity: normal status: open title: sys.version_info.releaselevel - 'final' or 'release' versions: Python 2.7, Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7 Added file: http://bugs.python.org/file45356/releaselevel.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28616> _______________________________________

3 2

[issue26980] The path argument of asyncio.BaseEventLoop.create_unix_connection is not documented
by texttheater Nov. 3, 2016

Nov. 3, 2016

New submission from texttheater: The documentation does not say what this argument is for. It says "See the BaseEventLoop.create_connection() method for parameters", but that method does not have a path argument. The argument seems to be required unless the keyword argument sock is given. ---------- assignee: docs@python components: Documentation messages: 265170 nosy: docs@python, texttheater priority: normal severity: normal status: open title: The path argument of asyncio.BaseEventLoop.create_unix_connection is not documented versions: Python 3.4, Python 3.5, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26980> _______________________________________

7 8

PythonBug
by Juliette Wood Nov. 3, 2016

Nov. 3, 2016

Hello, I registered to report a bug but haven't received a confirmation email yet. I saw that there is a solution, but the solution didn't work for me or I just need better instructions to solve the problem. When I go to install Python 3.5.2 for Windows 10, the message comes up 'The TARGETDIR variable ust be provided when invoking this installer.' When I followed the instructions provided, it said that it couldn't the program to install. Please help and point me in the direction of a place where I can see step by step instructions to install it. I'm not a programmer or IT person. I'm learning Python. Thanks for your help. I'm including a screen shot and log file. Regards, Juliette Juliette Wood Jim Wells County Appraisal District Mapping/Researcher 361-668-9656 ext. 14

1 0

[issue28597] f-string behavior is conflicting with its documentation
by Eric V. Smith Nov. 3, 2016

Nov. 3, 2016

Eric V. Smith added the comment: This is a duplicate of issue 28590. ---------- resolution: -> duplicate stage: -> resolved status: open -> closed superseder: -> fstring's '{' from escape sequences does not start an expression _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28597> _______________________________________

1 0