Mailman 3 June 2015 - docs

[issue20836] Pickle Nonetype
by Hans Polak Nov. 28, 2015

Nov. 28, 2015

New submission from Hans Polak: This simple code works, but I have two 'import pickle' lines. The none working code has one 'import pickle' outside the class definition. This raises a Nonetype error in the pickle module, in the __del__ method. I'd like to know why and I think it's a bug, or is it? class Login(): users = {} def __init__(self): try: with open('user.data','rb') as f: import pickle self.users = pickle.load(f) # … [View More]

3 2

[issue10942] xml.etree.ElementTree.tostring returns type bytes, expected type str
by J_Tom_Moon_79 Nov. 26, 2015

Nov. 26, 2015

New submission from J_Tom_Moon_79 <jtm.moon.forum.user+python(a)gmail.com>: method xml.etree.ElementTree.tostring from module returns type bytes. The documentation reads """Returns an encoded string containing the XML data.""" (from http://docs.python.org/py3k/library/xml.etree.elementtree.html#xml.etree.El… as of 2011-01-18) ======================================================= Here is a test program: ------------------------------------------------------- #!/usr/bin/python # created … [View More]

4 5

[issue13275] Recommend xml.etree for XML processing
by Alexey Shamrin Nov. 26, 2015

Nov. 26, 2015

New submission from Alexey Shamrin <shamrin(a)gmail.com>: There are many libraries in Python stdlib [1] xml.dom xml.dom.minidom xml.dom.pulldom xml.sax xml.etree Tutorial mentions xml.dom and xml.sax. [2] In my experience xml.etree is the best library to quickly load some xml and mess with it. It would be nice to recommend people xml.etree in the tutorial [2] and in the beginning of section 19, "Structured Markup Processing Tools". [1] [1]: http://docs.python.org/library/markup.html … [View More]

8 11

[issue21228] Missing enumeration of HTTPResponse Objects methods of urllib.request.urlopen's http.client.HTTPResponse?
by Evens Fortuné Nov. 26, 2015

Nov. 26, 2015

New submission from Evens Fortuné: In the Python Library documentation, in section "21.6. urllib.request — Extensible library for opening URLs", in the description of the urllib.request.urlopen() function it is writen: --------- […] For http and https urls, this function returns a http.client.HTTPResponse object which has the following HTTPResponse Objects methods. For ftp, file, and data urls and requests explicity handled by legacy […] --------- The first sentence seemed to imply that … [View More]

6 23

[issue22989] HTTPResponse.msg not as documented
by Paul Hartmann Nov. 26, 2015

Nov. 26, 2015

New submission from Paul Hartmann: HTTPResponse.msg is documented as a http.client.HTTPMessage object containing the headers of the response [1]. But in fact this is a string containing the status code: >>> import urllib.request >>> req=urllib.request.urlopen('http://heise.de') >>> content = req.read() >>> type(req.msg) <class 'str'> >>> req.msg 'OK' This value is apparently overriden in urllib/request.py: ./urllib/request.py:1246: #… [View More]

4 5

[issue24172] Errors in resource.getpagesize module documentation
by Mahmoud Hashemi Nov. 17, 2015

Nov. 17, 2015

New submission from Mahmoud Hashemi: The resource module's description of resource.getpagesize is woefully misguiding. Reproduced in full for convenience: resource.getpagesize() Returns the number of bytes in a system page. (This need not be the same as the hardware page size.) This function is useful for determining the number of bytes of memory a process is using. The third element of the tuple returned by getrusage() describes memory usage in pages; multiplying by page size produces … [View More]

4 4

[issue12300] Document pydoc.help
by Éric Araujo Nov. 3, 2015

Nov. 3, 2015

New submission from Éric Araujo <merwok(a)netwok.org>: The only public function in pydoc is help, and it’s not listed in the module docs. The existing doc in library/functions could be moved to library/pydoc. See also #12299. ---------- assignee: docs@python components: Documentation messages: 138002 nosy: docs@python, eric.araujo priority: normal severity: normal status: open title: Document pydoc.help versions: Python 2.7, Python 3.2, Python 3.3 … [View More]

3 4

[issue23391] Documentation of EnvironmentError (OSError) arguments disappeared
by Martin Panter Oct. 27, 2015

Oct. 27, 2015

New submission from Martin Panter: Seems to have been removed in revision 097f4fda61a4, for PEP 3151. The older EnvironmentError documentation talks about creating the exception with two and three constructor arguments, however I don’t see this in the new documentation. Is this usage meant to be deprecated, or still allowed? Either way, I think the documentation should mention it. ---------- assignee: docs@python components: Documentation messages: 235372 nosy: docs@python, vadmium priority: … [View More]

3 15

[issue16785] Document the fact that constructing OSError with erron returns subclass if possible
by Andrew Svetlov Oct. 27, 2015

Oct. 27, 2015

New submission from Andrew Svetlov: I mean adding examples for constructions like this: >>> OSError(errno.ENOENT, 'error msg') FileNotFoundError(2, 'error msg') ---------- assignee: docs@python components: Documentation keywords: easy messages: 178204 nosy: asvetlov, docs@python priority: normal severity: normal status: open title: Document the fact that constructing OSError with erron returns subclass if possible versions: Python 3.3, Python 3.4 … [View More]

3 3