Mailman 3 October 2010 - docs

proposal to improve documentation for parameterized SQLite .execute method
by Stephen Holland M.D. Oct. 26, 2010

Oct. 26, 2010

Hello! I appreciate all the work that has gone into the python system. I was using the sqlite3 package and found a documentation issue that has to have caused problems for other users and I would like to help improve the documentation. From web page http://docs.python.org/library/sqlite3.html in the initial section regarding the description of parameter substitution and in the section on execute examples are given for using this technique. As a responsible sql writer, I knew that strings that contain spaces need to be quoted in as SQL insert statement. The examples did not contain any space containing strings, so when I tried to use the technique I put quotes around the ? in the .execute method call, as I was using data that had spaces and other punctuation within it. This causes an error. The cursor method automatically quotes the strings, and actually errors out if the ? is quoted. I propose that the examples contain some insertions that include spaces, and additional documentation to describe what other safety steps are done in parameter substitution to the arguments. Steve Holland

1 0

[issue6269] threading documentation makes no mention of the GIL
by Ray.Allen Oct. 26, 2010

Oct. 26, 2010

Ray.Allen <ysj.ray(a)gmail.com> added the comment: Agree with Jesse, the description in the patch is not quite correct. I think detailed description of the GIL has been given in C API documentation: http://docs.python.org/c-api/init.html#thread-state-and-the-global-interpre…. How about just give this link in threading module documentation? ---------- nosy: +ysj.ray _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue6269> _______________________________________

1 0

[issue6269] threading documentation makes no mention of the GIL
by Antoine Pitrou Oct. 25, 2010

Oct. 25, 2010

Changes by Antoine Pitrou <pitrou(a)free.fr>: ---------- assignee: nobody -> docs@python nosy: +docs@python versions: +Python 3.1, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue6269> _______________________________________

1 0

Super function example error?
by Joaquin Duo Oct. 25, 2010

Oct. 25, 2010

Hi! My name is Joaquín Duo I am a free software enthusiast. While I was reading about the super() Buit-in function on: http://docs.python.org/library/functions.html#super i found example of the function raises an error on python 2.7. The example is: class C(B): def method(self, arg): super(C, self).method(arg) In fact I runned it like: class B: def method(self, arg): pass class C(B): def method(self, arg): super(C, self).method(arg) c = C() c.method(10) Raises: Funcion_Super.py", line 8, in method super(C, self).method(arg) TypeError: must be type, not classobj I guess the correction would be class C(B): def method(self, arg): super(type(self), self).method(arg) Cheers! Joaquín

1 0

[issue10190] Can argparse._AttributeHolder._get_kwargs become a public API?
by Dariusz Suchojad Oct. 25, 2010

Oct. 25, 2010

New submission from Dariusz Suchojad <dsuch(a)gefira.pl>: Hello, I was wondering if it were possible for the argparse._AttributeHolder._get_kwargs to become a part of the public API. Using this method is a very convenient way to get a hold of the arguments provided by the user and it would be shame to keep it private, I for one use it in several places even though I clearly know the name starts with an underscore, it's just that reimplementing it in my code seems counter-productive, would be very nice if '_get_kwargs' became 'get_kwargs' in some future release. Thanks for considering it! ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 119539 nosy: bethard, docs@python, dsuch priority: normal severity: normal status: open title: Can argparse._AttributeHolder._get_kwargs become a public API? type: feature request _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10190> _______________________________________

2 2

[issue10178] PEP 378 uses replace where translate may work better
by samwyse Oct. 23, 2010

Oct. 23, 2010

New submission from samwyse <samwyse(a)gmail.com>: PEP 378 states; format(n, "6,f").replace(",", "X").replace(".", ",").replace("X", ".") This is complex and relatively slow. A better technique, which IMHO the proposal should high-lighted, would be: swap_commas_and_periods = bytes.maketrans(b',.', b'.,') format(n, "6,f").translate(swap_commas_and_periods) While performing the maketrans each time a string is formatted is slower than the triple replace, calling it once and caching the result is faster. I have tested with with the 3.1 interpreter; example timings follow. >>> Timer(""" '1,234,567.89'.replace(',', 'X').replace('.', ',').replace('X', '.') """).timeit() 3.0645400462908015 >>> Timer(""" '1,234,567.89'.translate(swap_commas_and_periods) """, """ swap_commas_and_periods = bytes.maketrans(b',.', b'.,') """).timeit() 2.276630409730846 >>> Timer(""" '1,234,567.89'.translate(bytes.maketrans(b',.', b'.,')) """).timeit() 3.760715677551161 ---------- assignee: docs@python components: Documentation messages: 119427 nosy: docs@python, samwyse priority: normal severity: normal status: open title: PEP 378 uses replace where translate may work better type: behavior versions: Python 2.7, Python 3.1 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10178> _______________________________________

