Mailman 3 July 2011 - docs

[issue12577] Misleading shutil.move docs regarding when os.rename is used
by Catalin Iacob July 19, 2011

July 19, 2011

New submission from Catalin Iacob <iacobcatalin(a)gmail.com>: I recently tried to answer the question: "When moving a file to a destination that is an already existing file, is the destination overwritten?" >From the current docs I understood that if src and dst are on the same filesystem then os.rename is used, if they are on different filesystems then copy + remove is used instead. Since os.rename fails on Windows if the destination exists I concluded that shutil.move would fail on Windows and overwrite dst on Unix. ---------- assignee: docs@python components: Documentation messages: 140520 nosy: catalin.iacob, docs@python priority: normal severity: normal status: open title: Misleading shutil.move docs regarding when os.rename is used versions: Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12577> _______________________________________

3 4

[issue12479] Add HTTPErrorProcessor class definition
by Sandro Tosi July 19, 2011

July 19, 2011

New submission from Sandro Tosi <sandro.tosi(a)gmail.com>: As reported in http://mail.python.org/pipermail/docs/2011-June/004879.html urllibs/urllib.request misses the definition of HTTPErrorProcessor class; the attached patches add it to the documentation. ---------- assignee: docs@python components: Documentation files: HTTPErrorProcessor_class-default.patch keywords: patch messages: 139687 nosy: docs@python, sandro.tosi priority: normal severity: normal stage: patch review status: open title: Add HTTPErrorProcessor class definition versions: Python 2.7, Python 3.2, Python 3.3 Added file: http://bugs.python.org/file22552/HTTPErrorProcessor_class-default.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12479> _______________________________________

4 5

[issue1626300] 'Installing Python Modules' does not work for Windows
by Chris Lambacher July 18, 2011

July 18, 2011

