Mailman 3 May 2018 - docs

[issue33431] Change description about doc in programming, faq.
by lvhuiyang 05 May '18

05 May '18

Change by lvhuiyang <ilvhuiyang(a)gmail.com>: ---------- assignee: docs@python components: Documentation nosy: docs@python, lvhuiyang priority: normal severity: normal status: open title: Change description about doc in programming, faq. type: performance versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33431> _______________________________________

1 0

[issue33417] Isinstance() behavior is not consistent with the document
by weapon 04 May '18

04 May '18

New submission from weapon <hongweichen8888(a)sina.com>: In the PEP 3119(https://www.python.org/dev/peps/pep-3119/),it introduce about Customizing instance and subclass checks. >The primary mechanism proposed here is to allow overloading the built-in functions isinstance() and issubclass(). The overloading works as follows: The call isinstance(x, C) first checks whether C.__instancecheck__ exists, and if so, calls C.__instancecheck__(x) instead of its normal implementation. but my code doesn't works. ``` class Sizeable(object): def __instancecheck__(cls, instance): print("__instancecheck__ call") return hasattr(instance, "__len__") class B(object): pass b = B() print(isinstance(b, Sizeable)) # output:False ``` The __instancecheck__ function is not called. In PyObject_IsInstance,when isinstance(x, C) the following three conditions are reached, __instancecheck__ will take effect: 1. x can not be directly instantiated by C; 2. The C class specifies the metaclass; 3. The __instancecheck__ in the specified metaclass class is defined. This code can work: ``` class MetaSizeable(type): def __instancecheck__(cls, instance): print("__instancecheck__ call") return hasattr(instance, "__len__") class Sizeable(metaclass=MetaSizeable): pass class B(object): pass b = B() print(isinstance(b, Sizeable)) # output: False print(isinstance([], Sizeable)) # output: True ``` So,the problem is that the document does not conform to the reality.Can it be guaranteed that __instancecheck__ is always called? If yes: PyObject_IsInstance should be tweaked. If no: document should be tweaked. ---------- assignee: docs@python components: Documentation, Interpreter Core messages: 316118 nosy: docs@python, hongweipeng priority: normal severity: normal status: open title: Isinstance() behavior is not consistent with the document type: behavior versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33417> _______________________________________

2 1

[issue26256] Fast decimalisation and conversion to other bases
by Cheryl Sabella 04 May '18

04 May '18

Cheryl Sabella <chekat2(a)gmail.com> added the comment: ping ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue26256> _______________________________________

1 0

[issue20722] newline is (partially) independent of universal newlines; needs to be made more clear in docs
by Devin Jeanpierre 03 May '18

03 May '18

New submission from Devin Jeanpierre: http://docs.python.org/3.4/library/functions.html#open says "newline controls how universal newlines mode works (it only applies to text mode)." My reading of this when I saw it was that newline= doesn't do anything unless universal newlines mode is enabled. This is untrue, and you can infer it's untrue from the following lines, but then the docs appear to contradict themselves. Please fix to say something more along the lines of "newline controls how newlines are read and written. It only applies to text mode." The interactions with universal newlines mode are explained in the following text, so they don't need to be called out upfront. newline does more than just that. ---------- assignee: docs@python components: Documentation messages: 211854 nosy: Devin Jeanpierre, docs@python priority: normal severity: normal status: open title: newline is (partially) independent of universal newlines; needs to be made more clear in docs versions: Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20722> _______________________________________

3 2

Your bind is invalid
by lionel Meloiq 03 May '18

03 May '18

Hello I can ’t download the bind to download the doc in my computer in a intempt of a answer

1 0

[issue33275] glob.glob should explicitly note that results aren't sorted
by Eryk Sun 02 May '18

02 May '18

Eryk Sun <eryksun(a)gmail.com> added the comment: FAT inserts a new file entry in a directory at the first available position. (If it's a long filename, this could be up to 21 contiguous dirents for a combined long/short dirent set.) This means a directory listing is usually in the same order that files were added. One caveat is that dirents for deleted files may be reused once there are no more unused entries available in a cluster. (I'd expect this depends on the implementation. Also, this is less likely with a long filename, since it needs a large-enough contiguous block of dirents.) Given a volume with a 4 KiB cluster size, sans overhead there are 127 32-byte dirents in a cluster. I used to have an MP3 player that used FAT32 and only played files in directory order, so I had to resort directories on disk after adding files. In Ubuntu Linux, I see there's a "fatsort" package that implements this. There's probably a build available for MacOS. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33275> _______________________________________

1 0

Missing change documentation
by Christopher Schmitt 02 May '18

02 May '18

Hello, Just found a missing "changed in version" text.... while the "os" lib has a "Changed in version 3.6: Accepts a path-like object." Text. This is totally missing in the shutil lib. (okay you could use the argument that shutil is using os lib and links to it but in the first moment it totally confused me why my script wasn't working on 3.5) Greetings, Christopher Schmitt

1 0

[issue33275] glob.glob should explicitly note that results aren't sorted
by Ben FrantzDale 02 May '18

02 May '18

Ben FrantzDale <ben(a)formlabs.com> added the comment: I looked into it a bit more. With python 2.7 on macOS High Sierra on APFS (Encrypted) with a FAT32 thumb drive... I have a directory that glob.glob('/Volumes/thumb/tmp/*') shows as sorted. I cp -r that to /tmp with bash. glob.glob('/tmp/tmp/*') is now not sorted. and cp -r /tmp/tmp /Volumes/thumb/tmp1. Then glob.glob('/Volumes/thumb/tmp/*') shows a different order, but if I cp -r /Volumes/thumb/tmp/ /Volumes/thumb/tmp2 then glob.glob('/Volumes/thumb/tmp2/*') is sorted by file name just like glob.glob('/Volumes/thumb/tmp/*'). I'm not sue what that's saying other than that glob.glob can return things out of order on FAT32. It appears that glob.glob's ordering agrees with that of ls -f ("unsorted"). ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33275> _______________________________________

1 0

Impossible de telecharger la documentation
by Vladimir Guillochet gmx 01 May '18

01 May '18

Bonjour, Le lien de téléchargement de la documentation python ne fonctionne pas. Pouvez vous y remédier ? Cordialement,

1 0