3 3

A trivial 2.7 documentation bug
by ben med Oct. 23, 2010

Oct. 23, 2010

Hello, I noticed a smaal documentation bug in python 2.7 documentation at 7.1. Fancier Output Formatting¶ <http://docs.python.org/tutorial/inputoutput.html#fancier-output-formatting> in the first example : >>> # The repr() of a string adds string quotes and backslashes: ...hello = 'hello, world\n' >>> hellos = repr(hello) >>> print hellos 'hello, world\n' So the last line I quoted here must be "'hello, world\\n'" as explained in the first line . have a good day Mohamed BEN MOHAMED

2 1

Installation-bug
by tamik Oct. 23, 2010

Oct. 23, 2010

Hi I am starting to learn programming with Python but the installation doesn´t go the way it should. First I tried D:\PYTHON-installation. It didn+t work. Oh - it MUST be C then? C:\wxPython ... no C:\PYTHON ... NO C:\PYTHON27\ ... no-no-no... C:\Put a directory on PYTHONPATH here\ ... NO-NO-NO! (Of course I tried first the .py-package before choosing the exe-installation package.) and I have installed the program also into directory C:\Put a directory on PYTHONPATH here\ -named directory. Always the same problem - cannot find python.exe at the end of the installation. I put even SET PYTHONPATH=C:\PYTHON27 and SET wxPython=C:\PYTHON27 into autoexec.bat - but nothing works. It looks like that my only experience of Python will be a small box. The box appears at the end of setup. Why does the box ask that? I do not have that directory (C:\Put a directory on PYTHONPATH here\) (and if I had it, there were no python.exe anyhow). I have C:\PYTHON27-directory chosen by a) writing it (doesn´t work) b) chosen by clicking the directory name (the same result always) I have W95->W98 with that older computer where I tried to install the wxPython. 2) The newer W XP is that much full of stuff that I chose the older computer. 3) I have Vista64, too, but I use it at my office. First the older computer - there is room enough, now. My ONLY wxPython-experience after many hours still is the same (I think to finish with this language wxPython if nothing else is to be experienced?) - and it is this: A small box (setup) appears with text: Unable to execute file: C:\Put a directory on PYTHONPATH here\python.exe Create process failed: code 2 Ok, if You can help me, I would be interested to know more about this language than that. Thanks for help (WHERE is python.exe after installation????) (WHY the program always asks about the directory C:\Put a directory on PYTHONPATH here\ which doesn´t exist, because there is another directory-name. No such directory and no python.exe there, not even in the new other-named directory ? I tried to look python.exe but as yet I have not found it, I´ll continue with that...) I only know how to operate with very-very-old GWBASIC program, that has been the only language for 25 years for me. Now I think, I´ll like to learn Python,JAVA,Jython? - etc... Perhaps I am too old (56y), too? :) I thought to start with Python, but... (problems and tired and frustrated, see above) Help please. Thanks a lot for help! yours sincerely tamik

1 0

[issue10175] vs version for win32 compilation of extension modules is undocumented.
by Jeremy Kloth Oct. 23, 2010

Oct. 23, 2010

Jeremy Kloth <jeremy.kloth(a)gmail.com> added the comment: A quick look with Dependency Walker gives me the following: Python 2.4,2.5 -- MSVC .NET 2003 (7.1) Python 2.6,2.7,3.0,3.1 -- MSVC 2008 (9.0) Note these are only for the official python.org builds. Each version can also be built using other MSVC versions. To the best of my knowledge Python 3.2 will also be built using MSVC 2008 as 2010 support hasn't been discussed yet. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10175> _______________________________________

1 0

[issue10175] vs version for win32 compilation of extension modules is undocumented.
by R. David Murray Oct. 23, 2010

Oct. 23, 2010

R. David Murray <rdmurray(a)bitdance.com> added the comment: If I understand correctly (I'm not a windows user or developer myself), knowing the bits necessary to compile extension modules is not something very many people need to know. If an extension module supports Windows, there will generally be an installer package containing the binaries available. If there isn't, chances are the extension module doesn't support Windows. That said, improvements in the documentation is rarely a bad idea ;) ---------- assignee: -> docs@python components: +Documentation -Extension Modules nosy: +docs@python, r.david.murray type: compile error -> feature request versions: +Python 2.7, Python 3.1, Python 3.2 -Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10175> _______________________________________

1 0