Chris Lambacher <chris(a)kateandchris.net> added the comment: > I am not sure of the difference between 'local script' and 'global command' local script is the setup.py (or for that matter any other script in an arbitrary place in the filesystem. Global command is referring to something installed in %PYTHONINSTALLDIR%\scripts i.e. it is an installed command. This one operates on a specific version instance of python. I for instance have c:\python26\scripts\easy_install.exe and c:\python27\script\easy_install.exe and each of those operates on their own particular version. Neither are in my path. The current state is that I have to either put one of the scripts directories in my path or run easy_install with the full path. My understanding is that pysetup is a replacement for easy_install that will come with 3.3. > I am not sure what 'or does the installer add .py?' could mean. The Windows installer? 'Add' to what? I was referring .py being added to the PATHEXT evironment variable. I think it is safe to say that has not happened and is likely a bad idea. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1626300> _______________________________________

1 0

[issue1626300] 'Installing Python Modules' does not work for Windows
by Chris Lambacher July 18, 2011

July 18, 2011

Chris Lambacher <chris(a)kateandchris.net> added the comment: > Now my concern is about packaging: In a typical Windows install, can people run “pysetup3 spam”? The windows installer does not make any additions to the path so it is unlikely that "pysetup3 spam" will work. There is http://www.python.org/dev/peps/pep-0397/ which addresses running scripts in a multi-version windows environment but I don't think that will help in this case. If you are running more than 1 version of windows there is simple statement that tells you how to install and have the install go to the right interpreter. You are almost best to have a shortcut that gives you a command prompt with the PATH variable correctly set to the desired python instance. That does not help the 2.x crowd or anyone before 3.3 :/ ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1626300> _______________________________________

1 0

[issue1626300] 'Installing Python Modules' does not work for Windows
by Terry J. Reedy July 18, 2011

July 18, 2011

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: I went back and reread from the beginning, instead of merely answering the question you asked when adding me as nosy. More comments: Windows file associations are so disfunctional that you should not depend on them being anything in particular. I nearly always open files from within applications (IDLE for python files) or with RightClick context menu when an entry specifies the app that will be used (as with 'Edit with Notepad++' (getting Python make such is another issue). The only way I can run from Command Prompt is to cd to the appropriate pythonxy directory and enter 'python full\path\to\file' (with stupid backslashes or 'python -m module' (which looks for module under /Lib). In XP, and I presume later, the term 'DOS box' is obsolete and I would delete it. The 'Command Prompt' app (with caps) is found in the Start/Accessories directory. So I would say "open a Command Prompt window (in Start/Accessories)" Back to your message where you added me. I am not sure of the difference between 'local script' and 'global command'. I do not understand your proposed note, especially "*include link to relevant section of docs.python.org/using*.". Script run without extensions when run with an explicit python command. I was primed to answer this because someone recently, on the tracker or python-list, proposed to 'fix' a problem (wrongly) by adding a .py(o/w) extension check to determine if a file is Python code before running it. I am not sure what 'or does the installer add .py?' could mean. The Windows installer? 'Add' to what? I realize that my answers may appear naive. I hope usefully so. I have used Windows since Win95 and have learned to focus, as described above, on what dependably works with minimal surprise. The extremely few 3rd party Python-based stuff I have installed has either come as a zipped library I could extract into site-packeges or as an independent app to be unzipped elsewhere or installed with a Windows-style installer. I have never used setup.py so no expert advice on its successor from me. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1626300> _______________________________________

1 0

[issue1626300] 'Installing Python Modules' does not work for Windows
by Éric Araujo July 18, 2011

July 18, 2011

Éric Araujo <merwok(a)netwok.org> added the comment: The original bug is that the distutils docs use commands like “python setup.py spam” all over the place, and they don’t typically work > because the python executable is not in the path in the default > install. 'setup.py install' will work since .py files are associated > with python.exe (quoted from the first message). I added a note to instruct Windows users to mentally replace those commands with “setup.py spam”. Now my concern is about packaging: In a typical Windows install, can people run “pysetup3 spam”? ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1626300> _______________________________________

1 0

[issue1626300] 'Installing Python Modules' does not work for Windows
by Terry J. Reedy July 18, 2011

July 18, 2011

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: I perhaps misunderstood your question. I ran files from the command line as as 'python whatever', not 'whatever' so only python would care about an extension. I do not have a file association to 'run' a file, with or without .py. I presume IDLE does same when one RUNs a file, except with pythonw. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1626300> _______________________________________

1 0

[issue1626300] 'Installing Python Modules' does not work for Windows
by Chris Lambacher July 18, 2011

July 18, 2011

Chris Lambacher <chris(a)kateandchris.net> added the comment: I don't think that is the default state. You need to add .py to the PATHEXT environment variable: http://effbot.org/pyfaq/how-do-i-make-python-scripts-executable.htm Maybe Terry did this at some point? My windows box certainly does not have it and I have 2.6 and 2.7 installed. I don't have a 3.x install so I can't check if that is new in 3. ---------- nosy: +lambacck _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1626300> _______________________________________

1 0

[issue1626300] 'Installing Python Modules' does not work for Windows
by Éric Araujo July 18, 2011

July 18, 2011

Éric Araujo <merwok(a)netwok.org> added the comment: > On Windows, scripts run with whatever name -- no extension or other > extensions. Thanks, this means that the docs can continue to say just “pysetup3”, without “.py”. (I wonder how Windows manages to run the script without file extension!) > I have tested this from both IDLE and command line. You can run command-line scripts from IDLE? Can you also comment on my proposed note about adding Scripts to PATH? ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1626300> _______________________________________

1 0

[issue12478] Possible error in HTTPErrorProcessor documentation
by Sandro Tosi July 18, 2011

July 18, 2011

New submission from Sandro Tosi <sandro.tosi(a)gmail.com>: Hello, I think HTTPErrorProcessor documentation at [1] contains a cut&paste error (from UnknownHandler) for the only method available [1] http://docs.python.org/py3k/library/urllib.request.html#httperrorprocessor-… because: ./python -c "import urllib.request as ur; print ('unknown_open' in dir(ur.HTTPErrorProcessor))" False If you can confirm that http_response() should be used instead, I'll provide a patch to fix it. ---------- assignee: docs@python components: Documentation messages: 139685 nosy: docs@python, sandro.tosi priority: normal severity: normal stage: needs patch status: open title: Possible error in HTTPErrorProcessor documentation versions: Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12478> _______________________________________

2 1