Mailman 3 November 2013 - docs

[issue19411] binascii.hexlify docs say it returns a string (it returns bytes)
by Devin Jeanpierre 03 Nov '13

03 Nov '13

New submission from Devin Jeanpierre: http://docs.python.org/3.4/library/binascii.html#binascii.hexlify ---------- assignee: docs@python components: Documentation messages: 201376 nosy: Devin Jeanpierre, docs@python priority: normal severity: normal status: open title: binascii.hexlify docs say it returns a string (it returns bytes) versions: Python 3.1, Python 3.2, Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue19411> _______________________________________

6 6

[issue19487] Correct the error of the example given in the doc of partialmethod
by iMom0 03 Nov '13

03 Nov '13

Changes by iMom0 <mobeiheart(a)gmail.com>: ---------- assignee: docs@python components: Documentation files: partialmethod-doc-fix.patch keywords: patch nosy: docs@python, imom0 priority: normal severity: normal status: open title: Correct the error of the example given in the doc of partialmethod type: enhancement versions: Python 3.4 Added file: http://bugs.python.org/file32484/partialmethod-doc-fix.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue19487> _______________________________________

1 0

[issue19485] Slightly incorrect doc for get_param method in Lib/email/message.py
by Vajrasky Kok 03 Nov '13

03 Nov '13

New submission from Vajrasky Kok: Lib/email/message.py, line 665 & 666: param = msg.get_param('foo') param = email.utils.collapse_rfc2231_value(rawparam) Where does rawparam come from? On top of that, sending the result of get_param to collapse_rfc2231_value can make it chokes if the result of get_param is None. I already proposed the change in collapse_rfc2231_value to handle None gracefully in another ticket #19063, though. ---------- assignee: docs@python components: Documentation files: fix_doc_get_param_in_email_message.patch keywords: patch messages: 202029 nosy: docs@python, vajrasky priority: normal severity: normal status: open title: Slightly incorrect doc for get_param method in Lib/email/message.py versions: Python 3.4 Added file: http://bugs.python.org/file32480/fix_doc_get_param_in_email_message.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue19485> _______________________________________

3 4

Undocumented feature - should be documented.
by bob gailer 01 Nov '13

01 Nov '13

According to the FM: "str.translate(map) Return a copy of the s where all characters have been mapped through the map which must be a dictionary of Unicode ordinals (integers) to Unicode ordinals, strings or None. Unmapped characters are left untouched. Characters mapped to None are deleted." So 'acxd'.translate(' '*97 + 'sdfg') should raise an exception, as the map is NOT a dictionary. However it runs and returns 'sfxg' This is a very nice feature - let's document it! -- Bob Gailer 919-636-4239 Chapel Hill NC

1 0

Suggestion for documentation improvement
by Johannes Ammon 01 Nov '13

01 Nov '13

Dear python developpers, I ran into the unicode problem of the csv module in the python standard library (2.7.5) and immediately found the solution in the docs. I just used the UTF8Recoder/UnicodeReader/UnicodeWriter proposed in http://docs.python.org/2/library/csv.html#examples. Thank you for that! There is just one little problem with UnicodeWriter, which imho has an easy solution: class UnicodeWriter: "..." def writerow(self, row): self.writer.writerow([s.encode("utf-8") for s in row]) "..." When "s" is not a string (i.e. when "row" contains an element, that is e.g. None or an int, which is ok for csv.writer), I get a "AttributeError: 'NoneType' object has no attribute 'encode'" So I changed this bit of code to def writerow(self, row): self.writer.writerow([unicode(s).encode("utf-8") if s is not None else "" for s in row]) "..." Ok, this is a bit complicated for an educational code sample, but I think there are more people like me, that just use the code samples from the docs. Best regards, Johannes

1 0