Mailman 3 November 2023 - docs

A suggestion for improving the documentation of chapter 10.9. Data Compression
by Guy Goldner 22 May '24

22 May '24

Hello dear Python gods :) I'm new at Python and was going over the documentation . This useful paragraph : https://docs.python.org/3.7/tutorial/stdlib.html#data-compression provides info for compressing text but IMHO some important additional info is needed, without which I expect nearly all users would get stuck just as I have. Moreover, while looking for a solution I noticed a lot of articles with outdated examples which no longer work - this confused me even more to the point I started suspecting something was amiss on my end... Anyhow, adding this info would do the trick : zlib works only with bytes and in Python 3.x strings are no longer bytes. Example : *>>> zlib.compress('this is a sample string which does not work in zlib because it requires bytes and not unicode')Traceback (most recent call last): File "<stdin>", line 1, in <module>TypeError: a bytes-like object is required, not 'str'>>>* Luckily Python has a very simple solution for this : encode to utf-8, compress, decode back to unicode like so : *>>> text = 'this is a sample string which does not work in zlib because it requires bytes and not unicode with chars like this »שלום '>>> encoded = text.encode()>>> text = 'this is a sample with unicode chars »שלום '>>> encoded = text.encode()>>> compressed = zlib.compress(encoded)>>> decompressed = zlib.decompress(compressed)>>> decoded = decompressed.decode()>>> len(text),len(encoded),len(compressed) #notice that compression of short strings can be larger than the original(42, 47, 54)>>> print(text,'\n',encoded,'\n',compressed)this is a sample with unicode chars »שלום b'this is a sample with unicode chars \xc2\xbb\xd7\xa9\xd7\x9c\xd7\x95\xd7\x9d ' b'x\x9c+\xc9\xc8,V\x00\xa2D\x85\xe2\xc4\xdc\x82\x9cT\x85\xf2\xcc\x92\x0c\x85\xd2\xbc\xcc\xe4\xfc\x94T\x85\xe4\x8c\xc4\xa2b\x85C\xbb\xaf\xaf\xbc>\xe7\xfa\xd4\xebs\x15\x00\xb2K\x14|'>>> text == decodedTrue* Thank you ! You are doing a great thing ! B.R., Guy Goldner

2 2

Getting tkinter...
by Steve Philcox 08 Jan '24

08 Jan '24

Hi, I'm at https://docs.python.org/3.8/library/tkinter.html#:~:text=Running%20python%2… . There's a helpful paragraph that explains how to check/confirm that tkinter is present. I clearly don't have it. My suggestion is to add something to guide the unfortunate to where/how to get it! I arrived at that page via google - 'python can't find tkinter' I'm running ubuntu and python3. My knowledge of managing python is limited but I have tried 'pip install tkinter' and that hasn't worked. It said success but python didn't find tkinter. I have since tried 'sudo apt install python3.8-tk' and that said: Note, selecting 'python3-tk' instead of 'python3.8-tk' So, I now have a working tkinter. You could make it a bit easier! Regards, Steve Philcox

2 1

python 3.12 epub doc incorrect
by sobi 26 Nov '23

26 Nov '23

