Mailman 3 January 2022 - 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

Error in Lists for heterogenous
by kid games 16 Feb '22

16 Feb '22

Hi Team, Type Error in doc for Lists can also store heterogenous items along with homogenous items. [image: image.png] Kind Regards, Ajay Takur ✆ : +91-8801282523 ````````````````````````````` Use what you know. Do what you've always imagined.

2 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

maybe a bug in Tutorial doc
by GC Toph 07 Feb '22

07 Feb '22

In python 3.10.1 documentation(The Python Tutorial -> An Informal introduction to Python -> Lists) [cid:image003.png@01D803C1.44B36A90] Maybe it should be replaced by “deep copy” ? Here is my try: [cid:image005.png@01D803C1.44B36A90]

2 1

Serious doc issue
by Martin Rinehart 24 Jan '22

24 Jan '22

Section 4.2, More Control Flow, depends on 'collections' that have NOT been introduced yet. (The current doc. They are introduced in earlier versions.) I can no longer make headway here. Am now looking for better docs. -- Martin Rinehart Frontend Engineering <http://martinrinehart.com> (845) 610-5597

1 0

floor division, python intro
by Martin Rinehart 24 Jan '22

24 Jan '22

Learning python, "Informal Intro" 3.1.1, Numbers. The text says "do floor division <https://docs.python.org/3/glossary.html#term-floor-division> and get an integer result (discarding any fractional result)" I've tested and it appears that floor division rounds down to the nearest integer. (Above is not true for negative values with fractional parts. 3.333 rounds to 3, -3.333 rounds to -4.) -- Martin Rinehart Frontend Engineering <http://martinrinehart.com> (845) 610-5597

1 0

add, mul operators also support strings
by Gabriel Sroka 23 Jan '22

23 Jan '22

https://docs.python.org/3/library/operator.html says "operator.add ... Return a + b, for *a* and *b* numbers " and "operator.mul... Return a * b, for *a* and *b* numbers" but both of those also work on strings [0] (and perhaps other types): >>> import operator >>> operator.add('s', 't') 'st' >>> operator.mul('a', 3) 'aaa' >>> operator.mul(3, 'b') 'bbb' [0] "Strings can be concatenated (glued together) with the + operator, and repeated with *" >>> 3 * 'un' + 'ium''unununium' https://docs.python.org/3/tutorial/introduction.html#strings

1 0

Suggestions for the Beginner's Guide in MoinMoin
by Mickey Petersen 13 Jan '22

13 Jan '22

Dear Python Docs Maintainers, I've noticed that a few of the links on https://wiki.python.org/moin/BeginnersGuide Point to the same domain name, and that several are serving up websites with broken TLS certificates: - HackInScience - free and open source platform. - High School Technology Services - for general Python Both seem to route to the same domain. Just FYI. Also, I was wondering if you'd consider adding Inspired Python to your list of beginner and Intermediate/Advanced Learners' pages? https://www.inspiredpython.com It's a free site dedicated to teaching Python and software engineering concepts in-depth. Incidentally, the section I have on the new Structural Pattern Matching feature in 3.10 might be usefully linked to elsewhere, as I know it's a complex subject people are struggling with: https://www.inspiredpython.com/course/pattern-matching/mastering-structural… Thanks in advance, Mickey.

2 1

Python 3.10.1
by Ronald Massey 09 Jan '22

09 Jan '22

Don’t take this wrong I really love working with Python but since I updated to 3.10.1 I receive errors from the programs that I’m using, ( PyCharm, Visual Studio Code and Visual Studio 2022) they all complain that this version is invalid plus trying to use pip is no longer seen by the program, if I try something like ( pip install {any program} I receive an error that pip and install are invalid. Do I need to go back to the old version of Python, I hope you have a fix for this, I’m lost on this one. Thank you for your help. Ronald W. Massey Sent from Mail<https://go.microsoft.com/fwlink/?LinkId=550986> for Windows

1 0