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

(no subject)
by Zhao Babycat March 23, 2023

March 23, 2023

Hello~ I found all the download link on Download �� Python 3.11.1 documentation<https://docs.python.org/release/3.11.1/download.html> web page will show 404��. Do the documents cannot be download now? If it is possible, would you please help me? Thank you very much! Windows �� `��<https://go.microsoft.com/fwlink/?LinkId=550986> ��

2 1

Documentation by Version Not Downloadable
by Julian Fortune March 23, 2023

March 23, 2023

Hey wonderful python docs maintainers, I noticed that from the Python Documentation by Version page <https://www.python.org/doc/versions/> if I navigate to a specific version of documentation—even a stable version—, e.g., `3.10.9`, when I go to *Download these documents* all the download links result in a 404 error. Example: https://docs.python.org/ftp/python/doc/3.10.9/python-3.10.9-docs-pdf-letter… *404 — Archive Not Found* > The archive you're trying to download has not been built yet. > Please try again later. Happy holidays and New Year; Thanks! Julian

3 3

Raw String Bug?
by garfield＠garfieldhudson.com March 7, 2023

March 7, 2023

Hi guys, Is this a bug with raw strings? If the last character of the string is a backslash, I get an unterminated string error. If I add another character, the error goes away. I thought that the r prefix rendered everything within the quotes as literals. Thanks, Garfield.

2 4

Installing Python on Mac OS
by Katherine Campbell Jan. 31, 2023

Jan. 31, 2023

Hi, I am for the first time installing Python on a Mac running OS 12.6 (Monterey). The Install package nicely put a Python folder in my Applications file and presumable distributed many other things around. I had to go to a third-party site to discover that python is actually in /Library/Frameworks/Python.framwork…. So right now, not having done anything, when I open a Mac terminal window and type python or python -V, it still thinks I have no version installed. You’d think, wouldn’t you, that the installer would at least have put a link in one of the directories in the default PATH? But failing that your documentation needs to suggest how you get the Terminal to recognize that Python has been installed. And maybe to discuss IDLE, which is another totally new thing to me, but appears to be your alternative to running python from the Terminal?? At least tell me that, if that is true! I am not a developer! I know Mac OS is not everyone’s favorite operating system (and maybe some day I’ll manage to move myself on to Linux; Windows is out of the question) but for now, an awful lot of people live on Macs. Kathy

3 2

Egyptian Learner(Beginner)
by Ehab Mohamed Jan. 28, 2023

Jan. 28, 2023

I am really happy to learn python as it is The most easy programming language to be learned I wish if you have a python doc in arabic language coz I started learning (English docs) but many concepts i could not go on unless i have an arabic copyof it for that please if you can send me that,I appreciate it alot thanks

1 0

Python 3 docs on Customizing LogRecord
by Jiann-Ming Su Jan. 26, 2023

Jan. 26, 2023

For Python 3, the [Customizing LogRecord](https://docs.python.org/3/howto/logging-cookbook.html#customizin… should be placed at the beginning of the [Adding contextual information to your logging output](https://docs.python.org/3/howto/logging-cookbook.html#adding-contex… section. ___ Jiann-Ming Su Sent with [Proton Mail](https://proton.me/) secure email.

1 0

"a" mode description is incorrect
by Filo Bus Jan. 25, 2023

Jan. 25, 2023

https://docs.python.org/3/library/functions.html#open (it creates the file if it doesn't exist)

1 0

Problem with Imap Python Library
by Guillem Cortiada Rovira Jan. 6, 2023

Jan. 6, 2023

To Whom It May Concern, We are aware that the imap library has changed the way to authenticate and it does not allow the simple authentication. So, we are trying to authenticate via OAUTH2 authentication. Here, I show you an example of how we are trying to recover the inbox of our email: # Your Outlook account email address email = your-email(a)outlook.com<mailto:your-email@outlook.com> # The access token for your Outlook account access_token = "your-access-token" # Connect to the IMAP server imap_server = imaplib.IMAP4_SSL("outlook.office365.com") # Authenticate using the access token imap_server.authenticate('XOAUTH2', lambda x: access_token) # Select the inbox folder imap_server.select("inbox") This example shows us an error "imaplib.error: AUTHENTICATE failed." in the line "imap_server.authenticate('XOAUTH2', lambda x: access_token)" and it seems that the data was specified correctly. So, we have some questions: * Are we doing something wrong? * Do you know what is happening with the imap library? * How can we recover the inbox messages from our email using the OAUTH2 authentication of the imap library? Thank you for the effort. Yours faithfully, Guillem Cortiada Rovira | Solutions Assistant guillem.cortiadarovira(a)nttdata.com<mailto:guillem.cortiadarovira@nttdata.com> NTT DATA NTT DATA Towers. Avda. Icària, 199, 08005 Barcelona, Spain Leer más en: es.nttdata.com [Pantalla de video juego Descripción generada automáticamente con confianza baja] ________________________________ This email and any attachments are sent in strictest confidence for the sole use of the addressee and may contain legally privileged, confidential, and proprietary data. If you are not the intended recipient, please advise the sender by replying promptly to this email and then delete and destroy this email and any attachments without any further use, copying or forwarding.

1 0