Mailman 3 August 2013 - docs

[issue14191] argparse doesn't allow optionals within positionals
by Glenn Linderman Aug. 16, 2013

Aug. 16, 2013

Glenn Linderman added the comment: Paul, is this ready to merge, or are you thinking of more refinements? ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue14191> _______________________________________

1 0

[issue18532] hashlib.HASH objects should officially expose the hash name
by Jason R. Coombs Aug. 15, 2013

Aug. 15, 2013

New submission from Jason R. Coombs: In hashlib, the HASH objects currently supply a 'name' attribute, reflecting the name used to initialize the hash object, and they have since Python 2.5. However, this interface is not published so isn't honored by other platforms (namely pypy). I propose the '.name' attribute be formally added to the documentation to reflect the actual implementation. I suggest this change be considered as a bugfix release if the original intention was for the '.name' attribute to be public (as it's a bug in the documentation if the intended and implemented interface isn't fully documented). I plan to do some research to ascertain the intention of this attribute (as can be inferred from tests and the source). For now, I'll assume Python 3.4 only. Any comments or suggestions welcome. ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 193563 nosy: docs@python, jason.coombs priority: normal severity: normal status: open title: hashlib.HASH objects should officially expose the hash name versions: Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18532> _______________________________________

4 9

Re: [docs] Defining new keyword (extension of default keywords) in Python 3.3.2
by georgegadvani＠hsbc.com.hk Aug. 15, 2013

Aug. 15, 2013

I did some research and found this article maybe of use, http://stackoverflow.com/questions/2315044/how-to-generate-a-module-object-… Thus, I followed the example but not successful. The screen-dumps below illustrate the problem (iii) in my last message. Can you advice what's the right syntax for exec in this case ? From: George G ADVANI/HBAP/HSBC To: docs(a)python.org Date: 08/15/2013 11:08 AM Subject: Defining new keyword (extension of default keywords) in Python 3.3.2 Hi team, Actually this is not a bug but a question. I started using Python recently on building prototype analytics. FYI, my Python version is 3.3.2 & I used IPython/WinPython in development. Basic packages are all installed, e.g. numpy version is 1.7.1 scipy version is 0.12.0 Path & PythonPath settings as below:- My question is related to this thread somebody posts on adding new keywords in Python. http://stackoverflow.com/questions/214881/can-you-add-new-statements-to-pyt… Looking at the suggestions, there are couple of ways to achieve this and I prefer this way since it sounds easiest:- However, I cannot simply use these statements owing to the following reasons:- (i) the new package is replaced by Types package; (ii) In the Types Package (checking on documentation), there is nothing like types.module( ....). How to re-write the statements ? (iii) When I execute this line exec data in mod.__dict__ I got message like syntax error highlighting the word "data" My understanding is that this support group is runned on voluntary basis. Grateful if somebody may help and revert with valid examples that can run on Python 3.3.2. Thx & Rgds, George Advani ----------------------------------------- ******************************************************************* This e-mail is confidential. It may also be legally privileged. If you are not the addressee you may not copy, forward, disclose or use any part of it. If you have received this message in error, please delete it and all copies from your system and notify the sender immediately by return e-mail. Internet communications cannot be guaranteed to be timely, secure, error or virus-free. The sender does not accept liability for any errors or omissions. ******************************************************************* "SAVE PAPER - THINK BEFORE YOU PRINT!"

1 0

Defining new keyword (extension of default keywords) in Python 3.3.2
by georgegadvani＠hsbc.com.hk Aug. 15, 2013

Aug. 15, 2013

Hi team, Actually this is not a bug but a question. I started using Python recently on building prototype analytics. FYI, my Python version is 3.3.2 & I used IPython/WinPython in development. Basic packages are all installed, e.g. numpy version is 1.7.1 scipy version is 0.12.0 Path & PythonPath settings as below:- My question is related to this thread somebody posts on adding new keywords in Python. http://stackoverflow.com/questions/214881/can-you-add-new-statements-to-pyt… Looking at the suggestions, there are couple of ways to achieve this and I prefer this way since it sounds easiest:- However, I cannot simply use these statements owing to the following reasons:- (i) the new package is replaced by Types package; (ii) In the Types Package (checking on documentation), there is nothing like types.module( ....). How to re-write the statements ? (iii) When I execute this line exec data in mod.__dict__ I got message like syntax error highlighting the word "data" My understanding is that this support group is runned on voluntary basis. Grateful if somebody may help and revert with valid examples that can run on Python 3.3.2. Thx & Rgds, George Advani ----------------------------------------- ******************************************************************* This e-mail is confidential. It may also be legally privileged. If you are not the addressee you may not copy, forward, disclose or use any part of it. If you have received this message in error, please delete it and all copies from your system and notify the sender immediately by return e-mail. Internet communications cannot be guaranteed to be timely, secure, error or virus-free. The sender does not accept liability for any errors or omissions. ******************************************************************* "SAVE PAPER - THINK BEFORE YOU PRINT!"

