Mailman 3 October 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

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

Python 3.11 Docs Not Found
by Aziz Shroff Oct. 27, 2022

Oct. 27, 2022

There are no doc files in the 3.11 doc link below, getting following error while trying to download.404 — Archive Not Found https://docs.python.org/release/3.11.0/download.html

3 2

Bugs in documentation
by Olga Kozlova Oct. 24, 2022

Oct. 24, 2022

Hi! I want to report bug in dis documentation. Firstly, in the FOR_ITER (https://docs.python.org/release/3.10.6/library/dis.html#opcode-FOR_ITER) the byte counter is not incremented by delta, but become delta. Secondly, it is not obviously that you should take i-th element from the top of stack in operations like (SET_ADD https://docs.python.org/release/3.10.6/library/dis.html#opcode-SET_ADD) With respect, Olga Kozlova

1 0

Python documentation offline
by chicoary＠icloud.com Oct. 21, 2022

Oct. 21, 2022

All links to download the documentation are down. Francisco Ary "Estes são os meus princípios. Se você não gosta deles, eu tenho outros." Grouch Marx

1 0

a wrong desc in this doc
by 胥瑞 Oct. 18, 2022

Oct. 18, 2022

https://docs.python.org/3.10/library/concurrent.futures.html "submit(*fn*, */*, **args*, ***kwargs*)¶ <https://docs.python.org/3.10/library/concurrent.futures.html#concurrent.fut…> " xurui

2 1

Minor documentation bugs related to expressions and the assignment expression
by Denilson Sá Maia Oct. 5, 2022

Oct. 5, 2022

Hello! I was looking at https://docs.python.org/3.10/reference/expressions.html and I found a few minor opportunities for improvements: 1. Lowest priority? At section 6.13, it says: “Conditional expressions (sometimes called a “ternary operator”) have the lowest priority of all Python operations.” However, further down below in the "6.17. Operator precedence" section, the if-else expression has higher precedence than both lambda and walrus. Maybe those two are not technically "operations", but since they are under operator precedence, they are operations. It's confusing, and it's a minor detail, but still worth fixing. 2. Indexing the walrus operator If you look at the main index: https://docs.python.org/3.10/genindex-all.html You can find most operators, but you can't find the walrus operator. Try Ctrl+F and search for "walrus", ":=", "named expression", "assignment expression", "assignment"→"expression". You can't find them anywhere in the index. Sure, you can find them at the main search page: https://docs.python.org/3.10/search.html?q=walrus Again, a minor issue, but still worth fixing. And since I know the walrus operator is new, I wonder if any of the newer sections of the documentation could also suffer from the same issue. Best regards, -- Denilson Figueiredo de Sá Maia http://denilson.sa.nom.br/

2 1

Documentation Error on 3.10.1: https://docs.python.org/3/tutorial/introduction.html
by N. Srinivasan Oct. 5, 2022

Oct. 5, 2022

>>> word = 'Python' >>> word[0] # character in position 0 'P'It should be upper case "P". Best Regards,N. Srivasan

2 1