Mailman 3 August 2005 - Python-checkins

python/dist/src/Misc NEWS, 1.1193.2.90, 1.1193.2.91
by bcannon＠users.sourceforge.net 27 Aug '05

27 Aug '05

Update of /cvsroot/python/python/dist/src/Misc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv5059/Misc Modified Files: Tag: release24-maint NEWS Log Message: Fix bug where __contains__ should have been used over str.find() Index: NEWS =================================================================== RCS file: /cvsroot/python/python/dist/src/Misc/NEWS,v retrieving revision 1.1193.2.90 retrieving revision 1.1193.2.91 diff -u -d -r1.1193.2.90 -r1.1193.2.91 --- NEWS 27 Aug 2005 10:08:21 -0000 1.1193.2.90 +++ NEWS 27 Aug 2005 19:29:21 -0000 1.1193.2.91 @@ -79,6 +79,9 @@ Library ------- +- Fix a misuse of str.find() in detection of use of %U or %W in datetime + format. + - Bug #1167128: Fix size of a symlink in a tarfile to be 0. - Patch #810023: Fix off-by-one bug in urllib.urlretrieve reporthook

1 0

python/dist/src/Lib _strptime.py,1.38,1.38.2.1
by bcannon＠users.sourceforge.net 27 Aug '05

27 Aug '05

Update of /cvsroot/python/python/dist/src/Lib In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv5059/Lib Modified Files: Tag: release24-maint _strptime.py Log Message: Fix bug where __contains__ should have been used over str.find() Index: _strptime.py =================================================================== RCS file: /cvsroot/python/python/dist/src/Lib/_strptime.py,v retrieving revision 1.38 retrieving revision 1.38.2.1 diff -u -d -r1.38 -r1.38.2.1 --- _strptime.py 28 Oct 2004 04:49:19 -0000 1.38 +++ _strptime.py 27 Aug 2005 19:29:21 -0000 1.38.2.1 @@ -148,7 +148,7 @@ if old: current_format = current_format.replace(old, new) time_tuple = time.struct_time((1999,1,3,1,1,1,6,3,0)) - if time.strftime(directive, time_tuple).find('00'): + if '00' in time.strftime(directive, time_tuple): U_W = '%U' else: U_W = '%W'

1 0

python/dist/src/Lib _strptime.py,1.38,1.39
by bcannon＠users.sourceforge.net 27 Aug '05

27 Aug '05

Update of /cvsroot/python/python/dist/src/Lib In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv4749/Lib Modified Files: _strptime.py Log Message: fix bug where str.find() was being misused where __contains__ should have been used. Index: _strptime.py =================================================================== RCS file: /cvsroot/python/python/dist/src/Lib/_strptime.py,v retrieving revision 1.38 retrieving revision 1.39 diff -u -d -r1.38 -r1.39 --- _strptime.py 28 Oct 2004 04:49:19 -0000 1.38 +++ _strptime.py 27 Aug 2005 19:25:59 -0000 1.39 @@ -148,7 +148,7 @@ if old: current_format = current_format.replace(old, new) time_tuple = time.struct_time((1999,1,3,1,1,1,6,3,0)) - if time.strftime(directive, time_tuple).find('00'): + if '00' in time.strftime(directive, time_tuple): U_W = '%U' else: U_W = '%W'

1 0

python/dist/src/Doc/whatsnew whatsnew25.tex, 1.18, 1.19
by akuchling＠users.sourceforge.net 27 Aug '05

27 Aug '05

