Mailman 3 August 2017 - docs

[issue31045] Add a language switch to the Python documentation
by Roundup Robot 08 Aug '17

08 Aug '17

Changes by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- pull_requests: +3056 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue31045> _______________________________________

1 0

Docs - Open Arguments
by Paulo Portela 08 Aug '17

08 Aug '17

Hello Community, I think there is a bug with the documentation with the topic "7. Input and Output" Link: https://docs.python.org/3.6/tutorial/inputoutput.html 7.2. Reading and Writing Files "open() returns a file object, and is most commonly used with two arguments: open(filename, mode)." The arguments for this function are open(file, mode). https://docs.python.org/3.6/library/functions.html#open open(file, mode='r', buffering=-1, encoding=None, errors=None, newline=None, closefd=True, opener=None) Best regards Paulo G.P. https://about.me/paulogp https://www.python.org/users/paulogp/

1 0

[issue31139] Improve tracemalloc demo code in docs
by Louie Lu 08 Aug '17

08 Aug '17

New submission from Louie Lu: Current tutorial of tracemalloc: https://docs.python.org/3/library/tracemalloc.html Current doc using a un-reproducible output, that will confuse the reader. Propose to use the test code `allocate_bytes` to control the memory usage output, provide more meaningful output to reader. ---------- assignee: docs@python components: Documentation messages: 299892 nosy: docs@python, haypo, louielu priority: normal severity: normal status: open title: Improve tracemalloc demo code in docs type: enhancement versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue31139> _______________________________________

1 1

[issue31045] Add a language switch to the Python documentation
by STINNER Victor 07 Aug '17

07 Aug '17

