Mailman 3 January 2019 - docs

[issue35722] disable_existing_loggers does not apply to the root logger
by Vinay Sajip 23 Jan '19

23 Jan '19

Change by Vinay Sajip <vinay_sajip(a)yahoo.co.uk>: ---------- pull_requests: -11446 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35722> _______________________________________

1 0

[issue35722] disable_existing_loggers does not apply to the root logger
by Vinay Sajip 23 Jan '19

23 Jan '19

Vinay Sajip <vinay_sajip(a)yahoo.co.uk> added the comment: New changeset 552478bb1086ef371e4f1da0b430b90eba4785d5 by Vinay Sajip (Miss Islington (bot)) in branch '3.7': bpo-35722: Updated the documentation for the 'disable_existing_loggers' parameter (GH-11525) (GH-11655) https://github.com/python/cpython/commit/552478bb1086ef371e4f1da0b430b90eba… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35722> _______________________________________

1 0

[issue35722] disable_existing_loggers does not apply to the root logger
by miss-islington 23 Jan '19

23 Jan '19

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- keywords: +patch, patch, patch, patch, patch pull_requests: +11445, 11446, 11447, 11448, 11449, 11450 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35722> _______________________________________

1 0

[issue35722] disable_existing_loggers does not apply to the root logger
by miss-islington 23 Jan '19

23 Jan '19

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- keywords: pull_requests: +11446, 11447, 11449, 11450 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35722> _______________________________________

1 0

[issue35722] disable_existing_loggers does not apply to the root logger
by miss-islington 23 Jan '19

23 Jan '19

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- keywords: +patch, patch, patch, patch pull_requests: +11445, 11446, 11447, 11449 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35722> _______________________________________

1 0

[issue35722] disable_existing_loggers does not apply to the root logger
by miss-islington 23 Jan '19

23 Jan '19

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- keywords: +patch, patch, patch pull_requests: +11445, 11446, 11447 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35722> _______________________________________

1 0

[issue35722] disable_existing_loggers does not apply to the root logger
by miss-islington 23 Jan '19

23 Jan '19

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- keywords: +patch, patch pull_requests: +11445, 11446 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35722> _______________________________________

1 0

[issue35722] disable_existing_loggers does not apply to the root logger
by miss-islington 23 Jan '19

23 Jan '19

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- keywords: +patch pull_requests: +11445 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35722> _______________________________________

1 0

[issue35722] disable_existing_loggers does not apply to the root logger
by Vinay Sajip 23 Jan '19

23 Jan '19

Vinay Sajip <vinay_sajip(a)yahoo.co.uk> added the comment: New changeset f0c743604fc841d35a48822b936ef2e5919e43c1 by Vinay Sajip (Géry Ogam) in branch 'master': bpo-35722: Updated the documentation for the 'disable_existing_loggers' parameter (GH-11525) https://github.com/python/cpython/commit/f0c743604fc841d35a48822b936ef2e591… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35722> _______________________________________

1 0

[issue35486] subprocess module import hooks breaks back compatibility
by Nick Coghlan 22 Jan '19

22 Jan '19

Nick Coghlan <ncoghlan(a)gmail.com> added the comment: Aye, we can :) ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35486> _______________________________________

1 0

[issue35801] venv in 3.7 references python3 executable
by Paul Watson 21 Jan '19

21 Jan '19

New submission from Paul Watson <paul.hermeneutic(a)gmail.com>: The documentation for venv in Python 3.7 references using `python3` to run venv. I do not find a `python3` executable in the kit. https://docs.python.org/3.7/library/venv.html#module-venv ---------- assignee: docs@python components: Documentation messages: 334165 nosy: Paul Watson, docs@python priority: normal severity: normal status: open title: venv in 3.7 references python3 executable type: enhancement versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35801> _______________________________________

1 0

[issue35777] mismatched eval() and ast.literal_eval() behavior with unicode_literals
by jez 21 Jan '19

21 Jan '19

jez <jezhill(a)gmail.com> added the comment: I take the point about breaking backward compatibility. The problem, then, is in the `ast` documentation, and may not be confined to Python 2.7 The `literal_eval` doc <https://docs.python.org/2/library/ast.html#ast-helpers> states no more than that the function evaluates a "string containing a Python literal". The future statement effectively changes the definition of "a Python literal" but of course, as the official `__future__` doc <https://docs.python.org/2/reference/simple_stmts.html#future> explains, this is done for the compilation of each "particular module" in isolation. The question is left open whether the occurrence of this term in `ast` documentation should be read as "a Python literal (as defined by the ast module itself at compile time)", or "a Python literal (as defined by the caller at compile time)". More generally, future statements effectively change the definition of the term "Python syntax", sometimes also simply referred to as "Python". Unfortunately, the `ast` documentation uses these terms loosely throughout, without acknowledging that they are mutable. I propose that the `ast` module documentation flag cases in which the `ast` module's own definitions of "Python" and "Python syntax" may not match those of a caller who has included `__future__` statements, leading to unexpected behavior. I am insufficiently familiar with the full functionality of `ast` to be able to identify where this is and is not an issue, except in `literal_eval`, but I can see it could in principle affect Python 3.x too. ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python versions: -Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35777> _______________________________________

1 0

[issue35797] concurrent.futures.ProcessPoolExecutor does not work in venv on Windows
by Christian Ullrich 21 Jan '19

21 Jan '19