Update of /cvsroot/python/python/dist/src/Doc/whatsnew In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv29055 Modified Files: whatsnew25.tex Log Message: Write section on PEP 342 Index: whatsnew25.tex =================================================================== RCS file: /cvsroot/python/python/dist/src/Doc/whatsnew/whatsnew25.tex,v retrieving revision 1.18 retrieving revision 1.19 diff -u -d -r1.18 -r1.19 --- whatsnew25.tex 23 Aug 2005 00:56:06 -0000 1.18 +++ whatsnew25.tex 27 Aug 2005 18:45:47 -0000 1.19 @@ -117,12 +117,10 @@ As introduced in Python 2.3, generators only produce output; once a generator's code was invoked to create an iterator, there's no way to pass new parameters into the function when its execution is resumed. -(Well, you could make the generator's code look at a global -variable and modify the global value, but this is an unreliable hack -that doesn't work if you have multiple instances of the same generator -alive at the same time.) - -Python 2.5 adds the ability to pass values \emph{into} a generator. +Hackish solutions to this include making the generator's code look at +a global variable and then changing the global variable's value, or +passing in some mutable object that callers then modify. Python +2.5 adds the ability to pass values \emph{into} a generator. To refresh your memory of basic generators, here's a simple example: @@ -134,16 +132,120 @@ i += 1 \end{verbatim} -On executing the \ -When you call \code{counter(10)}, the result is an +When you call \code{counter(10)}, the result is an iterator that +returns the values from 0 up to 9. On encountering the +\keyword{yield} statement, the iterator returns the provided value and +suspends the function's execution, preserving the local variables. +Execution resumes on the following call to the iterator's +\method{next()} method, picking up after the \keyword{yield}. -XXX write this section +In Python 2.3, \keyword{yield} was a statement; it didn't return any +value. In 2.5, \keyword{yield} is now an expression, returning a +value that can be assigned to a variable or otherwise operated on: + +\begin{verbatim} +val = (yield i) +\end{verbatim} + +I recommend that you always put parentheses around a \keyword{yield} +expression when you're doing something with the returned value, as in +the above example. The parentheses aren't always necessary, but it's +easier to always add them instead of having to remember when they're +needed. The exact rules are that a \keyword{yield}-expression must +always be parenthesized except when it occurs at the top-level +expression on the right-hand side of an assignment, meaning +you can to write \code{val = yield i} but \code{val = (yield i) + 12}. + +Values are sent into a generator by calling its +\method{send(\var{value})} method. The generator's code is then +resumed and the \keyword{yield} expression produces \var{value}. +If the regular \method{next()} method is called, the \keyword{yield} +returns \constant{None}. + +Here's the previous example, modified to allow changing the value of +the internal counter. + +\begin{verbatim} +def counter (maximum): + i = 0 + while i < maximum: + val = (yield i) + # If value provided, change counter + if val is not None: + i = val + else: + i += 1 +\end{verbatim} + +And here's an example of changing the counter: + +\begin{verbatim} +>>> it = counter(10) +>>> print it.next() +0 +>>> print it.next() +1 +>>> print it.send(8) +8 +>>> print it.next() +9 +>>> print it.next() +Traceback (most recent call last): + File ``t.py'', line 15, in ? + print it.next() +StopIteration +Because \keyword{yield} will often be returning \constant{None}, +you shouldn't just use its value in expressions unless you're sure +that only the \method{send()} method will be used. + +There are two other new methods on generators in addition to +\method{send()}: + +\begin{itemize} + + \item \method{throw(\var{type}, \var{value}=None, + \var{traceback}=None)} is used to raise an exception inside the + generator; the exception is raised by the \keyword{yield} expression + where the generator's execution is paused. + + \item \method{close()} raises a new \exception{GeneratorExit} + exception inside the generator to terminate the iteration. + On receiving this + exception, the generator's code must either raise + \exception{GeneratorExit} or \exception{StopIteration}; catching the + exception and doing anything else is illegal and will trigger + a \exception{RuntimeError}. \method{close()} will also be called by + Python's garbage collection when the generator is garbage-collected. + + If you need to run cleanup code in case of a \exception{GeneratorExit}, + I suggest using a \code{try: ... finally:} suite instead of + catching \exception{GeneratorExit}. + +\end{itemize} + +The cumulative effect of these changes is to turn generators from +one-way producers of information into both producers and consumers. +Generators also become \emph{coroutines}, a more generalized form of +subroutines; subroutines are entered at one point and exited at +another point (the top of the function, and a \keyword{return +statement}), but coroutines can be entered, exited, and resumed at +many different points (the \keyword{yield} statements).science term + + \begin{seealso} \seepep{342}{Coroutines via Enhanced Generators}{PEP written by Guido van Rossum and Phillip J. Eby; -implemented by Phillip J. Eby.} +implemented by Phillip J. Eby. Includes examples of +some fancier uses of generators as coroutines.} + +\seeurl{http://en.wikipedia.org/wiki/Coroutine}{The Wikipedia entry for +coroutines.} + +\seeurl{http://www.sidhe.org/~dan/blog/archives/000178.html}{An +explanation of coroutines from a Perl point of view, written by Dan +Sugalski.} \end{seealso}

1 0

python/nondist/peps pep-3000.txt,1.18,1.19
by bcannon＠users.sourceforge.net 27 Aug '05

27 Aug '05

