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

SMTPHandler secure argument without credentials
by William Edwards Sept. 15, 2022

Sept. 15, 2022

logging.handlers.SMTPHandler only uses the 'secure' argument when credentials are specified. https://docs.python.org/3/library/logging.handlers.html#logging.handlers.SM… says: "To specify the use of a secure protocol (TLS), pass in a tuple to the secure argument. This will only be used when authentication credentials are supplied." The docstring confirms this, but I can't find an explanation of the intent behind this behaviour. Perhaps it would be a good idea to describe this as well.

1 1

ePub doc file not ok!
by H.P.M. (Erik) Adriaens May 26, 2022

May 26, 2022

Hello, I see a problem with the yellow area's in the python-3.10.4-docs.epub file. Do you have a solution? thanks Vriendelijke groeten, H.P.M. (Erik) Adriaens Lambertusheufke 9 NL - 6015 BM Neeritter The Netherlands T: +31 (0) 475 - 56 40 26 M: +31 (0) 6 - 1928 2001 E: <mailto:erik.adriaens@hetnet.nl> erik.adriaens(a)hetnet.nl "De waarheid is niet democratisch"

1 0

bug in documentation
by Chris Gu May 22, 2022

May 22, 2022

Dear docs team, The code in the section "Approximating importlib.import_module()" [ https://docs.python.org/3/library/importlib.html#approximating-importlib-im…] has an error. It seems that if, for, else should not be all aligned at the same level, unless there is a new syntax of Python that I do not know. Best, Chris

2 2

socket documentation: "packages" -> "packets"
by Victor Norman May 18, 2022

May 18, 2022

In the documentation for sockets (https://docs.python.org/3/library/socket.html) socket — Low-level networking interface — Python 3.10.4 documentation<https://docs.python.org/3/library/socket.html> The Python interface is a straightforward transliteration of the Unix system call and library interface for sockets to Python’s object-oriented style: the socket() function returns a socket object whose methods implement the various socket system calls. Parameter types are somewhat higher-level than in the C interface: as with read() and write() operations on Python files, buffer allocation ... docs.python.org there are examples with comments like: # receive all packages and # receive a package These should say "packets" or "packet". Prof. Victor Norman Computer Science Calvin College University vtn2(a)calvin.edu<mailto:vnorman@calvin.edu> ----- "A designer knows he has achieved perfection not when there is nothing left to add, but when there is nothing left to take away." -- Antoine de Saint Exupéry

2 1

Reporting a Bug
by Jeff Jeffi May 12, 2022

May 12, 2022

Hello dears, First of all i am not sure about this issue please advise me if there is any mistake in my report. for example in python 3.6.3 shell: >>> x= "The meaning of life" >>> x.strip("meaning") 'The meaning of lif' As you see the letter "e" of the word "life" is removed. Sincerely yours. J.Mohammadi

3 2

The Python Library Reference, Release 3.10.4 page 133
by khudadat baluch May 10, 2022

May 10, 2022

is it : Raw string notation (r"text") keeps regular expressions sane. or: Raw string notation (r"text") keeps regular expressions same. sane or same

2 1

please check page 29 Python Tutorial
by khudadat baluch May 7, 2022

May 7, 2022

You can see it if you really want to using print(): the above needs to be: You can see it if you really want to use print(): You can see it if you really want by using print():

3 2

Bug?
by Rhoades, Austin May 7, 2022

May 7, 2022

[cid:image001.png@01D85F8F.53284620] I enter the same and receive invalid syntax. I am new to this. [cid:image002.png@01D85F8F.53284620] ________________________________ This message is for the designated recipient only and may contain privileged, proprietary, or otherwise confidential information. If you have received it in error, please notify the sender immediately and delete the original. Any other use of the e-mail by you is prohibited. Where allowed by local law, electronic communications with Accenture and its affiliates, including e-mail and instant messaging (including content), may be scanned by our systems for the purposes of information security and assessment of internal compliance with Accenture policy. Your privacy is important to us. Accenture uses your personal data only in compliance with data protection laws. For further information on how Accenture processes your personal data, please see our privacy statement at https://www.accenture.com/us-en/privacy-policy. ______________________________________________________________________________________ www.accenture.com

2 1

mistake in page 16 of Python Tutorial Release 3.10.4
by khudadat baluch May 6, 2022

May 6, 2022

5 * 3 + 2 # floored quotient * divisor + remainder this can be improved if referenced to the previous example, 'in the above'. but i found it not clear by itself without referring back to the above.

1 0