Hi, just wanted to let you know, your EPUB from link below is probably incorrectly formatted as Amazon is not allowing it upload to Kindle device (using Kindle Scribe with the latest OS version) via Send to Kindle web page (https://www.amazon.com/sendtokindle) Please do you have any idea how to fix this? https://docs.python.org/3.12/download.html [image: image.png] from send to kindle app: [image: image.png] cheers, jan

1 0

Doc Edit Suggestion
by Sierra Camper 16 Nov '23

16 Nov '23

Good Afternoon, I have an edit suggestion for The Python Tutorial. In section 2.1 Invoking The Interpreter states: [cid:e1a1a2e6-39da-4c4c-9600-31b686736ca2] Now, I have tried many times and many variations to try and make that code statement launch the interpreter but to no avail. I have reached to others for help on various social media sites and forums and the advice they give me is not even relating to my question. My question being: How and where do input this code EXACTLY to make it launch the interpreter. I am starting to think that it just doesn't work due to lack of instruction or just being outdated information. I am requesting that you look into this matter. Please try and find a way to make that code or please remove that section of the tutorial. Thank you very much, Sierra Camper CCEC | Receptionist O: (888) 284 - 1250

2 1

Python tutorial documentation
by John.Garland107＠mod.gov.uk 16 Nov '23

16 Nov '23

Dear Sir or Madam. We have found the following tutorials which we would like to get hard copy of https://www.astro.keele.ac.uk/shen/resources/python/python-tutorial/view Python tutorial release 2.7.1 by Guido van Rossum. Guido van Rossum Fred L. Drake, Jr., editor April 18, 2011 Python Software Foundation http://marvin.cs.uidaho.edu/Teaching/CS515/pythonTutorial.pdf Python Tutorial Release 3.2.3 Guido van Rossum Fred L. Drake, Jr., editor June 18, 2012 Python Software Foundation I can see the documents are copyright: 'Python and this documentation is: Copyright © 2001-2010 Python Software Foundation. All rights reserved. Copyright © 2000 BeOpen.com. All rights reserved. Copyright © 1995-2000 Corporation for National Research Initiatives. All rights reserved. Copyright © 1991-1995 Stichting Mathematisch Centrum. All rights reserved' Can we either have permission to print copies for the library or can you tell me how I can purchase them? Many thanks and kindest regards John John Garland Library Manager | DSCIS | DCTT (he/him/his Why is this here?<https://medium.com/gender-inclusivit/why-i-put-pronouns-on-my-email-signatu…>) Technical Library | Old School Building | Blandford Forum | Dorset | DT11 8RH 94371 2321 | 01258 482321 | john.garland107(a)mod.gov.uk Check your loans, renew and reserve books on the Library Online Catalogue<https://dscisteclib.cirqahosting.com/> Library Opening hours: Mon - Thur 0815 - 1230 & 1300 - 1515 Fri 0815 - 1200

2 1

Potential typo in Profiler docs?
by 2dfkit 09 Nov '23

09 Nov '23

In the[profiler docs](https://docs.python.org/3/library/profile.html), under the first profiler output example, it says > ... The next line:Ordered by: cumulative time, indicates that the text string in the far right column was used to sort the output. This doesn't appear to make sense, and indeed the example output is sorted by the "cumtime" column, and not by the text string column at the far right. Am I misreading this or is this a typo? Thanks! PS. Sorry I didn't raise a ticket, I'm new and shy about posting in public forums

3 5

about deprecated document
by SUN Guonian 09 Nov '23

09 Nov '23

hi, When I browse subprocess document on (https://docs.python.org/3.11/library/subprocess.html) I find some piece about "Replacing os.popen(), os.popen2(), os.popen3()", but I can't find any popen3() in module os, untill I search the document to version 2.7. Maybe the content related to the deprecated document should be cleaned in the latest version. Best Regards, SUN Guonian

2 1

Problem in help for str().rsplit()
by Alan Brogan 09 Nov '23

09 Nov '23

Greetings to the list Not sure where this report should be sent, so I’m hoping the good people on this list can help to forward it on. The docs suggest I should distinguish a bug as being either of the docs, or of the implementation, but this one is in the docstring of the function, so which does that count as??? What I would call "the docs” (https://docs.python.org/3/library/stdtypes.html?highlight=rsplit#str.rsplit <https://docs.python.org/3/library/stdtypes.html?highlight=rsplit#str.rsplit>) explains the function differently, and is (AFAICT) correct Problem is in docstring for the str().rsplit() method: >>> help(str().rsplit) Help on built-in function rsplit: rsplit(sep=None, maxsplit=-1) method of builtins.str instance Return a list of the substrings in the string, using sep as the separator string. sep The separator used to split the string. When set to None (the default value), will split on any whitespace character (including \\n \\r \\t \\f and spaces) and will discard empty strings from the result. maxsplit Maximum number of splits (starting from the left). -1 (the default value) means no limit. Splitting starts at the end of the string and works to the front. Problem is at the phrase "(starting from the left)” I think that should actually say “starting from the right”, because >>> s = "alan was here today" >>> s.rsplit(" ", 1) ['alan was here', 'today'] -- Alan

2 1

Errors in 3.11.4 EPUB version
by Ranjith B 09 Nov '23

09 Nov '23

Dear Python community, The EPUB version for 3.11.4 is not readable. Each page contains errors like the following: “This page contains the following errors: error on line 22 at column 19: Specification mandates value for attribute defer Below is a rendering of the page up to the first error.” Please fix the issue. Thank you, Best Regards, Ranjith

2 1

EPUB version of documenation
by Glenn Street 09 Nov '23

09 Nov '23

Hi! When I try to open the EPUB version of the Python documentation from Download Python 3.11.4 Documentation <https://docs.python.org/3/archives/python-3.11.4-docs.epub> using Apple’s Books program, i get the following error on every page. Please advise. Best wishes, Glenn Street

2 1