New submission from Christian Ullrich <chris(a)chrullrich.net>: Using concurrent.futures.ProcessPoolExecutor on Windows fails immediately with a lot of exceptions of the "access denied", "file not found", and "invalid handle" varieties. Running the script that creates the ProcessPoolExecutor from the main system-wide installation works correctly. Due to Windows' infamous lack of fork(), ProcessPoolExecutor launches its worker processes by setting up an inheritable handle to a pipe and passing the handle on the command line. In a venv situation, it appears that the venv's python.exe internally launches the parent environment's python.exe and passes on its command line, but not its handle table. This sub-subprocess therefore does not have the original handle, and may have a different handle at the same index. Output of the ProcessPoolExecutor example program from the docs when run with the main installation: C:\Daten>py cft.py 112272535095293 is prime: True 112582705942171 is prime: True 112272535095293 is prime: True 115280095190773 is prime: True 115797848077099 is prime: True 1099726899285419 is prime: False Output when run using a venv: C:\Daten>pyv\v37\Scripts\python.exe cft.py Process SpawnProcess-4: Traceback (most recent call last): File "C:\Program Files\Python37\lib\multiprocessing\process.py", line 297, in _bootstrap self.run() File "C:\Program Files\Python37\lib\multiprocessing\process.py", line 99, in run self._target(*self._args, **self._kwargs) File "C:\Program Files\Python37\lib\concurrent\futures\process.py", line 226, in _process_worker call_item = call_queue.get(block=True) File "C:\Program Files\Python37\lib\multiprocessing\queues.py", line 93, in get with self._rlock: File "C:\Program Files\Python37\lib\multiprocessing\synchronize.py", line 95, in __enter__ return self._semlock.__enter__() PermissionError: [WinError 5] Access is denied Process SpawnProcess-5: Traceback (most recent call last): File "C:\Program Files\Python37\lib\multiprocessing\process.py", line 297, in _bootstrap self.run() File "C:\Program Files\Python37\lib\multiprocessing\process.py", line 99, in run self._target(*self._args, **self._kwargs) File "C:\Program Files\Python37\lib\concurrent\futures\process.py", line 226, in _process_worker call_item = call_queue.get(block=True) File "C:\Program Files\Python37\lib\multiprocessing\queues.py", line 93, in get with self._rlock: File "C:\Program Files\Python37\lib\multiprocessing\synchronize.py", line 95, in __enter__ return self._semlock.__enter__() PermissionError: [WinError 5] Access is denied Traceback (most recent call last): File "cft.py", line 28, in <module> main() File "cft.py", line 24, in main for number, prime in zip(PRIMES, executor.map(is_prime, PRIMES)): File "C:\Program Files\Python37\lib\concurrent\futures\process.py", line 476, in _chain_from_iterable_of_lists for element in iterable: File "C:\Program Files\Python37\lib\concurrent\futures\_base.py", line 586, in result_iterator yield fs.pop().result() File "C:\Program Files\Python37\lib\concurrent\futures\_base.py", line 432, in result return self.__get_result() File "C:\Program Files\Python37\lib\concurrent\futures\_base.py", line 384, in __get_result raise self._exception concurrent.futures.process.BrokenProcessPool: A process in the process pool was terminated abruptly while the future was running or pending. ---------- assignee: docs@python components: Documentation, Library (Lib), Windows messages: 334142 nosy: chrullrich, docs@python, paul.moore, steve.dower, tim.golden, zach.ware priority: normal severity: normal status: open title: concurrent.futures.ProcessPoolExecutor does not work in venv on Windows type: behavior versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35797> _______________________________________

1 0

[issue35168] shlex punctuation_chars inconsistency
by Roundup Robot 21 Jan '19

21 Jan '19

Change by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- keywords: +patch, patch, patch, patch pull_requests: +11400, 11401, 11402, 11403 stage: needs patch -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35168> _______________________________________

1 0

[issue35168] shlex punctuation_chars inconsistency
by Roundup Robot 21 Jan '19

21 Jan '19

Change by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- keywords: +patch, patch, patch pull_requests: +11400, 11401, 11402 stage: needs patch -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35168> _______________________________________

1 0

[issue35168] shlex punctuation_chars inconsistency
by Roundup Robot 21 Jan '19

21 Jan '19

Change by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- keywords: +patch, patch pull_requests: +11400, 11401 stage: needs patch -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35168> _______________________________________

1 0

[issue35168] shlex punctuation_chars inconsistency
by Roundup Robot 21 Jan '19

21 Jan '19

Change by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- keywords: +patch pull_requests: +11400 stage: needs patch -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35168> _______________________________________

1 0

[issue35722] disable_existing_loggers does not apply to the root logger
by Cheryl Sabella 20 Jan '19

20 Jan '19