STINNER Victor added the comment: New changeset dff9b5f9d62aa0b23f8a255867d09d11890efd1b by Victor Stinner (Julien) in branch 'master': bpo-31045: Language switch (#2652) https://github.com/python/cpython/commit/dff9b5f9d62aa0b23f8a255867d09d1189… ---------- nosy: +haypo _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue31045> _______________________________________

1 0

[issue29555] Update Python Software Foundation Copyright Year
by Nick Coghlan 07 Aug '17

07 Aug '17

Nick Coghlan added the comment: Van, could you take a look at Senthil & Mariatta's questions above regarding our handling of the copyright year in CPython's module headers? ---------- nosy: +ncoghlan, vanl _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29555> _______________________________________

1 0

[issue31127] Abstract classes derived from built-in classes don't block instance creation
by Kevin Shweh 06 Aug '17

06 Aug '17

New submission from Kevin Shweh: The only check that prevents instantiating abstract classes is in object.__new__, but most built-in classes never actually call object.__new__. That means you can do stuff like import abc class Foo(list, metaclass=abc.ABCMeta): @abc.abstractmethod def abstract(self): pass Foo() and the Foo() call will silently succeed. Ideally, the Foo() call should fail. Other options include having the Foo class definition itself fail, or just making a note in the documentation describing the limitation. (As far as I can see, this is currently undocumented.) ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 299810 nosy: Kevin Shweh, docs@python priority: normal severity: normal status: open title: Abstract classes derived from built-in classes don't block instance creation type: behavior versions: Python 2.7, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue31127> _______________________________________

2 1

Potential documentation bug in Python 3 Tutorial about locale.setlocale
by Cory Lanker 05 Aug '17

05 Aug '17

Perhaps this is incorrect, but the line in section 11.1: locale.setlocale(locale.LC_ALL, 'English_United States.1252') didn’t work. I believe the problem is my platform is Mac OS. The following worked for me but wasn’t obvious: locale.setlocale(locale.LC_ALL, ‘en_US.UTF-8') Overall, your tutorial is fantastic and I appreciate the effort taken to create it. Best, Cory Cory Lanker

1 0

[issue27470] -3 commandline option documented differently via man
by Matthew Gilson 04 Aug '17

04 Aug '17

New submission from Matthew Gilson: The man page for python says: > Warn about Python 3.x incompatibilities that 2to3 cannot trivially fix. The official documentation (https://docs.python.org/2/using/cmdline.html#cmdoption-3) does not mention 2to3 at all: > Warn about Python 3.x possible incompatibilities by emitting a DeprecationWarning for features that are removed or significantly changed in Python 3. This seems like a pretty big oversight when the following code issues no warnings (presumably because 2to3 can trivially handle this change): ``` from __future__ import print_function class test(object): def __nonzero__(self): return False t = test() if t: print('Hello') ``` ---------- assignee: docs@python components: Documentation messages: 269994 nosy: docs@python, mgilson priority: normal severity: normal status: open title: -3 commandline option documented differently via man versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27470> _______________________________________

4 5

[issue31110] Small typo in plistlib docs
by cwee 03 Aug '17

03 Aug '17

New submission from cwee: Starting with 3.4, the docs for plistlib have had a typo: https://docs.python.org/3.4/library/plistlib.html#plistlib.readPlist https://docs.python.org/3.5/library/plistlib.html#plistlib.readPlist https://docs.python.org/3.6/library/plistlib.html#plistlib.readPlist https://docs.python.org/3.7/library/plistlib.html#plistlib.readPlist Functions `readPlist` and `readPlistFromBytes` reference the `__getitem_` method, which should be `__getitem__`. I'd be happy to submit a PR if there's a repo for the site's documentation. ---------- assignee: docs@python components: Documentation messages: 299668 nosy: cwee, docs@python priority: normal severity: normal status: open title: Small typo in plistlib docs type: enhancement versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue31110> _______________________________________

2 3

Re: [docs] trouble uploading package
by Siddiqui, Shahzeb 02 Aug '17

02 Aug '17

Can someone help me out in this. From: Siddiqui, Shahzeb Sent: Thursday, July 27, 2017 6:29 PM To: 'docs(a)python.org' Subject: trouble uploading package Hello, I am trying to upload a python package for the first time. I am getting some issues. I looked at the documentation, and followed the process. I have created my account, and its verified. The upload is failing. Please advise [siddis14@amrndhl1157 buildtest-framework]$ python setup.py register sdist upload running register running egg_info writing buildtest_framework.egg-info/PKG-INFO writing top-level names to buildtest_framework.egg-info/top_level.txt writing dependency_links to buildtest_framework.egg-info/dependency_links.txt reading manifest file 'buildtest_framework.egg-info/SOURCES.txt' writing manifest file 'buildtest_framework.egg-info/SOURCES.txt' running check We need to know who you are, so please choose either: 1. use your existing login, 2. register as a new user, 3. have the server generate a new password for you (and email it to you), or 4. quit Your selection [default 1]: 1 Username: shahzeb.siddiqui Password: Registering buildtest-framework to https://upload.pypi.org/legacy/ Server response (410): Project pre-registration is no longer required or supported, so continue directly to uploading files. running sdist creating buildtest-framework-1.0.1 creating buildtest-framework-1.0.1/buildtest_framework.egg-info copying files to buildtest-framework-1.0.1... copying README.rst -> buildtest-framework-1.0.1 copying setup.py -> buildtest-framework-1.0.1 copying buildtest_framework.egg-info/PKG-INFO -> buildtest-framework-1.0.1/buildtest_framework.egg-info copying buildtest_framework.egg-info/SOURCES.txt -> buildtest-framework-1.0.1/buildtest_framework.egg-info copying buildtest_framework.egg-info/dependency_links.txt -> buildtest-framework-1.0.1/buildtest_framework.egg-info copying buildtest_framework.egg-info/not-zip-safe -> buildtest-framework-1.0.1/buildtest_framework.egg-info copying buildtest_framework.egg-info/top_level.txt -> buildtest-framework-1.0.1/buildtest_framework.egg-info Writing buildtest-framework-1.0.1/setup.cfg Creating tar archive removing 'buildtest-framework-1.0.1' (and everything under it) running upload Password: Submitting dist/buildtest-framework-1.0.1.tar.gz to https://upload.pypi.org/legacy/ Upload failed (403): Invalid or non-existent authentication information. error: Upload failed (403): Invalid or non-existent authentication information. I have the following file, I didn't make any changes [siddis14@amrndhl1157 buildtest-framework]$ cat ~/.pypirc [distutils] index-servers = pypi [pypi] repository: <repository-url> username: <username> password: <password> What is the problem? Shahzeb Siddiqui HPC Linux Engineer B2220-447.2 Groton, CT

1 0

docs August 2017