Mailman 3 August 2018 - docs

[issue34369] kqueue.control() documentation and implementation mismatch
by Tal Einat 12 Aug '18

12 Aug '18

Tal Einat <taleinat(a)gmail.com> added the comment: In Python 3.8 this will have already been fixed (thanks to the recent conversion of the select module to use Argument Clinic); see below output from a recent build from the master branch. Given that, is this worth fixing on 2.7 and <3.8? Help on built-in function control: control(changelist, maxevents, timeout=None, /) method of select.kqueue instance Calls the kernel kevent function. changelist Must be an iterable of kevent objects describing the changes to be made to the kernel's watch list or None. maxevents The maximum number of events that the kernel will return. timeout The maximum time to wait in seconds, or else None to wait forever. This accepts floats for smaller timeouts, too. ---------- versions: +Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34369> _______________________________________

1 0

(no subject)
by Ajay Kumar 12 Aug '18

12 Aug '18

can you please send Me any related pdf notes in python with new version

1 0

[issue34369] kqueue.control() documentation and implementation mismatch
by Martin Panter 12 Aug '18

12 Aug '18

Martin Panter <vadmium+py(a)gmail.com> added the comment: I think this was an attempt to specify a positional-only parameter (by using square brackets), and include a default value in the signature. The usual approach in this situation is to use square brackets, but only mention the default value in the text: control(changelist, max_events[, timeout]) . . . The default for "timeout" is None, to wait forever. In Issue 13386 Ezio suggested against showing both square brackets and a default value, and I agree. Berker: your "select" and "poll" cases all include the PEP 457 slash "/" notation, which was supposed to indicate positional-only parameters. See Issue 21314 about explaining this notation in the documentation somewhere. ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python, martin.panter versions: +Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34369> _______________________________________

1 0

[issue34379] Move note about repeated calls to json.dump using the same fp to the json.dump section
by Evan Allrich 11 Aug '18

11 Aug '18

New submission from Evan Allrich <psf(a)allri.ch>: At present the note [0] appears under the documentation for `json.dumps` (which does not use the `fp` argument). It seems the note would be better placed with the documentation for the affected function. [0] > Note > > Unlike pickle and marshal, JSON is not a framed protocol, so trying to > serialize multiple objects with repeated calls to dump() using the same > fp will result in an invalid JSON file. ---------- assignee: docs@python components: Documentation messages: 323396 nosy: docs@python, eallrich priority: normal severity: normal status: open title: Move note about repeated calls to json.dump using the same fp to the json.dump section type: enhancement versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34379> _______________________________________

3 7

[issue34378] Documentation 3.5+
by Karan 11 Aug '18

11 Aug '18

New submission from Karan <karan.svnit(a)gmail.com>: The documentation link for 3.5+ is having an issue with the left sidebar where the index is present. In 2.7 if I scroll the main doc below to mid of the document the sidebar still shows me the index. The same is not present in the 3.5+. I know this is a very minor thing but for a new learner like me who is constantly reading these docs, this very small thing irritates a lot. Thanks ---------- assignee: docs@python components: Documentation files: imgonline-com-ua-twotoone-eLRSfZftmcsz.jpg messages: 323393 nosy: Kapple, docs@python priority: normal severity: normal status: open title: Documentation 3.5+ type: behavior versions: Python 3.5, Python 3.6, Python 3.7, Python 3.8 Added file: https://bugs.python.org/file47745/imgonline-com-ua-twotoone-eLRSfZftmcsz.jpg _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34378> _______________________________________

2 1

[issue34324] Doc README wrong directory name for vent
by Lysandros Nikolaou 09 Aug '18

09 Aug '18

New submission from Lysandros Nikolaou <lisandrosnik(a)gmail.com>: In the Doc README there is the following sentence after the make venv command: Assuming the virtual environment was created in the env directory (the default; configurable with the VENVDIR variable) Should't it be venv directory instead? In the makefile the VENVDIR variable is set to venv by default. ---------- assignee: docs@python components: Documentation messages: 322997 nosy: docs@python, lys.nikolaou priority: normal severity: normal status: open title: Doc README wrong directory name for vent versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34324> _______________________________________

4 9

from opc ua import client Security Policy not Supported
by Pol Pujols 09 Aug '18

09 Aug '18

Hello, I am working with opc ua client package in python and i have seen that Basic256Sha256 policy is not Supported. client.set_security_string("Basic256Sha256,SignAndEncrypt,,certificate-example.der,private-key-example.pem") I have looked for info but I haven't seen nothing related just Basic256 or others Is it a Bug or is something getting under development? Is it going to last? since I am working on it and it would be really usefull to have it avaliable. Have a nice day, Sincerely, Pol

1 0

[issue28044] Make the sidebar in the documentation follow the section automatically
by Batiste 08 Aug '18

08 Aug '18

New submission from Batiste: Hi, Here is a small patch for the documentation that make the sidebar follow the headers while scrolling through a long page. http://imgur.com/UsrFAti Test on Chrome and Firefox. Seems to work like a charm. ---------- assignee: docs@python components: Documentation files: following-sidebar.patch keywords: patch messages: 275315 nosy: batiste, docs@python priority: normal severity: normal status: open title: Make the sidebar in the documentation follow the section automatically type: enhancement Added file: http://bugs.python.org/file44502/following-sidebar.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28044> _______________________________________

5 10

BUG - pdb with asyncio
by Dudi Kovarski 07 Aug '18

07 Aug '18

Hi, I think I found a bug on python(pdb/asyncio) version 3.5.2. The BUG shows up when debugging a code using pdb and the last row in the method is: await func(...) What's happening is that on execute this last line ('await'), the pdb get stuck and never back, BUT, if I'm adding one more row below in the same method, everything is ok. Thanks, Dudi -- * Dudi Kovarski* * Senior Software Developer, CyberMDX* * Mobile: +972533332826* [image: /Users/JonR/Library/Containers/com.microsoft.Outlook/Data/Library/Caches/Signatures/signature_991614229] <http://www.cybermdx.com/>

1 0

[issue34273] %f is confusingly associated with fixed point format
by Michael Fischer 06 Aug '18

06 Aug '18

New submission from Michael Fischer <michael-fischer89(a)web.de>: In section "7.1.3.1. Format Specification Mini-Language" of the documentation (https://docs.python.org/2/library/string.html) both %f and %F are labelled "Fixed point". This is confusing for someone who a) transitions over from C or variants or b) knows the difference between fixed and floating point numbers. I suggest either changing the "Fixed" to "Floating" or explaining what is meant by "Fixed Point" (because I'm sure there's a reason why someone has named it like that in the first place). ---------- assignee: docs@python components: Documentation messages: 322644 nosy: MikeFoxtrot, docs@python priority: normal severity: normal status: open title: %f is confusingly associated with fixed point format type: enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34273> _______________________________________

4 13