Mailman 3 December 2022 - docs

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

May 22, 2024

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

Documentation by Version Not Downloadable
by Julian Fortune March 23, 2023

March 23, 2023

Hey wonderful python docs maintainers, I noticed that from the Python Documentation by Version page <https://www.python.org/doc/versions/> if I navigate to a specific version of documentation—even a stable version—, e.g., `3.10.9`, when I go to *Download these documents* all the download links result in a 404 error. Example: https://docs.python.org/ftp/python/doc/3.10.9/python-3.10.9-docs-pdf-letter… *404 — Archive Not Found* > The archive you're trying to download has not been built yet. > Please try again later. Happy holidays and New Year; Thanks! Julian

3 3

Raw String Bug?
by garfield＠garfieldhudson.com March 7, 2023

March 7, 2023

Hi guys, Is this a bug with raw strings? If the last character of the string is a backslash, I get an unterminated string error. If I add another character, the error goes away. I thought that the r prefix rendered everything within the quotes as literals. Thanks, Garfield.

2 4

Minor error in epub format of Documentation
by Mohit Rajput Dec. 30, 2022

Dec. 30, 2022

Hello Python Documentation Team, Thanks a lot for providing a great documentation of Python.Kudos to you. There are some minor error in epub file of documentation. I attach a screenshot. Have a good day. Greetings.

2 1

No docs
by jim＠crazydog.co.uk Dec. 28, 2022

Dec. 28, 2022

When trying to download python documentation from https://docs.python.org/release/3.10.8/download.html all I get is this error message- 404 -- Archive Not Found The archive you're trying to download has not been built yet.

3 4

The EPUB version of python documentation is not working properly!
by Srinivas Tammireddy Dec. 24, 2022

Dec. 24, 2022

The .epub version is not working properly. Kindly look into it.

1 0

Logorithme Bug
by Ugur VARLIKLI Dec. 18, 2022

Dec. 18, 2022

Dear friends, I discovered a bug with logaritmic function. log(1000, 10) gives 2.9999999999999996 in place of 3.0 Thanks a lot. U.V ( ultraviolet )

3 2

Acknowledgements
by Benjamin Gates Dec. 16, 2022

Dec. 16, 2022

Hi Python team. Just to let you know you're doing a great job guys. Keep working hard.

1 0

Error EPUB
by Jorge Wendell Dec. 16, 2022

Dec. 16, 2022

Dear all, good evening, the documentation ead is showing an error in the Books app on macOS Ventura [image: Captura de Tela 2022-12-16 às 03.19.09.png] -- Atenciosamente, *Jorge Wendell Queiros Santos* Analista de Sistemas Desenvolvedor Full Stack https://www.linkedin.com/in/jorgewqs/ jorgewqs(a)gmail.com +55 79 9 8872-0545

1 0

Python 3.11.1 epub can't open
by Howard Wen Dec. 16, 2022

Dec. 16, 2022

please check: This page contains the following errors: error on line 11 at column 70: Unescaped '<' not allowed in attributes values Below is a rendering of the page up to the first error. Regards, Howard

1 0