Mailman 3 February 2016 - docs

[issue26294] Queue().unfinished_tasks not in docs - deliberate?
by Frank Millman Feb. 7, 2016

Feb. 7, 2016

New submission from Frank Millman: dir(queue.Queue()) shows an attribute 'unfinished_tasks'. It appears to be the counter referred to in the docs to 'join()', but it is not documented itself. I would like to make use of it, but I don't know if it is part of the official API for this module. Please advise. ---------- assignee: docs@python components: Documentation messages: 259645 nosy: docs@python, frankmillman priority: normal severity: normal status: open title: Queue().unfinished_tasks not in docs - deliberate? versions: Python 3.4, Python 3.5, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26294> _______________________________________

2 2

[issue26209] TypeError in smtpd module with string arguments
by Lorenzo Ancora Feb. 7, 2016

Feb. 7, 2016

Lorenzo Ancora added the comment: (msg259748) ok, then I propose to correct https://docs.python.org/dev/library/smtpd.html?highlight=q#smtpd.SMTPServer from: .. class:: SMTPServer(localaddr, remoteaddr, data_size_limit=33554432,\ map=None, enable_SMTPUTF8=False, decode_data=True) Create a new :class:`SMTPServer` object, which binds to local address *localaddr*. It will treat *remoteaddr* as an upstream SMTP relayer. It inherits from :class:`asyncore.dispatcher`, and so will insert itself into :mod:`asyncore`'s event loop on instantiation. To: .. class:: SMTPServer(localaddr, remoteaddr, data_size_limit=33554432,\ map=None, enable_SMTPUTF8=False, decode_data=True) Creates a new :class:`SMTPServer` object, which binds to local address *localaddr* and uses *remoteaddr* as an upstream SMTP relayer. Both parameters should be a tuple in the form ``("host", portnumber)``, where *host* is a valid IP/FQDN. The object will insert itself into :mod:`asyncore`'s event loop on instantiation (inherits from :class:`asyncore.dispatcher`) and can be started with a call to :class:`asyncore.loop`. --- These clarifications should be also inserted in the source code as heredocs (without the Sphynx syntax). I really think that those changes will make the use of smtpd easier. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26209> _______________________________________

1 0

[issue26250] no document for sqlite3.Cursor.connection
by Aviv Palivoda Feb. 6, 2016

Feb. 6, 2016

Aviv Palivoda added the comment: Added patch with my suggestion for sqlite3.Cursor.connection attribute documentation ---------- assignee: -> docs@python components: +Documentation, Extension Modules -Library (Lib) keywords: +patch nosy: +docs@python, ghaering, palaviv versions: +Python 3.5, Python 3.6 Added file: http://bugs.python.org/file41838/sqlite3-cursor-connection-doc.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26250> _______________________________________

1 0

[issue26209] TypeError in smtpd module with string arguments
by Terry J. Reedy Feb. 6, 2016

Feb. 6, 2016

Terry J. Reedy added the comment: Note that the proposed code change would be a 3.6 only enhancement. Adding the other versions was part of changing to a doc-only issue. Note also that if the module is not deprecated, then a 3.6 code change could be considered. But only a doc change for now. ---------- dependencies: +Deprecate smtpd (based on deprecated asyncore/asynchat): write a new smtp server with asyncio _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26209> _______________________________________

1 0

[issue26209] TypeError in smtpd module with string arguments
by Terry J. Reedy Feb. 6, 2016

Feb. 6, 2016

Terry J. Reedy added the comment: Code patches should not be assigned to 'docs'. But Berker, for the reason stated, thinks this should be doc only. Giampaolo is not currently active, so should not be assigned the issue by anyone else. After making a patch -- see the devguide -- use the File: Browse button to upload a file. You can suggest a specific doc change in a message, without a .patch or .diff file. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26209> _______________________________________

1 0

[issue26209] TypeError in smtpd module with string arguments
by Lorenzo Ancora Feb. 6, 2016

Feb. 6, 2016

Lorenzo Ancora added the comment: (msg259475) Terry J. Reedy thank you for the correction, I've confused the versions affected with the versions actually supported. Since this doesn't only affect the documentation, is it correct to assign the issue to docs@python? The expert index indicates giampaolo.rodola as the module maintainer, so he should be moved from the nosy list to the field "Assigned To" and docs@python should be in the nosy list. Also, there is a documentation on how to send a patch for a specific module in Python 3.5? I'd like to help by creating a new source code patch. :-) ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26209> _______________________________________

1 0

Documentation error
by Simon Smith Feb. 6, 2016

Feb. 6, 2016

Very minor error but I believe: The authority, if present, must NOT contain the “userinfo” component - for example “joe@password:example.com” is not correct. Should read: The authority, if present, must NOT contain the “userinfo” component - for example “*joe:password@*example.com” is not correct. Located on page: https://docs.python.org/3.5/howto/urllib2.html Regards

2 1

Need your instruction for choosing GUI framework
by Ashraf gardizy Feb. 4, 2016

Feb. 4, 2016

To whom may concern, Hi Dear; I have recently started development of applications using Python and its awesome and interesting but I don't know which framework should I use for developing GUI application using Python.kindly instruct me. Thanks Ashraf Gardizy Kabul Afghanistan

1 0

update link - alternative implementation Python for .Net
by AKHIYAROV, Denis (WGK) Feb. 4, 2016

Feb. 4, 2016

Python for .Net is now hosted at http://pythonnet.github.io/ Update the links on these pages: https://docs.python.org/3/reference/introduction.html https://docs.python.org/2/reference/introduction.html Thanks, Denis Please consider the environment before printing this email. This email and its attachments may contain information which is confidential and/or legally privileged. If you are not the intended recipient of this e-mail please notify the sender immediately by e-mail and delete this e-mail and its attachments from your computer and IT systems. You must not copy, re-transmit, use or disclose (other than to the sender) the existence or contents of this e-mail or its attachments or permit anyone else to do so.

2 1

doc bug report
by שחר י Feb. 3, 2016

Feb. 3, 2016

Hello, In the client-side code here: https://docs.python.org/2/library/socketserver.html#socketserver-tcpserver-… the line: received = sock.recv(1024) is a bad programming example. This is not the proper way to receive data using a socket. You must receive in a loop until a whole message is received or the socket is closed (getting empty data). The least you can do is say that this is only for the demo to work in most cases. I.e., when the machine network card is not too busy. To clarify, say the network card was busy and only managed to read 5 bytes in the single recv() call you have. The client-output in this case would be "PYTHON" and not "PYTHON IS NICE". Regards, Shahar

1 0