Mailman 3 July 2021 - 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

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

咨询python的相关问题(Consult python related issues)
by C July 28, 2021

July 28, 2021

您好，我想咨询阅读python语言参考手册时遇到的相关问题，我在这个网址https://docs.python.org/zh-cn/3/bugs.html 看到该邮箱地址，不知道是否可以用来咨询此类问题？或请推荐咨询的渠道。《python语言参考手册》--数据模型章节--静态方法对象： “避免函数对象转换为方法对象”是指在实例对象在获取属性时，避免类中定义的方法（即：函数对象）转换为实例方法么？为什么在python中，会设置这种在类中将用户定义的函数封装起来从而防止其转换为实例方法，这种封装一般应用在哪些情况下呢？ Hello, I would like to consult related issues encountered when reading the python language reference manual, I am at this URL https://docs.python.org/zh-cn/3/bugs.html Seeing the email address, I wonder if it can be used to consult such questions? Or please recommend a channel for consultation. "Python Language Reference Manual"-Data Model Chapter-Static Method Object: "Avoid converting function objects into method objects" refers to avoiding the methods defined in the class (ie: function objects) from being converted into instance methods when the instance object gets properties? Why is it set up in python to encapsulate user-defined functions in a class to prevent them from being converted into instance methods? In what situations is this encapsulation generally used?

1 0

download links are dead
by Kanazawa Shinichi July 11, 2021

July 11, 2021

Hello This download links are dead. Please fix them. https://docs.python.org/ja/3/download.html https://docs.python.org/ja/3/archives/python-3.9.4-docs-pdf-letter.zip https://docs.python.org/ja/3/archives/python-3.9.4-docs-pdf-a4.zip https://docs.python.org/ja/3/archives/python-3.9.4-docs.epub thank you

1 0

possible bug in tutorial section 6.4
by andreas_qiu July 9, 2021

July 9, 2021

In section 6.4 of the tutorial: Yet another variation is to import the desired function or variable directly: fromsound.effects.echoimportechofilter Again, this loads the submodule echo, but this makes its function echofilter() directly available I think the last sentence of the describtion should be: Again, this doesn't load the submodule echo, but this makes its function echofilter() directly available Thanks and Best Regards, Andy.

1 0

Logging Cookbook...
by Barry Smith July 8, 2021

July 8, 2021

I was going through the "Logging Cookbook" article, following perfectly... until the section entitled "Dealing with handlers that block" attributed to writer Vinay Sajip <vinay_sajip at red-dove dot com>. I skimmed his discussion and figured that I could look at the code to figure out which imports that he did not include in the code because everything was making perfect sense. Apparently one of the imports required was the code snippet for a module recently above... yet there is no link in the doc to take me to a simple article explaining how to take a module code and create a import module in the article. Thus, the Logging Cookbook became immediately IRRELEVANT in being a reference article without having experience or knowledge in creating Python modules. Yes, I am working on a complex project for myself. and am ramping up as quickly as I can, yet with a total of about 3 years managing python scripts similar to DOS BAT files, I have no experience creating importable modules in Python. Doing this complex project, I plan on designing MANY custom personal import modules for myself, yet that has not become a required skill yet. **Thus** to make the "Logging Cookbook** more useful, there should probably be a link to a quick appendix article by Vijay describing how to create an importable module from his long description about "Dealing with handlers that block"... or after he presented the code for the module. I still have a lot of the article to read and was REALLY enjoying the coding knowledge that I was getting about the topic of logging... yet at this point in the article, there is a MAJOR requirement in knowledge which could be a simple appendix to the article, omitted from the learning process. Thank you for addressing this issue. I came to this Python document "Logging Cookbook" from IDLE reading Python documentation, and doing a search for "logging". I am not really sure if I am reading an online article or a downloaded file with online links in the footer of the "help" subsystem. Yet,, I am very disappointed that Vijay's awesome article has a stopping point where I cannot use the information presented because I do not possess the knowledge and am not directed to a place to get the knowledge. Thank you for your attention to this problem that only needs a short appendix or attachment at the bottom of the article... or a link to "Creating local/private Modules Cookbook. ;) -- -- Barry Smith c *in process* c *unavailable* -> 864-999-9076 e bnsmith002(a)gmail.com w1 https://bit.ly/3drRKmL w2 http://bit.ly/l8QJup

1 0