]> granicus.if.org Git - python/commitdiff
Describe various things
authorAndrew M. Kuchling <amk@amk.ca>
Sun, 20 Mar 2005 19:26:30 +0000 (19:26 +0000)
committerAndrew M. Kuchling <amk@amk.ca>
Sun, 20 Mar 2005 19:26:30 +0000 (19:26 +0000)
Doc/whatsnew/whatsnew25.tex

index c1ff3748a66c4fab514f4393c3209f3de713a53b..3d5a32af59de2aaf959755c6c5b6f9e03f3d1e67 100644 (file)
@@ -41,7 +41,7 @@ language.
 
 \item The \function{min()} and \function{max()} built-in functions
 gained a \code{key} keyword argument analogous to the \code{key}
-argument for \function{sort()}.  This argument supplies a function
+argument for \method{sort()}.  This argument supplies a function
 that takes a single argument and is called for every value in the list; 
 \function{min()}/\function{max()} will return the element with the 
 smallest/largest return value from this function.
@@ -55,10 +55,17 @@ print max(L, key=len)
 print max(L)         
 \end{verbatim}
 
-% XXX also supported by heapq.nsmallest() and heapq.nlargest().
-
 (Contributed by Steven Bethard and Raymond Hettinger.)
 
+\item The list of base classes in a class definition can now be empty.  
+As an example, this is now legal:
+
+\begin{verbatim}
+class C():
+    pass
+\end{verbatim}
+(Implemented by Brett Cannon.)
+
 \end{itemize}
 
 
@@ -95,17 +102,48 @@ details.
 % datetime.datetime() now has a strptime class method which can be used to
 % create datetime object using a string and format.
 
+\item The \function{nsmallest()} and 
+\function{nlargest()} functions in the \module{heapq} module 
+now support a \code{key} keyword argument similar to the one
+provided by the \function{min()}/\function{max()} functions
+and the \method{sort()} methods.  For example:
+Example:
+
+\begin{verbatim}
+>>> import heapq
+>>> L = ["short", 'medium', 'longest', 'longer still']
+>>> heapq.nsmallest(2, L)  # Return two lowest elements, lexicographically
+['longer still', 'longest']
+>>> heapq.nsmallest(2, L, key=len)   # Return two shortest elements
+['short', 'medium']
+\end{verbatim}
+
+(Contributed by Raymond Hettinger.)
+
 % itertools.islice() now accepts None for the start and step arguments.
 
 \item New module: \module{spwd} provides functions for accessing the
 shadow password database on systems that support it.  
 % XXX give example
 
-% XXX os.stat_float_times is now True
+\item The \module{os} module underwent a number of changes.  The
+\member{stat_float_times} variable now defaults to true, meaning that
+\function{os.stat()} will now return time values as floats.  (This
+doesn't necessarily mean that \function{os.stat()} will return times
+that are precise to fractions of a second; not all systems support
+such precision.)
+
+Also, constants named \member{os.SEEK_SET}, \member{os.SEEK_CUR}, and
+\member{os.SEEK_END} have been added; these are the parameters to the
+\function{os.lseek()} function.
+
+\item The \class{TarFile} class in the \module{tarfile} module now has
+a \method{extractall()} method that extracts all members from the
+archive into the current working directory.  It's also possible to set
+a different directory as the extraction target, and to unpack only a
+subset of the archive's members.  (Contributed by Lars Gust\"abel.)
 
-% os.{SEEK_SET, SEEK_CUR, SEEK_END} have been added for convenience.
 
-\end{itemize}
 
 
 %======================================================================