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

Error in Lists for heterogenous
by kid games Feb. 17, 2022

Feb. 17, 2022

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 Feb. 7, 2022

Feb. 7, 2022

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 Feb. 7, 2022

Feb. 7, 2022

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 Jan. 24, 2022

Jan. 24, 2022

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 Jan. 24, 2022

Jan. 24, 2022

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 Jan. 23, 2022

Jan. 23, 2022

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 Jan. 13, 2022

Jan. 13, 2022

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 Jan. 10, 2022

Jan. 10, 2022

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