Update of /cvsroot/python/python/nondist/peps In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv25340 Modified Files: pep-3000.txt Log Message: Create new "Atomic Types" section and add mention of removal of basestring.find and friends. Index: pep-3000.txt =================================================================== RCS file: /cvsroot/python/python/nondist/peps/pep-3000.txt,v retrieving revision 1.18 retrieving revision 1.19 diff -u -d -r1.18 -r1.19 --- pep-3000.txt 6 Aug 2005 23:13:59 -0000 1.18 +++ pep-3000.txt 27 Aug 2005 18:27:33 -0000 1.19 @@ -73,8 +73,8 @@ * Unbound methods [7]_ -Built-ins -========= +Built-in Namespace +================== * Make built-ins return an iterator where appropriate (e.g. ``range()``, ``zip()``, etc.) @@ -100,6 +100,15 @@ * ``xrange()``: use ``range()`` instead [1]_ +Atomic Types +============ + +To be removed: + +* ``basestring.find()`` and ``basestring.rfind()``; use ``basestring.index()`` + or ``basestring.rindex()`` in a try/except block [15]_ + + Standard library ================ @@ -155,7 +164,10 @@ http://mail.python.org/pipermail/python-dev/2005-April/053060.html .. [14] python-dev email ("PEP 8: exception style") - http://mail.python.org/pipermail/python-dev/2005-August/055190.html + http://mail.python.org/pipermail/python-dev/2005-August/055190.html + +.. [15] python-dev email (Remove str.find in 3.0?) + http://mail.python.org/pipermail/python-dev/2005-August/055705.html Copyright

1 0

python/dist/src/Doc/lib libtarfile.tex, 1.7.2.1, 1.7.2.2
by birkenfeld＠users.sourceforge.net 27 Aug '05

27 Aug '05

