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

Requested Update in Slicing Method help files & Documentation
by outbox training info June 27, 2022

June 27, 2022

Dear Team, Greetings about your tremendous work in the Python project. Here, we noticed Slicing methods syntax and its help doc may be confusing some people. *Default Slicing method syntax :* *[start:stop:step]* start : start position / indices value in the list. stop : stop position / indices value in the list. step : step up value here, we thought as stop position will be calculated as n-1. it is good for (positive) indexing. but, in negative indexing it will make some confusion. so, we think that, following would be best for everyone to be clear about slicing method syntax. *Requested Slicing method syntax update:* *[start_at:stop_before:step_up_jump]* start_at : start at the position / indices value in the list. stop_before : stop before the position / indices value in the list. step_up_jump : step up jump as per given value

1 0

Python 3.9.1 Documentation - Compressed documentation packages absent
by Lenina Lopez June 25, 2022

June 25, 2022

To Python's Documentation team: Hi there! I've been trying to download Python 3.9.1 documentation set in pdf format at https://docs.python.org/release/3.9.1/download.html but the link is not working and returns an HTTP error 404 with the legend _The archive you're trying to download has not been built yet_. Thought you might wanna know. Cheers! L.// -- ·º·.·º·.·º·.[¥]__/*/º¨º¨Lenina Luciana V. Lopez /[¥] --=akt=-- //* LU 0xf8/0x04 *// (\__/) (='.'=)This is Bunny. Copy and paste bunny into (")_(")your signature to help him gain world domination.

1 0

Using Python on a Mac page out of date and erroneous
by Mark Woodman June 18, 2022

June 18, 2022

Hi I’m sorry I don’t yet know what a sensible replacement description would be or I would suggest a fix, but the page on Python on a Mac is badly out of date: 3.10.5 Documentation » Python Setup and Usage » Using Python on a Mac It wrongly states that Python is pre-installed on MacOS (it’s not now), and thinks the Intel-based Macs are “new”, and that universal binaries are for Intel and Power PC, rather than Apple Silicon and Intel. I was hoping to set up a set of virtual environments for development on a Mac, with PC-style selectable interpreters, but the package installer from Python.org will not allow a location to be selected for installation, implying that only one instance of the interpreter is allowed, which seems a very backward step. Best regards ––– Prof. Mark Woodman, PhD Director, IT Changes Ltd. | Co-founder Digital Acumen linkedin.com/in/mark-woodman

3 2

Python 3.10.5 and OpenCV Bug
by Jathin Pranav Singaraju June 18, 2022

June 18, 2022

To whom it may concern: I hope you are doing well! I have found a bug. Please see the details below: OpenCV Package's latest version (4.6.0.66) is incompatible with both Python 3.8.10 and Python 3.10.5. One of the OpenCV Package's previous versions (4.5.4.60) is also incompatible with Python 3.10.5. Therefore, I downgraded my Python from 3.10.5 to 3.8.10 and the OpenCV Package from 4.6.0.66 to 4.5.4.60. After that, it worked! All this occurs when I am trying to use Pyinstaller to convert my python file to an application. I believe that by making both Python and OpenCV latest versions compatible, this issue would be resolved. This is my first time reporting a bug, so I don't really know the process. Please resolve it so that I can continue with my project using the latest technology! Please let me know if you need anything else. Thank you, Pranav Singaraju

2 1

(RSVP)Python docs / PDF files / Licence question /
by Silpiö Kari June 9, 2022

June 9, 2022

Hi At Haaga-Helia University of Applied Sciences (www.haaga-helia.fi), we are developing a new Python course that starts soon. We have a question regading the PDF versions of the Python documentation files. The PDF versions of the language reference etc. are available in a ZIP file on https://docs.python.org/3/download.html Therefore, the PDF files cannot be linked directly to our course pages. We are not sure about the copyright licence regarding those PDF files. That is, would we be allowed to extract the languge reference, library reference and tutorial from the ZIP file and add them to our course's home page. Or, are those files available for direct linking somewhere else? Kind regards, Kari Silpiö Senior lecturer Haaga-Helia University of Applied Sciences Finland

2 1

GEO-blocked link
by Grob Grobmann June 7, 2022

June 7, 2022

Hi! I was reading the curses HOWTO <https://docs.python.org/3/howto/curses.html> and I realized that one of the links in the "for more information" section is set by the owner to block my country, Argentina (and who knows how many other countries). See attachment I don't think python should be redirecting traffic to a site that imposes arbitrary bans on IPs from an entire nation, for no good reason. Yours truly, Grob Grobmann

1 0

document download error
by Jack W Hallmark June 6, 2022

June 6, 2022

I keep getting error 403 ' Forbidden' every time I try to download the version 3.10.4 documentation. Thanks! JW

2 1

Confusing documentation at cpython-test-docs.readthedocs.io
by Justin Su June 6, 2022

June 6, 2022

Hi there, While Googling for "python 2 enum" (to see if Enums are available in Python 2), I found this strange result at the top: [image: Screen Shot 2022-06-03 at 4.10.50 PM.png] The link goes to https://cpython-test-docs.readthedocs.io/en/latest/library/enum.html. This seems like a pretty outdated (test?) version of the docs, given that the homepage is versioned at Python 2.7.6. However, the contents seem to be documentation for Python 3, which is a little confusing. Is there some way this could be updated or entirely removed? Best, Justin

3 2