Mailman 3 August 2021 - 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

SMTPHandler secure argument without credentials
by William Edwards 15 Sep '22

15 Sep '22

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

Bug in Python.
by Prakash Mudholkar 07 Feb '22

07 Feb '22

Hello - I wish to bring to your kind notice a bug in Python. Given any matrix X. While trying to compute the CoVariance matrix of that matrix X, Python does NOT compute the CoVarianceof the given matrix X. Instead, Python comptes the CoVariance of the Transpose of the given matrix X. This appears to be a bug in Python. Please refer to the below website for a given matrix and what the result should be after the computation of it's CoVariance. And I have provided a screenshot of what Python is returning. https://www.itl.nist.gov/div898/handbook/pmc/section5/pmc541.htm Please let me know if you have any questions. Regards, Prakash

3 2

3.9.7 downloadable docs missing from web interface, but do exist
by John Ham 31 Aug '21

31 Aug '21

3.9.7 downloadable docs missing It seems there is no coordination between release of the python interpreter and the documentation. Perhaps the two parts of the web pages could be updated together as one transaction to ensure there is never one without the other (only matched sets of docs/interpreter can be put live on the page)? I refer specifically to https://docs.python.org/3.9/download.html and https://www.python.org/downloads/release/python-397/ and I need the html .tar.bz2 from docs to build the python if I want online help, right? It must exist or they couldn't build the binary releases, right? But it isn't on the web site anywhere I can find it. I did hunt around and finally found it here: https://www.python.org/ftp/python/doc/3.9.7/ But will most people be that patient? Anyway, please reconsider your current policy (for last several releases) of not releasing this stuff in tandem in one transaction via the website. It's irksome to have to go hunt for it every time.... It's not my browser webcache (I cleared it to be sure).

1 0

base64 documentation page - English language mistake
by Filip Kocon 26 Aug '21

26 Aug '21

Hi, In the second paragraph, first sentence of base64 docs it says "The RFC 3548 encodings are suitable for encoding binary data so that it can safely sent by email, used as parts of URLs, or included as part of an HTTP POST request." but it misses a 'be'. It should be " "The RFC 3548 encodings are suitable for encoding binary data so that it can *be* safely sent by email, used as parts of URLs, or included as part of an HTTP POST request." Link to page: https://docs.python.org/3/library/base64.html Thanks, Kanaji

1 0

Error validating epub documentation.
by fernando martin garcia 24 Aug '21

24 Aug '21

Hello, I downloaded the epub documentation and couldn't upload to Google Play Books. So I uploaded it here http://validator.idpf.org/ and got many errors. EPUB Validator (beta)<http://validator.idpf.org/> EPUB Validator (beta) Submit an EPUB document for validation. Your file must be 10MB or less. validator.idpf.org Thank you. Fernando.

2 1

Regarding inability of Python Module Winsound to produce beep in decimal frequency
by Umang Goswami 13 Aug '21

13 Aug '21

Hi There, Hope you find this mail in good health. I am Umang Goswami, a Python developer and student working on a huge project for automation of music instruments. I am producing the musical notes using the Beep function of Winsound Module( https://docs.python.org/3/library/winsound.html) by passing frequency as a argument to the function. Now whenever i provide frequency of any note in decimal(for example 277.1826 for C4 note) it shows following error: Traceback (most recent call last): File "C:\Users\Umang Goswami\Desktop\Umang Goswami\test.py", line 2, in <module> winsound.Beep(111.11,111111) TypeError: integer argument expected, got float Now I have to round up the frequencies. This is hurting the quality, accuracy ,authenticity and future of the project. Almost all the notes have the frequencies in decimal parts. Rounding up means changing semitones and quatertones thus whole note itself. This problem is technically making my program useless. Its my humble request to you all, I beg you, Please tell me how to overcome this issue. I have consulted many sources both online and offline but I remained unsatisfied. I can not make audio files of each note because there are many many notes and so practically making so many files of different time length wont help. Please suggest to me the way to resolve this issue or is there any other module to produce the sound of decimal frequency. Waiting in your reply, Umang Goswami

1 0

Found a typo; correction attached
by Andrew Predoehl 11 Aug '21

11 Aug '21

I found the a typo on the current python 3.9.6 page for the "statistics" package: the page says "nomimal" but the intent is "nominal." The page is visible at https://docs.python.org/3/library/statistics.html <https://docs.python.org/3/library/statistics.html>. I've attached corrected page source -- not certain I did so correctly.

1 0

About python libraries
by Hawra'a AbdulRazzaq 09 Aug '21

09 Aug '21

Hello there My name's Hawraa I'm doing master's degree in computer science and i have to write an assignment about python i was researching for python libraries and found your pdf provided with an email please can you send my all the types of libraries and it's types Best regards

1 0