Change by Cheryl Sabella <cheryl.sabella(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35722> _______________________________________

1 0

Issue in https://docs.python.org/3/library/importlib.html
by Goldberg, Arthur P 20 Jan '19

20 Jan '19

In “ValueError is also raised a relative name would escape its containing package (e.g. requesting ..bacon from within the spam package).”, s/raised a relative/raised if a relative/ and the example isn’t clear as no package hierarchy is illustrated. Thanks for your great docs overall. Arthur Arthur Goldberg, PhD Associate Professor of Genetics and Genomic Sciences Institute for Data Science and Genomic Technology Mount Sinai School of Medicine 1255 Fifth Ave., Suite C-2 New York, NY 10029 646 526 5020 Karr Lab Arthur.Goldberg(a)mssm.edu<mailto:Arthur.Goldberg@mssm.edu>

1 0

The `errors` parameter for `pickle.load`
by John Yeung 20 Jan '19

20 Jan '19

The docs for `pickle.load` and `pickle.loads` mention that the default value for `errors` is 'strict' but don't say anything about what else it could be. If you're silly enough to try 'loose', you get LookupError: unknown error handler name 'loose' Where can someone find out more about this parameter? If it's too long to explain right there in the docs for `load`, but something is already published, I propose that the docs point to that. If it's a case of "if you really want to use this, you really have to know what you're doing, and you can figure it out for yourself from the source", then the docs should say something to that effect. Another possibility is that using a value other than the default is so rare and specialized that the parameter might as well not be documented (since you have to read the source to learn how to use it anyway, in which case the source *is* your documentation). Finally, as an orthogonal issue, the optional keyword arguments paragraph is identical for both `load` and `loads`. I propose that it follows the less repetitive pattern of `dump` and `dumps`. John Y.

1 0

[issue32603] Deprecation warning on strings used in re module
by Cheryl Sabella 20 Jan '19

20 Jan '19

New submission from Cheryl Sabella <chekat2(a)gmail.com>: I apologize if this is a duplicate question, but I couldn't find another issue about this. It's hard to search on 're'. In 3.7, I get a deprecation warning when using a regular string with re escape characters: >>> s = '123abcd' >>> re.findall('\d', s) <stdin>:1: DeprecationWarning: invalid escape sequence \d ['1', '2', '3'] Of course, this works: >>> s = '123abcd' >>> re.findall(r'\d', s) ['1', '2', '3'] I know that the documentation strongly suggests using raw strings with re, but I didn't see anywhere mentioning that it would be a requirement. I would think this would break a lot of 're' code. ---------- assignee: docs@python components: Documentation messages: 310300 nosy: csabella, docs@python priority: normal severity: normal status: open title: Deprecation warning on strings used in re module type: enhancement versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32603> _______________________________________

4 6

[issue35789] Typo in unittest.mock docs
by Jim Carroll 20 Jan '19

20 Jan '19

New submission from Jim Carroll <jim(a)carroll.com>: There is a typo in the unittest.mock documentation found at https://docs.python.org/3/library/unittest.mock.html. There are seven(7) instances of the word assret, where the author clearly intended assert. ---------- assignee: docs@python components: Documentation messages: 334087 nosy: docs@python, jamercee priority: normal severity: normal status: open title: Typo in unittest.mock docs type: enhancement versions: Python 3.5, Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35789> _______________________________________

1 1

3. An Informal Introduction to Python
by C Velson Horie 19 Jan '19

19 Jan '19

I am just starting to learn Python. I miscoded the block, because I did not understand the formatting conventions. As a result the Fibonacci series was 0,0,0.. and I could not stop it except by closing the command window. I tried cntl-X, Esc etc - nothing worked. How do I stop a process in Python? -- Velson Horie

1 0

[issue13322] buffered read() and write() does not raise BlockingIOError
by Martin Panter 19 Jan '19

19 Jan '19

Martin Panter <vadmium+py(a)gmail.com> added the comment: Issue 35762 was opened specifically about Izbyshev’s case: TextIOWrapper behaviour with a non-blocking file. Calling “os.fdopen” with mode='r' (text mode) returns a TextIOWrapper object. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue13322> _______________________________________

1 0

[issue33995] test_min_max_version in test_ssl.py fails when Python is built against LibreSSL; {min,max}imum_version behavior differs from OpenSSL
by Alan Huang 18 Jan '19

18 Jan '19

New submission from Alan Huang <Alan.Huang(a)utdallas.edu>: LibreSSL's implementation of the function used to get the minimum and maximum SSL versions supported differs from OpenSSL's. In short, the issue is in the implementations of `SSL_CTX_new` - OpenSSL initializes variables `ret->{min,max}_proto_version` to 0, while LibreSSL initializes corresponding variables to those of the `SSL_METHOD` given. As such, when Python is built with LibreSSL, the default values for an instance of ssl.SSLContext are, in the case of ssl.SSLContext(), ctx.minimum_version = <TLSVersion.TLSv1: 769>; ctx.maximum_version = <TLSVersion.TLSv1_2: 771>. This is NOT what test_ssl.py expects; it expects OpenSSL's behavior of initializing the version variables to zero, which _ssl.c then translates to PY_PROTO_{MIN,MAX}IMUM_SUPPORTED -> ssl.TLSVersion.{MIN,MAX}IMUM_SUPPORTED. Additionally, LibreSSL, when `SSL_CTX_set_{min,max}_proto_version` is called with `version` equal to zero, explicitly sets the minimum / maximum values equal to the minimum / maximum values for the `SSL_METHOD` it was called with (namely, 769/770/771, in the case of `TLS_method()`), not the minimum / maximum values supported by the library. I have sent an email to the LibreSSL mailing list asking for clarification on this point, namely, if this is intended behavior. If it is, there are two ways that come to mind to work around this behavior. Both ways would only be necessary if `IS_LIBRESSL`. 1. Skip `test_min_max_version`. 2. Instead of testing that ctx is equal *to* the extremes after it's been set to one of the extremes, test that it's equal to the actual constants. There are two ways this could be accomplished as well: a. Use PY_PROTO_{MIN,MAX}IMUM_AVAILABLE, defined in _ssl.c (this may require the addition of another call to `PyModule_AddIntConstant` to provide access to the constant from _ssl). The downside to this approach is that it assumes that `TLS_method()`, or whatever `SSL_METHOD` test_ssl.py uses has lower and upper bounds equal to PY_PROTO_{MIN,MAX}IMUM_AVAILABLE, which may not always be the case. b. Access and store the values for ctx.{min,max}imum_value on creation, then reference them after setting. Either of these approaches would likely also have the benefit of removing the need for `self.assertIn(ctx.minimum_version, {ssl.TLSVersion.TLSv1_2, ssl.TLSVersion.TLSv1_3})`. The test that failed was: ====================================================================== FAIL: test_min_max_version (test.test_ssl.ContextTests) ---------------------------------------------------------------------- Traceback (most recent call last): File "/home/alan/src/cpython/Lib/test/test_ssl.py", line 1066, in test_min_max_version ctx.minimum_version, ssl.TLSVersion.MINIMUM_SUPPORTED AssertionError: <TLSVersion.TLSv1: 769> != <TLSVersion.MINIMUM_SUPPORTED: -2> Addendum: I found the documentation for ssl.TLSVersion.{MAX,MIN}IMUM_SUPPORTED confusing at first - it took me quite a while to realize what the purpose of the constants were; I would have expected them to contain the maximum and minimum protocol versions supported by the library; I see why it was phrased that way, after having boned up on ssl.py, _ssl.c, and OpenSSL/LibreSSL, but think it could could be made clearer. ---------- assignee: docs@python components: Documentation, SSL, Tests messages: 320703 nosy: Alan.Huang, alex, christian.heimes, docs@python, dstufft, janssen priority: normal severity: normal status: open title: test_min_max_version in test_ssl.py fails when Python is built against LibreSSL; {min,max}imum_version behavior differs from OpenSSL type: behavior versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33995> _______________________________________

2 4

[issue23156] Update tix install information in tkinter tix chapter of doc
by Terry J. Reedy 18 Jan '19

18 Jan '19

New submission from Terry J. Reedy: Update tix install info in doc. "Using tix" starts with 3 lines for testing one's tix install and continues '''If this fails, you have a Tk installation problem which must be resolved before proceeding. Use the environment variable TIX_LIBRARY to point to the installed Tix library directory, and make sure you have the dynamic object library (tix8183.dll or libtix8183.so) in the same directory that contains your Tk dynamic object library (tk8183.dll or libtk8183.so). The directory with the dynamic object library should also have a file called pkgIndex.tcl (case sensitive), which contains the line: package ifneeded Tix 8.1 [list load "[file join $dir tix8183.dll]" Tix]''' Almost nothing above matches my working-with-tix 3.4.2 Win 7 install. I do have a tix library directory: python34/tcl/tix8.4.3, but the version number is much newer. Since it is in the right place, TIX_LIBRARY is not needed and there is none. python34/DLLs contains tcl86t.dll and tk86t.dll and NO tix####.dll. Is the once separate tix dll now part of tk dll? I cannot find pkgIndex.tcl; it is certainly not in the DLLs directory nor in the /tcl. The current doc seems useless to people who do not have tix working. See, for example, https://stackoverflow.com/questions/27751923/tix-widgets-installation-issue which is a semi-repeat question and which claims seeing similar reports elsewhere on the net. ---------- assignee: docs@python components: Documentation, Tkinter messages: 233368 nosy: docs@python, serhiy.storchaka, terry.reedy, zach.ware priority: normal severity: normal stage: needs patch status: open title: Update tix install information in tkinter tix chapter of doc type: behavior versions: Python 2.7, Python 3.4, Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue23156> _______________________________________

5 13

[issue34161] Tutorial 7.1 str.format() code example syntax error
by Orlando 18 Jan '19

18 Jan '19

New submission from Orlando <oboffill(a)icloud.com>: Tutorial 7.1 str.format() example (https://docs.python.org/3.7/tutorial/inputoutput.html#fancier-output-format…): [1]yes_votes = 42_572_654 ; no_votes = 43_132_495 [2]percentage = (yes_votes/(yes_votes+no_votes) [3]'{:-9} YES votes {:2.2%}'.format(yes_votes, percentage)) Proposed Fix: Remove first open parens on line 2 and last close parens on line 3. ---------- assignee: docs@python components: Documentation messages: 321977 nosy: docs@python, oboff priority: normal severity: normal status: open title: Tutorial 7.1 str.format() code example syntax error versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34161> _______________________________________

6 24

PDF-Files only available in Letter-Format
by Heinrich Ottinger 17 Jan '19

17 Jan '19

*Dear Mr. van Rossum, * *dear members of the great Python-Team! * I want to thank you for your job and what you make available for the public! Please let my say, that there seams to be a little mistake in the PDF-Files you offered for download this night: In the ZIP-File " https://docs.python.org/3.7/archives/python-3.7.2-docs-pdf-a4.zip" there are PDF-Files in the Letter-Format as well - instead of A4-Format! With kind regards from Tübingen in Southern Germany, *Heinrich Ottinger*

1 0

[issue35744] Problem in the documentation of numpy.random.randint in python 2.7
by Jay 15 Jan '19

15 Jan '19

New submission from Jay <jay.pokarna10(a)gmail.com>: Official Documentation of python 2.7 mentions that numpy.random.randint(a,b) will return a random integer from N such that a<=N<=b. But I have run the code and I have found that it never returns equal to b. So, what I did was I ran numpy.random.randint(0,1) for 50 milion times and finally printed the sum. The output was 0. I don't know if this a documentation or an implementation issue, but this is an issue which needs to be looked at. I am attaching the code that I ran. ---------- assignee: docs@python components: Documentation files: sample.py messages: 333701 nosy: Jay, docs@python priority: normal severity: normal status: open title: Problem in the documentation of numpy.random.randint in python 2.7 type: behavior versions: Python 2.7 Added file: https://bugs.python.org/file48051/sample.py _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35744> _______________________________________

2 1

[issue35738] Update timeit documentation to reflect default repeat of three
by Jayanth Raman 15 Jan '19

15 Jan '19

New submission from Jayanth Raman <raman.jayanth(a)gmail.com>: In the Examples section of the timeit documentation, repeat() returns a list of size three. But the default is now five and the documentation should reflect that. Thanks. ---------- assignee: docs@python components: Documentation messages: 333635 nosy: docs@python, jayanth priority: normal severity: normal status: open title: Update timeit documentation to reflect default repeat of three type: enhancement versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35738> _______________________________________

5 10

[issue35732] Typo in library/warnings documentation
by Antoine Wecxsteen 14 Jan '19

14 Jan '19

New submission from Antoine Wecxsteen <antoine(a)wecxsteen.net>: Hello, I believe there's a mistake in the documentation of library/warnings. https://docs.python.org/3.8/library/warnings.html#warnings.warn "This function raises an exception if the particular warning issued is changed into an error by the warnings filter see above." I think "see above" should be enclosed in brackets (or maybe completely removed as there is already a "(see above)" in the same text block). Regards. ---------- assignee: docs@python components: Documentation messages: 333574 nosy: awecx, docs@python, eric.araujo, ezio.melotti, mdk, willingc priority: normal severity: normal status: open title: Typo in library/warnings documentation 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/issue35732> _______________________________________

3 9

[issue34512] Document platform-specific strftime() behavior for non-ASCII format strings
by Alexey Izbyshev 14 Jan '19

14 Jan '19

New submission from Alexey Izbyshev <izbyshev(a)ispras.ru>: If a format string contains code points outside of ASCII range, time.strftime() can behave in four different ways depending on the platform, the current locale and the code points: * raise a UnicodeEncodeError * return an empty string * for surrogates in \uDC80-\uDCFF range, replace them with different code points in the output (potentially mangling nearby parts of the output as well) * round-trip them correctly Some examples: * Linux (glibc 2.27): Python 3.6.4 (default, Jan 03 2018, 13:52:55) [GCC] on linux Type "help", "copyright", "credits" or "license" for more information. >>> import time, locale >>> locale.getlocale() ('en_US', 'UTF-8') >>> time.strftime('\x80') '\x80' >>> time.strftime('\u044f') 'я' # '\u044f' >>> time.strftime('\ud800') '\ud800' >>> time.strftime('\udcff') '\udcff' >>> locale.setlocale(locale.LC_CTYPE, 'C') 'C' >>> time.strftime('\x80') '\x80' >>> time.strftime('\u044f') 'я' # '\u044f' >>> time.strftime('\ud800') '\ud800' >>> time.strftime('\udcff') '\udcff' * macOS 10.13.6 and FreeBSD 11.1: Python 3.7.0 (default, Jul 23 2018, 20:22:55) [Clang 9.1.0 (clang-902.0.39.2)] on darwin Type "help", "copyright", "credits" or "license" for more information. >>> import time, locale >>> locale.getlocale() ('en_US', 'UTF-8') >>> time.strftime('\x80') '\x80' >>> time.strftime('\u044f') 'я' # '\u044f' >>> time.strftime('\ud800') '' >>> time.strftime('\udcff') '' >>> locale.setlocale(locale.LC_CTYPE, 'C') 'C' >>> time.strftime('\x80') '\x80' >>> time.strftime('\u044f') '' >>> time.strftime('\ud800') '' >>> time.strftime('\udcff') '' * Windows 8.1: Python 3.7.0 (v3.7.0:1bf9cc5093, Jun 27 2018, 04:59:51) [MSC v.1914 64 bit (AMD64)] on win32 >>> import time, locale >>> locale.getlocale() (None, None) >>> time.strftime('\x80') '\x80' >>> time.strftime('\u044f') Traceback (most recent call last): File "<stdin>", line 1, in <module> UnicodeEncodeError: 'locale' codec can't encode character '\u044f' in position 0: encoding error >>> time.strftime('\ud800') Traceback (most recent call last): File "<stdin>", line 1, in <module> UnicodeEncodeError: 'locale' codec can't encode character '\ud800' in position 0: encoding error >>> time.strftime('\udcff') 'y' # '\xff' >>> locale.setlocale(locale.LC_CTYPE, '') 'Russian_Russia.1251' >>> time.strftime('\x80') Traceback (most recent call last): File "<stdin>", line 1, in <module> UnicodeEncodeError: 'locale' codec can't encode character '\x80' in position 0: encoding error >>> time.strftime('\u044f') 'я' # '\u044f' >>> time.strftime('\ud800') Traceback (most recent call last): File "<stdin>", line 1, in <module> UnicodeEncodeError: 'locale' codec can't encode character '\ud800' in position 0: encoding error >>> time.strftime('\udcff') 'я' # '\u044f' The reasons of such differences are the following: * Reliance on either wcsftime() or strftime() from the C library depending on the platform. * For strftime(), the input is encoded into the charset of the current locale with 'surrogateescape' error handler, and the output is decoded back in the same way. * Different handling of code points which are unrepresentable in the charset of the current locale by glibc and macOS/FreeBSD. I suggest to at least document that the format string, despite being an 'str', requires special care if it contains non-ASCII code points. The 'datetime' module docs warn about the locale-dependent output, but only with regard to particular format specifiers [1]. I'll submit a draft PR. Suggestions are welcome. [1] https://docs.python.org/3.7/library/datetime.html#strftime-and-strptime-beh… ---------- assignee: docs@python components: Documentation messages: 324136 nosy: belopolsky, docs@python, izbyshev, p-ganssle, taleinat priority: normal severity: normal status: open title: Document platform-specific strftime() behavior for non-ASCII format strings type: enhancement versions: Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34512> _______________________________________

5 17

[issue33039] int() and math.trunc don't accept objects that only define __index__
by Nick Coghlan 13 Jan '19

13 Jan '19

Nick Coghlan <ncoghlan(a)gmail.com> added the comment: @Rémi Aye, filling out derived slots is one of the things PyType_Ready does. This would need a discussion on python-dev before going ahead and doing it though, as the closest equivalent we have to this right now is the "negative" derivation, where overriding __eq__ without overriding __hash__ implicitly marks the derived class as unhashable (look for "type->tp_hash = PyObject_HashNotImplemented;"). ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33039> _______________________________________

1 0

Report bugs on the leaps year
by #CHUAH SHEOU SHUANG# 12 Jan '19

12 Jan '19

Dear Sir/Madam, [cid:image002.png@01D4AA81.1B676110] I accidentally found out that for years 1700, 1800, and 1900, they should be leaps year but then it shows that it has 28 days on February. Best Regards, Sheou Shuang. Sent from Mail<https://go.microsoft.com/fwlink/?LinkId=550986> for Windows 10

2 2

[issue35716] CLOCK_MONOTONIC_RAW available on macOS
by Ricardo Fraile 11 Jan '19

11 Jan '19

New submission from Ricardo Fraile <rfraile(a)rfraile.eu>: Add macOS to CLOCK_MONOTONIC_RAW description because it is already available since 10.12. ---------- assignee: docs@python components: Documentation files: 001.patch keywords: patch messages: 333445 nosy: docs@python, rfrail3, vstinner priority: normal severity: normal status: open title: CLOCK_MONOTONIC_RAW available on macOS type: enhancement Added file: https://bugs.python.org/file48041/001.patch _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35716> _______________________________________

5 16

[issue35156] Consider revising documentation on Python Builds from source
by Jorge Ramos 11 Jan '19

11 Jan '19

New submission from Jorge Ramos <neyuru(a)gmail.com>: I want to build from source a 3.6 Python, using PGO for windows. Followed instructions at https://devguide.python.org/setup/ (the original search from google was "build python from source windows"). From a newbie perspective there are several problems: 1) it is suggested that you should build first a "debug" python (header 1.3) but they don't tell you how. 2) it is suggested that you should first build via "PCBuild\build.bat" but they don't tell you that this builds a win32 platform. What if I want to build a x64 version? (lost much time here figuring out how) 3) I ran into problems when building with "PCBuild\build.bat" (header 1.3.2) because the dependencies where not all downloaded in the first pass (but this is a bug I could fill later). Lost much time here figuring why the build did not succeed. 4) in (1.3.2) it is suggested you keep reading in a readme file: https://github.com/python/cpython/blob/master/PCbuild/readme.txt This is the first time an optimization is mentioned (other than simply compiling from your machine. I did not know that using PGO was mandatory for real speedups compared to the downloadable “general” binaries). 5) In this very same readme, it says that there are other "subprojects" that you need to consider building with Python. Lost much time here trying to figure out that these subprojects are downloaded via "get_externals.bat" in the "Getting External Sources" section. Why not simply put the "Getting External Sources" section first and avoid worrying the newcomer of potential projects that are "not included with python"? 6) They tell you that PGO is automated via a "build_pgo.bat" file. But this does not exist. 7) They tell you that first, you have to run the PGInstrument option in the build, but it is not clear what should be run next: PCBuild\build.bat -c PGUpdate -p x64" or "PCBuild\build.bat --pgo -p x64" 8) After 2 days of trying to build (and learn in the process by trial and error) I stumble upon YET ANOTHER WAY TO BUILD: the one found in "cpython\Tools\msi" NOT the first one: "cpython\PCbuild" And this is the one I was interested in the first place: building an installable version of python (yet I have to figure out how to pack all cab files and such into one exe), not a developer’s python for testing. And after now 3 days with this, I noticed that all previous testing and building techniques are indeed reachable from "cpython\Tools\msi\buildrelease.bat -x64" which tries to build a python in x64 version AND using GPO (by default -in the x64 but not in the win32-, which is not mentioned in the documentation, by the way) also generating the dependencies required (I could have avoided losing some time if knowing this from the very beginning- see point 5) As you can see, I lost few hours here, few there. And because I am not a developer (my intention is to have an optimized python for my PC for AI research) I lost much time trying to figure out things that are not explicitly said in the documentation: I managed to learn from other sources (googling around), by careful observation of the compilation results, and digging into the help section of each of the files used. Hope I successfully communicated Python’s lack of proper documentation (just for the case of building from source!) ---------- assignee: docs@python components: Documentation messages: 329211 nosy: docs@python, neyuru priority: normal severity: normal status: open title: Consider revising documentation on Python Builds from source type: enhancement versions: Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35156> _______________________________________

3 7

EPUB Version is too big.
by Michał Listowski 10 Jan '19

10 Jan '19

Hello I believe that you should cut epub file in parts like PDF. This one file is almost unreadable for most of readers like Pocketbook or Kindle (after convert to mobi). When i open on PocketBook Inkpad 3 it shows me that file have 5500+ pages, even start to change pages is really difficuld for device. I think on tablets it's not a big problem because CPU in them are faster. Thanks a lot for your work and response Michał Listowski

1 0

Feedback on the error page
by 张相恩 10 Jan '19

10 Jan '19

I am a Python enthusiast from China. I have been studying this manual recently, but I found a problem and hope to solve it as soon as possible. The problem bothering me. I believe it will also plague other beginners. This is url ： https://docs.python.org/zh-cn/3.7/archives/python-3.7.2-docs-pdf-a4.zip wrong description： 404 Not Found

2 1

[issue35374] Windows doc build does not find autodetected hhc.exe
by Christian Ullrich 08 Jan '19

08 Jan '19

New submission from Christian Ullrich <chris(a)chrullrich.net>: If hhc.exe is on the PATH when HTML Help is being built, the build fails because make.bat does not correctly remember the fact. The set command is very finicky with trailing spaces, leading to this: '"hhc "' is not recognized as an internal or external command, operable program or batch file. I suppose the "official" build does not rely on autodetection. In that case, a better fix would be to require setting HTMLHELP explicitly. PR (for the single-character fix) incoming. ---------- assignee: docs@python components: Documentation messages: 330872 nosy: chrullrich, docs@python priority: normal severity: normal status: open title: Windows doc build does not find autodetected hhc.exe type: compile error _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35374> _______________________________________

5 9

[issue35681] urllib.request.HTTPPasswordMgr.add_password requires more information for HTTPPasswordMgrWithDefaultRealm
by Tatz Sekine 07 Jan '19

07 Jan '19

New submission from Tatz Sekine <tsekine(a)google.com>: TL;DR HTTPPasswordMgrWithDefaultRealm.add_password() doesn't have proper documentation. All known version of urllib.request (or urllib2 in Python 2.x) documentaion have the same issue. Details: HTTPPasswordMgrWithDefaultRealm object doesn't have its own documentation. Instead of that, HTTPPasswordMgr's doc have information for those 2 objects: https://docs.python.org/3.8/library/urllib.request.html?highlight=httppassw… Both objects have just 2 functions: add_password() and find_user_password(). The doc for find_user_password() has explanation how different between those 2 objects, while the one for add_password() doesn't. One of the missing explanation for HTTPPasswordMgrWithDefaultRealm.add_passowrd() is the value of realm. The document has now "realm, user and passwd must be strings.", but realm could be None for HTTPPasswordMgrWithDefaultRealm, to set default realm-less password. That's typical use case of HTTPPasswordMgrWithDefaultRealm.add_password(), or, that's exactly urllib howto doc mentions in https://docs.python.org/3.8/howto/urllib2.html?highlight=httppasswordmgrwit… Conclusion: So, documentation of HTTPPasswordMgr.add_passoword() should have additional explanation for realm which could be None for HTTPPasswordMgrWithDefaultRealm. Or, HTTPPasswordMgrWithDefaultRealm objects could have independent section from HTTPPasswordMgr, to clarify its usage. Why is this matter? Typeshed (https://github.com/python/typeshed) depends on the doc. I (or somebody else in the company) will report it separately. ---------- assignee: docs@python components: Documentation messages: 333189 nosy: docs@python, tsekine priority: normal severity: normal status: open title: urllib.request.HTTPPasswordMgr.add_password requires more information for HTTPPasswordMgrWithDefaultRealm type: behavior 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/issue35681> _______________________________________

1 0

sched ― Event scheduler ― Python 3.7.2 documentation
by shicanwei＠jingmeiti.com 07 Jan '19

07 Jan '19

your example is wrong, "priority small do first" https://docs.python.org/3/library/sched.html my execution is like below: shicanwei(a)jingmeiti.com

1 0

404 Not Found : Download Python 3.7.2 Documentation
by Pedro MENDES 06 Jan '19

06 Jan '19

Hi Team ;) For information purposes and trying to download packet from /Python>> French - 3.7.2 Documentation/(https://docs.python.org/fr/3/download.html) many packets, when we try to download them, indicate 404 Not Found : PDF (US-Letter paper size) [all packets] PDF (A4 paper size) [all packets] EPUB [all packets] Regards Pedro

1 0

[issue30487] DOC: automatically create a venv and install Sphinx when running make
by Caleb Hattingh 06 Jan '19

06 Jan '19

New submission from Caleb Hattingh: Under guidance from zware during Pycon sprints, I've changed the Doc/ Makefile to automatically create a virtual environment and install Sphinx, all as part of the `make html` command. ---------- assignee: docs@python components: Documentation messages: 294556 nosy: cjrh, docs@python, willingc, zach.ware priority: normal pull_requests: 1909 severity: normal status: open title: DOC: automatically create a venv and install Sphinx when running make versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30487> _______________________________________

5 19

[issue35649] http.client doesn't close. Infinite loop
by Roundup Robot 06 Jan '19

06 Jan '19

Change by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- keywords: +patch, patch, patch, patch pull_requests: +10884, 10885, 10886, 10887 stage: -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35649> _______________________________________

1 0

[issue35649] http.client doesn't close. Infinite loop
by Roundup Robot 06 Jan '19

06 Jan '19

Change by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- keywords: +patch, patch, patch pull_requests: +10884, 10885, 10887 stage: -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35649> _______________________________________

1 0

[issue35649] http.client doesn't close. Infinite loop
by Roundup Robot 06 Jan '19

06 Jan '19

Change by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- keywords: +patch, patch pull_requests: +10884, 10885 stage: -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35649> _______________________________________

1 0

[issue35649] http.client doesn't close. Infinite loop
by Roundup Robot 06 Jan '19

06 Jan '19

Change by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- keywords: +patch pull_requests: +10884 stage: -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35649> _______________________________________

1 0

[issue35616] Change references to '4.0'.
by Terry J. Reedy 05 Jan '19

05 Jan '19

New submission from Terry J. Reedy <tjreedy(a)udel.edu>: https://docs.python.org/3/c-api/unicode.html#deprecated-py-unicode-apis says "Deprecated since version 3.3, will be removed in version 4.0." (I am aware that the quote above was written before we decided that '3.9' should be followed by '3.10' rather than '4.0' to avoid giving mis-impressions.) There is currently no plan for a '4.0' and part of the reason is that it stirs up unnecessary negative feeling in people. For example: https://stackoverflow.com/questions/53899931/why-does-an-empty-string-in-py… The second most upvoted comment (9) is "seeing a reference to a "[Python] 4.0" is giving me anxiety..." – Mike Caron (11000+ reputation). We, as well as they, don't need this. When '4.0' was used in an asyncio deprecation, it was changed. Let us do the same elsewhere. ---------- assignee: docs@python components: Documentation messages: 332745 nosy: docs@python, terry.reedy, vstinner priority: normal severity: normal stage: needs patch status: open title: Change references to '4.0'. versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35616> _______________________________________

5 10

[issue35603] table header in output of difflib.HtmlDiff.make_table is not escaped and can be rendered as code in the browser
by Karthikeyan Singaravelan 05 Jan '19

05 Jan '19

Karthikeyan Singaravelan <tir.karthi(a)gmail.com> added the comment: I have added a doc note under make_file docs which has docs for fromdesc and todesc. make_table refers to make_file for fromdesc and todesc docs. I have added a screenshot of the rendering using note and warning directive. I feel note directive is sufficient for this. Placement and wording suggestions are welcome. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35603> _______________________________________

1 0

[issue35603] table header in output of difflib.HtmlDiff.make_table is not escaped and can be rendered as code in the browser
by Karthikeyan Singaravelan 05 Jan '19

05 Jan '19

Change by Karthikeyan Singaravelan <tir.karthi(a)gmail.com>: ---------- pull_requests: +10878, 10879, 10880 stage: needs patch -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35603> _______________________________________

1 0

[issue35603] table header in output of difflib.HtmlDiff.make_table is not escaped and can be rendered as code in the browser
by Karthikeyan Singaravelan 05 Jan '19

05 Jan '19

Change by Karthikeyan Singaravelan <tir.karthi(a)gmail.com>: ---------- pull_requests: +10878, 10879 stage: needs patch -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35603> _______________________________________

1 0

[issue35603] table header in output of difflib.HtmlDiff.make_table is not escaped and can be rendered as code in the browser
by Karthikeyan Singaravelan 05 Jan '19

05 Jan '19

Change by Karthikeyan Singaravelan <tir.karthi(a)gmail.com>: ---------- pull_requests: +10878 stage: needs patch -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35603> _______________________________________

1 0

[issue35603] table header in output of difflib.HtmlDiff.make_table is not escaped and can be rendered as code in the browser
by Serhiy Storchaka 05 Jan '19

05 Jan '19

Serhiy Storchaka <storchaka+cpython(a)gmail.com> added the comment: Yes, please make a documentation PR. Since this behavior can cause a security hole in the user code, make this note visually attractive (maybe use the "note" directive). ---------- stage: patch review -> needs patch _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35603> _______________________________________

1 0

[issue35649] http.client doesn't close. Infinite loop
by Terry J. Reedy 04 Jan '19

04 Jan '19

Change by Terry J. Reedy <tjreedy(a)udel.edu>: ---------- versions: +Python 3.8 -Python 3.5, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35649> _______________________________________

1 0

[issue15457] consistent treatment of generator terminology
by Chris Jerdonek 04 Jan '19

04 Jan '19

New submission from Chris Jerdonek <chris.jerdonek(a)gmail.com>: The documentation on generators (outside of PEP 255) does not currently educate the reader on the more specific "generator function" and "generator iterator" terminology, or at least not in any consistent or systematic way. For example, the glossary includes only a single entry for "generator," and that entry does not mention the two more specific forms. I think it would help for general discourse purposes if this distinction were made clearer, while still continuing to allow for the use of the generic word "generator" when the context makes it clear. There are also cases where index entries can be improved in this regard, and where references to the section containing details about generators can still be added. I am in the process of completing a proposed patch. ---------- assignee: docs@python components: Documentation keywords: easy messages: 166474 nosy: cjerdonek, docs@python priority: normal severity: normal status: open title: consistent treatment of generator terminology versions: Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15457> _______________________________________

4 12

[issue33896] Document what components make up the filecmp.cmp os.stat signature.
by Cheryl Sabella 04 Jan '19

04 Jan '19

Change by Cheryl Sabella <cheryl.sabella(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python versions: -Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33896> _______________________________________

1 0

[issue35168] shlex punctuation_chars inconsistency
by Cheryl Sabella 04 Jan '19

04 Jan '19

Change by Cheryl Sabella <cheryl.sabella(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation -Library (Lib) keywords: +easy nosy: +docs@python stage: -> needs patch versions: -Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35168> _______________________________________

1 0

[issue35631] Improve typing docs wrt abstract/concrete collection types
by Ville Skyttä 04 Jan '19

04 Jan '19

New submission from Ville Skyttä <ville.skytta(a)iki.fi>: The typing docs for List includes a note to use generic collection types, but lists AbstractSet and Mapping which aren't generally replacements for a List. It would be better to remove those types from the List note and add corresponding ones to Dict and Set which are currently lacking it. Additionally, some examples in the typing docs are in violation of the above stated preference, using Lists and Dicts as parameters. ---------- assignee: docs@python components: Documentation messages: 332842 nosy: docs@python, scop priority: normal severity: normal status: open title: Improve typing docs wrt abstract/concrete collection types type: enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35631> _______________________________________

3 14

[issue35609] Improve of abc.py docstring
by Emmanuel Arias 04 Jan '19

04 Jan '19

New submission from Emmanuel Arias <emmanuelarias30(a)gmail.com>: Hi! I prepare a little improve. I added some samples usage, some clarification and delete some whitespace unnecessary. Attach patch. Regards ---------- assignee: docs@python components: Documentation files: 0001-improve-abc.py-docstring.patch keywords: patch messages: 332693 nosy: docs@python, eamanu priority: normal severity: normal status: open title: Improve of abc.py docstring type: enhancement versions: Python 3.8 Added file: https://bugs.python.org/file48021/0001-improve-abc.py-docstring.patch _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35609> _______________________________________

3 14

[issue35655] documentation have wrong info about fibo module examples
by Juan 04 Jan '19

04 Jan '19

New submission from Juan <juanbaio10(a)gmail.com>: The below sections in modules documentation have wrong information about fibo module: 6. Modules 6.1. More on Modules 6.1.1. Executing modules as scripts 6.3. The dir() Function The name of module is Fibo not fibo and the attributes are fab,fab2 not fib,fib2. root@archlinux ~]# python2 --version Python 2.7.15 [root@archlinux ~]# pip2 --version pip 18.1 from /usr/lib/python2.7/site-packages/pip (python 2.7) [root@archlinux ~]# pip2 install fibo Collecting fibo Using cached https://files.pythonhosted.org/packages/24/50/e74bd48bbef1040afb01b107e6cfb… Installing collected packages: fibo Running setup.py install for fibo ... done Successfully installed fibo-1.0.0 [root@archlinux ~]# pip2 list modules |grep -i fibo Fibo 1.0.0 [root@archlinux ~]# python2 Python 2.7.15 (default, Jun 27 2018, 13:05:28) [GCC 8.1.1 20180531] on linux2 Type "help", "copyright", "credits" or "license" for more information. >>> import fibo Traceback (most recent call last): File "<stdin>", line 1, in <module> ImportError: No module named fibo >>> import Fibo >>> Fibo.fib(10) Traceback (most recent call last): File "<stdin>", line 1, in <module> AttributeError: 'module' object has no attribute 'fib' >>> Fibo.fib2(10) Traceback (most recent call last): File "<stdin>", line 1, in <module> AttributeError: 'module' object has no attribute 'fib2' >>> Fibo.fab(10) 1 1 2 3 5 8 13 21 34 55 >>> Fibo.fab2(10) [1, 1, 2, 3, 5, 8, 13, 21, 34, 55] >>> Fibo.__name__ 'Fibo' >>> dir(Fibo) ['Fab', '__builtins__', '__doc__', '__file__', '__name__', '__package__', 'fab', 'fab2', 'fab4'] ---------- assignee: docs@python components: Documentation messages: 332967 nosy: docs@python, eric.araujo, ezio.melotti, juanbaio10, mdk, willingc priority: normal severity: normal status: open title: documentation have wrong info about fibo module examples type: enhancement 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/issue35655> _______________________________________

2 1

[issue35649] http.client doesn't close. Infinite loop
by Martin Panter 03 Jan '19

03 Jan '19

Martin Panter <vadmium+py(a)gmail.com> added the comment: This was changed in Python 3.2+ in Issue 16723. The response object no longer sets the “closed” attribute when it runs out of data; it is only set when the “close” method is called. Perhaps the example should be amended so that it checks if “read” returned an empty string, rather than checking “closed”. Another problem with the example is that printing the chunk as a bytes object can trigger BytesWarning. I would add a “repr” call to avoid that. ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python, martin.panter _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35649> _______________________________________

2 1

[issue35434] Wrong bpo linked in What's New in 3.8
by Josh Rosenberg 03 Jan '19

03 Jan '19

New submission from Josh Rosenberg <shadowranger+python(a)gmail.com>: https://docs.python.org/3.8/whatsnew/3.8.html#optimizations begins with: shutil.copyfile(), shutil.copy(), shutil.copy2(), shutil.copytree() and shutil.move() use platform-specific “fast-copy” syscalls on Linux, macOS and Solaris in order to copy the file more efficiently. ... more explanation ... (Contributed by Giampaolo Rodola’ in bpo-25427.) That's all correct, except bpo-25427 is about removing the pyvenv script; it should be referencing bpo-33671. ---------- assignee: docs@python components: Documentation keywords: easy messages: 331264 nosy: docs@python, giampaolo.rodola, josh.r priority: low severity: normal status: open title: Wrong bpo linked in What's New in 3.8 versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35434> _______________________________________

5 10

[issue35648] Add use_srcentry parameter to shutil.copytree()
by flokX 03 Jan '19

03 Jan '19

New submission from flokX <accounts(a)fkcore.de>: Currently it is decided if to use the srcentry in the copy_function by checking if the copy_function is copy() or copy2(). This will fail if the copy_function is a modified copy() or copy2() function. To control if the copy_function gets a srcentry or srcname parameter, added the use_srcentry parameter. ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 332923 nosy: docs@python, flokX priority: normal severity: normal status: open title: Add use_srcentry parameter to shutil.copytree() type: enhancement versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35648> _______________________________________

1 4

[issue35603] table header in output of difflib.HtmlDiff.make_table is not escaped and can be rendered as code in the browser
by Serhiy Storchaka 02 Jan '19

02 Jan '19

Change by Serhiy Storchaka <storchaka+cpython(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python versions: +Python 2.7 -Python 3.5, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35603> _______________________________________

1 0

[issue35630] Missing code tag for "python3" in README.rst
by Suriyaa Sundararuban 02 Jan '19

02 Jan '19

New submission from Suriyaa Sundararuban <python(a)suriyaa.tk>: Currently there is no code tag for "python3" in the sentence "This will install Python as python3." (Location: https://github.com/python/cpython#build-instructions). I'm working on this small improvement. ---------- assignee: docs@python components: Documentation messages: 332832 nosy: docs@python, suriyaa priority: normal severity: normal status: open title: Missing code tag for "python3" in README.rst versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35630> _______________________________________

3 12