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

ISO 8601 week date
by rafal1.1990＠o2.pl 24 Oct '21

24 Oct '21

I wonder why https://docs.python.org/3.8/library/time.html#time.strftime is missing the directives %G, %u and %V for the ISO week date, although they work: $ python3 Python 3.8.10 (default, Sep 28 2021, 16:10:42) [GCC 9.3.0] on linux Type "help", "copyright", "credits" or "license" for more information. >>> from time import strftime >>> strftime("%G-W%V-%u") '2021-W42-7' Were these directives forgotten in the documentation or why were they not documented? Best regards, Rafał

2 2

Re: doc issue: .python_history
by mouse＠ip4b.ca 22 Oct '21

22 Oct '21

>> I am using python 3.7.3 on Debian 10 and I'm finding it writing >> .python_history in my homedir. I want to shut that off completely > According to [docs.python.org/3/library/site.html] it's possible: That much, I already found. I spent some time playing with putting various things in sys.__interactivehook__ and have so far failed to find the magic incantation necessary to stop it from writing .python_history - I'm perfectly willing to believe one exists, but I have not managed to find it, either in documentation or on my own. Everything I've tried either errored out during startup or still wrote .python_history. Mouse

1 0

(no subject)
by Like Slee 22 Oct '21

22 Oct '21

I'm having a problem in downloading the documentation for the latest version(3.10) from the links provided. It is showing me an error message: the webpage is not available or the page may have been deleted. Can you help please!!

2 1

doc issue: .python_history
by mouse＠ip4b.ca 22 Oct '21

22 Oct '21

I am using python 3.7.3 on Debian 10 and I'm finding it writing .python_history in my homedir. I want to shut that off completely; I want it to never, ever, write ~/.python_history (I don't care whether it tries to read it, because it will never be there once I managed to suppress writing it). docs.python.org/3.7/tutorial/interactive.html says that "[t]he default configuration also saves your history into a file named .python_history in your user directory", implying that there is some way to configure it otherwise. But I see no documentation on the relevant configuration, either there or in the analogous page for current python. Presumably I'm just missing something, but it would be nice to see some kind of pointer to the relevant configuration documentation. I've been thrashing around trying to set sys.__interactivehook__ in $PYTHONSTARTUP, that being my best guess at what I need to use based on a few searches, but have so far failed to find the magic incantation that will suppress writing ~/.python_history. I don't know whether I'm failing to set it or just haven't found the right thing to set it to. Mouse

2 1

Usage Example for csv.DictWriter
by Bill Melvin 16 Oct '21

16 Oct '21

Function prototype shows fieldnames as a positional parameter but usage example shows it as a keyword argument. https://docs.python.org/3/library/csv.html#csv.DictWriter

2 2

Epub file issue
by kbasaran＠gmail.com 16 Oct '21

16 Oct '21

2 1

Reporting of bugs in python 3.10.0 - Regarding
by ABDUR RAHIM 16 Oct '21

16 Oct '21

hello, These are two bugs I have Faced in 3.10.0 (SPM) . i attached for your reference. Kindly, Solve those Problems. Regards , Abdur rahim & Abdur razzak

2 1