Mailman 3 March 2017 - docs

[issue21071] struct.Struct.format is bytes, but should be str
by Martin Panter March 27, 2017

March 27, 2017

Martin Panter added the comment: Hi Victor, I’m not sure about changing the data type. As Python 3 grows older, there is potentially more code being written that you break by fixing a bug like this. It is incompatible if you used to write >>> print(struct.Struct('hi').format.decode()) hi I have used this decode() trick in the past to build composite format strings; e.g.: <https://bugs.python.org/issue16349#msg174083>. If you change the data type this code will raise AttributeError. At a minimum you should acknowledge it in the “porting” section of What’s New. Also, if you make this change, maybe update the module doc string. See the end of format-str.patch. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21071> _______________________________________

2 1

[issue21071] struct.Struct.format is bytes, but should be str
by Serhiy Storchaka March 27, 2017

March 27, 2017

Serhiy Storchaka added the comment: This should be discussed on Python-Dev first. I already raised this issue on Python-Dev, but don't remember what is the result. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21071> _______________________________________

1 0

[issue21071] struct.Struct.format is bytes, but should be str
by STINNER Victor March 27, 2017

March 27, 2017

STINNER Victor added the comment: I created https://github.com/python/cpython/pull/845 to change struct.Struct.format type to str (Unicode). struct.Struct() accepts bytes and str format strings, so it's not really a backward incompatible change. It's just a minor enhancement to help development: $ ./python Python 3.7.0a0 (heads/master-dirty:b8a7daf, Mar 27 2017, 13:02:20) >>> print(struct.Struct('hi').format) hi Without the patch: haypo@selma$ python3 Python 3.5.2 (default, Sep 14 2016, 11:28:32) [GCC 6.2.1 20160901 (Red Hat 6.2.1-1)] on linux Type "help", "copyright", "credits" or "license" for more information. >>> import struct >>> print(struct.Struct('hi').format) b'hi' haypo@selma$ python3 -bb Python 3.5.2 (default, Sep 14 2016, 11:28:32) >>> import struct >>> print(struct.Struct('hi').format) Traceback (most recent call last): ... BytesWarning: str() on a bytes instance ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21071> _______________________________________

1 0

[issue21071] struct.Struct.format is bytes, but should be str
by STINNER Victor March 27, 2017

March 27, 2017

Changes by STINNER Victor <victor.stinner(a)gmail.com>: ---------- pull_requests: +743 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21071> _______________________________________

1 0

[issue29913] ipadress compare_networks does not work according to documentation
by Xiang Zhang March 27, 2017

March 27, 2017

Xiang Zhang added the comment: +1 for the doc change. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29913> _______________________________________

1 0

[issue29913] ipadress compare_networks does not work according to documentation
by Nick Coghlan March 27, 2017

March 27, 2017

Nick Coghlan added the comment: Right, I agree compare_networks() is behaving correctly according to its original design. However: - it was designed for Python 2, where cmp() style idioms were still more common. Those idioms have largely been removed in Python 3 (no cmp() builtin, no __cmp__ magic method, no cmp argument to list.sort() and sorted()) - it was designed for the ipaddr data model, where network equality comparisons are more like ipaddress.ip_interface comparisons than they ipaddress.ip_network comparisons Since there isn't any real maintenance burden in keeping the code around, I'm flipping this to be purely a documentation issue and suggesting that we: - mark the method as deprecated in the docs, but *not* in the code (using the method form is just kind of pointless, not actively harmful) - update the docs to say that it uses the same ordering and comparison algorithm as "<", "==", and ">" (the current confusion stems from the fact that the algorithms were different in ipaddr, but in the stdlib that other algorithm is the one used by interface objects, not network objects) ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python stage: -> needs patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29913> _______________________________________

1 0

Next iteration
by Chris Partin March 27, 2017

March 27, 2017

Hi I'm using the latest python idle and as an old school linux/unix user feel it would be a good addition if when in the idle I could press the up arrow to get the last command I typed in. Thanks Chris ________________________________ This email and any files transmitted with it are confidential and intended solely for the use of the individual or entity to whom they are addressed. If you have received this email in error please notify the system manager. This message contains confidential information and is intended only for the individual named. If you are not the named addressee you should not disseminate, distribute or copy this e-mail. Please notify the sender immediately by e-mail if you have received this e-mail by mistake and delete this e-mail from your system. If you are not the intended recipient you are notified that disclosing, copying, distributing or taking any action in reliance on the contents of this information is strictly prohibited. ________________________________

1 0

[issue29888] The link referring to "Python download page" is broken
by Kinebuchi Tomohiko March 27, 2017

March 27, 2017

New submission from Kinebuchi Tomohiko: The download page [1]_ contains a link intended to refer to the release page of the corresponding Python version [2]_. .. [1] `Download Python 2.7.13 Documentation <https://docs.python.org/2.7/download.html>`_ .. [2] e.g. `Python 2.7.8 Release <https://www.python.org/download/releases/2.7.8/>`_ Although, this link is broken for three reasons. 1. Wrong template syntax `Present code <https://github.com/python/cpython/blob/2.7/Doc/tools/templates/download.htm…>`_:: <p>{% trans download_page="https://www.python.org/download/releases/{{ release[:5] }}/" %}HTML Help (<tt>.chm</tt>) files are made available in the "Windows" section on the <a href={{ download_page }}>Python download page</a>.{% endtrans %}</p> Fixed code:: <p>{% trans download_page="https://www.python.org/download/releases/" + release[:5] + "/" %}HTML Help (<tt>.chm</tt>) files are made available in the "Windows" section on the <a href="{{ download_page }}">Python download page</a>.{% endtrans %}</p> 2. Unexpected version number The URL contains a Python version string (i.e. ``release[:5]``), but for Python 2.7.13, ``release[:5]`` evaluates to ``'2.7.1'`` which obviously wrong as a version string. 3. Non-existent release pages for some versions www.python.org has pages which URLs are https://www.python.org/download/releases/<version>/ with <version> = 2.7.1--8, although has no pages with <version> = 2.7.9 and so on. Is https://www.python.org/downloads/release/python-2713/ an appropriate page to refer? ---------- assignee: docs@python components: Documentation messages: 290057 nosy: cocoatomo, docs@python priority: normal severity: normal status: open title: The link referring to "Python download page" is broken versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29888> _______________________________________

2 15

[issue22062] Fix pathlib.Path.(r)glob doc glitches.
by Serhiy Storchaka March 26, 2017

March 26, 2017

Serhiy Storchaka added the comment: Can you create a pull request on GitHub Mike? ---------- nosy: +serhiy.storchaka _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue22062> _______________________________________

1 0

[issue21071] struct.Struct.format is bytes, but should be str
by Martin Panter March 26, 2017

March 26, 2017

Martin Panter added the comment: A backwards-compatible way forward would be to preserve (and document) the “format” attribute as a byte string, and add a new attribute which is definitely a text string. Not sure of a good name; perhaps “Struct.text_format” or “format_str” is a start. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21071> _______________________________________

1 0