1 0

Minor fix, docpage
by Roy Nard Aug. 14, 2013

Aug. 14, 2013

http://docs.python.org/2/library/os.html os.walk(*top*, *topdown=True*, *onerror=None*, *followlinks=False*) ::: "Generate the file names in a directory tree by walking the tree either top-down or bottom-up. For each directory in the tree rooted at directory * top* (including *top* itself), it yields a 3-tuple (dirpath, dirnames, * filenames*). *dirpath* is a string, the path to the directory. *dirnames* is a list of the names of the subdirectories in *dirpath* (excluding '.' and '..'). * filenames* is a list of the names of the non-directory files in *dirpath*. Note that the names in the lists contain no path components. To get a full path (which begins with *top*) to a file or directory in *dirpath*, do os.path.join(dirpath, *name*)" Small revision: Variables does not match. //Roy Nard Chalmers

1 0

[issue1227748] subprocess: inheritance of std descriptors inconsistent
by STINNER Victor Aug. 13, 2013

Aug. 13, 2013

Changes by STINNER Victor <victor.stinner(a)gmail.com>: ---------- nosy: +haypo _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1227748> _______________________________________

1 0

[issue18687] Lib/test/leakers/test_ctypes.py still mentions the need to update Misc/build.sh
by Févry Thibault Aug. 13, 2013

Aug. 13, 2013

New submission from Févry Thibault: "# When this leak is fixed, remember to remove from Misc/build.sh LEAKY_TESTS." -> Misc/build.sh got removed 19 months ago, this should be updated. ---------- assignee: docs@python components: Documentation files: patch.diff keywords: patch messages: 194703 nosy: docs@python, iwontbecreative priority: normal severity: normal status: open title: Lib/test/leakers/test_ctypes.py still mentions the need to update Misc/build.sh versions: Python 3.4 Added file: http://bugs.python.org/file31200/patch.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18687> _______________________________________

3 2

[issue18724] Typo in docs.python.org: smtplib python2.7
by Susan Tan Aug. 13, 2013

Aug. 13, 2013

New submission from Susan Tan: http://docs.python.org/2.7/library/smtplib.html#smtplib.SMTPException "exception smtplib.SMTPException The base exception class for all the other excpetions provided by this module." The word "exceptions" is spelled incorrectly in the in "other excpetions". ---------- assignee: docs@python components: Documentation messages: 195049 nosy: Susan, docs@python priority: normal severity: normal status: open title: Typo in docs.python.org: smtplib python2.7 type: enhancement versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18724> _______________________________________

3 2

Template files in documentation sources
by 葉琮銘 Aug. 13, 2013

Aug. 13, 2013

Hello, I am Eric from Taiwan. I would like to translate the documentation to Chinese (not simplified) and host it on readthedocs. Of course, I use sphinx and complete the setup so that I can make html with the files downloaded from docs.python.org, but I find that the generated index.html looks not the same as the official website. After studying for a while, I know I can create other htmls with template through conf.py, and I cannot find the template used by the documentation anywhere, even in the offcial mirror or similar projects on readthedocs. Could I ask those files not provided at the download page? Thank you. Best regards, Eric

1 1

[issue18680] JSONDecoder should document that it raises a ValueError for malformed data
by Corey Farwell Aug. 12, 2013

Aug. 12, 2013

New submission from Corey Farwell: Before someone comes in and tries to correct me, I know Python documentation is different than Javadocs. It is common to test if the JSON is malformed using a try...catch. What if I want to catch something more specific than Exception? The only way a user would know what to catch is to `python -c "import json; json.loads('FAIL')"`. Many other Python modules document which exception is raised on invalid input/parameters. ---------- assignee: docs@python components: Documentation messages: 194628 nosy: corey, docs@python priority: normal severity: normal status: open title: JSONDecoder should document that it raises a ValueError for malformed data type: enhancement versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4, Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18680> _______________________________________

5 6