Update of /cvsroot/python/python/dist/src/Doc/lib In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv10563/Doc/lib Modified Files: Tag: release24-maint libtarfile.tex Log Message: patch [ 1274550 ] libtarfile.tex: external URL changed Index: libtarfile.tex =================================================================== RCS file: /cvsroot/python/python/dist/src/Doc/lib/libtarfile.tex,v retrieving revision 1.7.2.1 retrieving revision 1.7.2.2 diff -u -d -r1.7.2.1 -r1.7.2.2 --- libtarfile.tex 12 Jul 2005 07:28:25 -0000 1.7.2.1 +++ libtarfile.tex 27 Aug 2005 17:10:38 -0000 1.7.2.2 @@ -127,8 +127,8 @@ \seemodule{zipfile}{Documentation of the \refmodule{zipfile} standard module.} - \seetitle[http://www.gnu.org/manual/tar/html_chapter/tar_8.html\#SEC118] - {GNU tar manual, Standard Section}{Documentation for tar archive files, + \seetitle[http://www.gnu.org/software/tar/manual/html_chapter/tar_8.html\#SEC134] + {GNU tar manual, Basic Tar Format}{Documentation for tar archive files, including GNU tar extensions.} \end{seealso}

1 0

python/dist/src/Doc/lib libtarfile.tex, 1.10, 1.11
by birkenfeld＠users.sourceforge.net 27 Aug '05

27 Aug '05

Update of /cvsroot/python/python/dist/src/Doc/lib In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv10553/Doc/lib Modified Files: libtarfile.tex Log Message: patch [ 1274550 ] libtarfile.tex: external URL changed Index: libtarfile.tex =================================================================== RCS file: /cvsroot/python/python/dist/src/Doc/lib/libtarfile.tex,v retrieving revision 1.10 retrieving revision 1.11 diff -u -d -r1.10 -r1.11 --- libtarfile.tex 12 Jul 2005 07:28:20 -0000 1.10 +++ libtarfile.tex 27 Aug 2005 17:10:35 -0000 1.11 @@ -128,8 +128,8 @@ \seemodule{zipfile}{Documentation of the \refmodule{zipfile} standard module.} - \seetitle[http://www.gnu.org/manual/tar/html_chapter/tar_8.html\#SEC118] - {GNU tar manual, Standard Section}{Documentation for tar archive files, + \seetitle[http://www.gnu.org/software/tar/manual/html_chapter/tar_8.html\#SEC134] + {GNU tar manual, Basic Tar Format}{Documentation for tar archive files, including GNU tar extensions.} \end{seealso}

1 0

python/dist/src/Doc/lib libhttplib.tex, 1.38.2.1, 1.38.2.2
by birkenfeld＠users.sourceforge.net 27 Aug '05

27 Aug '05

Update of /cvsroot/python/python/dist/src/Doc/lib In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv9212/Doc/lib Modified Files: Tag: release24-maint libhttplib.tex Log Message: patch [ 1274630 ] documentation fixes Index: libhttplib.tex =================================================================== RCS file: /cvsroot/python/python/dist/src/Doc/lib/libhttplib.tex,v retrieving revision 1.38.2.1 retrieving revision 1.38.2.2 diff -u -d -r1.38.2.1 -r1.38.2.2 --- libhttplib.tex 25 Jun 2005 19:16:58 -0000 1.38.2.1 +++ libhttplib.tex 27 Aug 2005 17:05:43 -0000 1.38.2.2 @@ -146,7 +146,7 @@ {http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.1.2}} \lineiii{PROCESSING}{\code{102}} {WEBDAV, \ulink{RFC 2518, Section 10.1} - {http://www.webdav.org/specs/rfc2518.htm#STATUS_102}} + {http://www.webdav.org/specs/rfc2518.html#STATUS_102}} \lineiii{OK}{\code{200}} {HTTP/1.1, \ulink{RFC 2616, Section 10.2.1} @@ -171,7 +171,7 @@ {http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.7}} \lineiii{MULTI_STATUS}{\code{207}} {WEBDAV \ulink{RFC 2518, Section 10.2} - {http://www.webdav.org/specs/rfc2518.htm#STATUS_207}} + {http://www.webdav.org/specs/rfc2518.html#STATUS_207}} \lineiii{IM_USED}{\code{226}} {Delta encoding in HTTP, \rfc{3229}, Section 10.4.1} @@ -253,13 +253,13 @@ {http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.18}} \lineiii{UNPROCESSABLE_ENTITY}{\code{422}} {WEBDAV, \ulink{RFC 2518, Section 10.3} - {http://www.webdav.org/specs/rfc2518.htm#STATUS_422}} + {http://www.webdav.org/specs/rfc2518.html#STATUS_422}} \lineiii{LOCKED}{\code{423}} {WEBDAV \ulink{RFC 2518, Section 10.4} - {http://www.webdav.org/specs/rfc2518.htm#STATUS_423}} + {http://www.webdav.org/specs/rfc2518.html#STATUS_423}} \lineiii{FAILED_DEPENDENCY}{\code{424}} {WEBDAV, \ulink{RFC 2518, Section 10.5} - {http://www.webdav.org/specs/rfc2518.htm#STATUS_424}} + {http://www.webdav.org/specs/rfc2518.html#STATUS_424}} \lineiii{UPGRADE_REQUIRED}{\code{426}} {HTTP Upgrade to TLS, \rfc{2817}, Section 6} @@ -283,7 +283,7 @@ {http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.6}} \lineiii{INSUFFICIENT_STORAGE}{\code{507}} {WEBDAV, \ulink{RFC 2518, Section 10.6} - {http://www.webdav.org/specs/rfc2518.htm#STATUS_507}} + {http://www.webdav.org/specs/rfc2518.html#STATUS_507}} \lineiii{NOT_EXTENDED}{\code{510}} {An HTTP Extension Framework, \rfc{2774}, Section 7} \end{tableiii}

1 0

python/dist/src/Doc/dist dist.tex,1.96,1.97
by birkenfeld＠users.sourceforge.net 27 Aug '05

27 Aug '05

Update of /cvsroot/python/python/dist/src/Doc/dist In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv8677/Doc/dist Modified Files: dist.tex Log Message: patch [ 1274630 ] documentation fixes Index: dist.tex =================================================================== RCS file: /cvsroot/python/python/dist/src/Doc/dist/dist.tex,v retrieving revision 1.96 retrieving revision 1.97 diff -u -d -r1.96 -r1.97 --- dist.tex 22 Jul 2005 21:49:26 -0000 1.96 +++ dist.tex 27 Aug 2005 17:04:59 -0000 1.97 @@ -1754,7 +1754,7 @@ the \command{upload} command are uploaded. The \command{upload} command uses the username and password stored in -in the file \file{\$HOME/.pypirc}, see section~\ref{pypirc}. +the file \file{\$HOME/.pypirc}, see section~\ref{pypirc}. \chapter{Examples} \label{examples}

1 0

python/dist/src/Doc/lib libhttplib.tex, 1.39, 1.40 libgrp.tex, 1.16, 1.17 libspwd.tex, 1.1, 1.2
by birkenfeld＠users.sourceforge.net 27 Aug '05

27 Aug '05

Update of /cvsroot/python/python/dist/src/Doc/lib In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv8677/Doc/lib Modified Files: libhttplib.tex libgrp.tex libspwd.tex Log Message: patch [ 1274630 ] documentation fixes Index: libhttplib.tex =================================================================== RCS file: /cvsroot/python/python/dist/src/Doc/lib/libhttplib.tex,v retrieving revision 1.39 retrieving revision 1.40 diff -u -d -r1.39 -r1.40 --- libhttplib.tex 25 Jun 2005 19:15:48 -0000 1.39 +++ libhttplib.tex 27 Aug 2005 17:04:59 -0000 1.40 @@ -146,7 +146,7 @@ {http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.1.2}} \lineiii{PROCESSING}{\code{102}} {WEBDAV, \ulink{RFC 2518, Section 10.1} - {http://www.webdav.org/specs/rfc2518.htm#STATUS_102}} + {http://www.webdav.org/specs/rfc2518.html#STATUS_102}} \lineiii{OK}{\code{200}} {HTTP/1.1, \ulink{RFC 2616, Section 10.2.1} @@ -171,7 +171,7 @@ {http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.7}} \lineiii{MULTI_STATUS}{\code{207}} {WEBDAV \ulink{RFC 2518, Section 10.2} - {http://www.webdav.org/specs/rfc2518.htm#STATUS_207}} + {http://www.webdav.org/specs/rfc2518.html#STATUS_207}} \lineiii{IM_USED}{\code{226}} {Delta encoding in HTTP, \rfc{3229}, Section 10.4.1} @@ -253,13 +253,13 @@ {http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.18}} \lineiii{UNPROCESSABLE_ENTITY}{\code{422}} {WEBDAV, \ulink{RFC 2518, Section 10.3} - {http://www.webdav.org/specs/rfc2518.htm#STATUS_422}} + {http://www.webdav.org/specs/rfc2518.html#STATUS_422}} \lineiii{LOCKED}{\code{423}} {WEBDAV \ulink{RFC 2518, Section 10.4} - {http://www.webdav.org/specs/rfc2518.htm#STATUS_423}} + {http://www.webdav.org/specs/rfc2518.html#STATUS_423}} \lineiii{FAILED_DEPENDENCY}{\code{424}} {WEBDAV, \ulink{RFC 2518, Section 10.5} - {http://www.webdav.org/specs/rfc2518.htm#STATUS_424}} + {http://www.webdav.org/specs/rfc2518.html#STATUS_424}} \lineiii{UPGRADE_REQUIRED}{\code{426}} {HTTP Upgrade to TLS, \rfc{2817}, Section 6} @@ -283,7 +283,7 @@ {http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.6}} \lineiii{INSUFFICIENT_STORAGE}{\code{507}} {WEBDAV, \ulink{RFC 2518, Section 10.6} - {http://www.webdav.org/specs/rfc2518.htm#STATUS_507}} + {http://www.webdav.org/specs/rfc2518.html#STATUS_507}} \lineiii{NOT_EXTENDED}{\code{510}} {An HTTP Extension Framework, \rfc{2774}, Section 7} \end{tableiii} Index: libgrp.tex =================================================================== RCS file: /cvsroot/python/python/dist/src/Doc/lib/libgrp.tex,v retrieving revision 1.16 retrieving revision 1.17 diff -u -d -r1.16 -r1.17 --- libgrp.tex 1 Mar 2002 10:38:44 -0000 1.16 +++ libgrp.tex 27 Aug 2005 17:04:59 -0000 1.17 @@ -45,4 +45,5 @@ \begin{seealso} \seemodule{pwd}{An interface to the user database, similar to this.} + \seemodule{spwd}{An interface to the shadow password database, similar to this.} \end{seealso} Index: libspwd.tex =================================================================== RCS file: /cvsroot/python/python/dist/src/Doc/lib/libspwd.tex,v retrieving revision 1.1 retrieving revision 1.2 diff -u -d -r1.1 -r1.2 --- libspwd.tex 23 Jan 2005 09:27:23 -0000 1.1 +++ libspwd.tex 27 Aug 2005 17:04:59 -0000 1.2 @@ -4,9 +4,10 @@ \declaremodule{builtin}{spwd} \platform{Unix} \modulesynopsis{The shadow password database (\function{getspnam()} and friends).} +\versionadded{2.5} This module provides access to the \UNIX{} shadow password database. -It is available on various Unix versions. +It is available on various \UNIX{} versions. You must have enough privileges to access the shadow password database (this usually means you have to be root). @@ -42,5 +43,6 @@ \begin{seealso} + \seemodule{grp}{An interface to the group database, similar to this.} \seemodule{pwd}{An interface to the normal password database, similar to this.} \end{seealso}

1 0