summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRaymond Hettinger <python@rcn.com>2004-12-05 01:58:09 (GMT)
committerRaymond Hettinger <python@rcn.com>2004-12-05 01:58:09 (GMT)
commitf3fa9460dee3a11f862bd43fb7e4a70e994363e6 (patch)
tree956ea5e541e3801d84eda964c854f39f556e2c1e
parent664347be946f0a217f91259f93962727ba84c287 (diff)
downloadcpython-f3fa9460dee3a11f862bd43fb7e4a70e994363e6.zip
cpython-f3fa9460dee3a11f862bd43fb7e4a70e994363e6.tar.gz
cpython-f3fa9460dee3a11f862bd43fb7e4a70e994363e6.tar.bz2
Removed deprecated use_statcache argument.
-rw-r--r--Doc/lib/libfilecmp.tex9
-rw-r--r--Lib/filecmp.py13
-rw-r--r--Misc/NEWS2
3 files changed, 8 insertions, 16 deletions
diff --git a/Doc/lib/libfilecmp.tex b/Doc/lib/libfilecmp.tex
index 7747c8c..edc3aad 100644
--- a/Doc/lib/libfilecmp.tex
+++ b/Doc/lib/libfilecmp.tex
@@ -11,13 +11,12 @@ directories, with various optional time/correctness trade-offs.
The \module{filecmp} module defines the following functions:
-\begin{funcdesc}{cmp}{f1, f2\optional{, shallow\optional{, use_statcache}}}
+\begin{funcdesc}{cmp}{f1, f2\optional{, shallow}}
Compare the files named \var{f1} and \var{f2}, returning \code{True} if
they seem equal, \code{False} otherwise.
Unless \var{shallow} is given and is false, files with identical
\function{os.stat()} signatures are taken to be equal.
-\versionchanged[\var{use_statcache} is obsolete and ignored.]{2.3}
Files that were compared using this function will not be compared again
unless their \function{os.stat()} signature changes.
@@ -27,7 +26,7 @@ portability and efficiency.
\end{funcdesc}
\begin{funcdesc}{cmpfiles}{dir1, dir2, common\optional{,
- shallow\optional{, use_statcache}}}
+ shallow}}
Returns three lists of file names: \var{match}, \var{mismatch},
\var{errors}. \var{match} contains the list of files match in both
directories, \var{mismatch} includes the names of those that don't,
@@ -37,8 +36,8 @@ lack permission to read them or many other reasons, but always that
the comparison could not be done for some reason.
The \var{common} parameter is a list of file names found in both directories.
-The \var{shallow} and \var{use_statcache} parameters have the same
-meanings and default values as for \function{filecmp.cmp()}.
+The \var{shallow} parameter has the same
+meaning and default value as for \function{filecmp.cmp()}.
\end{funcdesc}
Example:
diff --git a/Lib/filecmp.py b/Lib/filecmp.py
index 089c667..35cedef 100644
--- a/Lib/filecmp.py
+++ b/Lib/filecmp.py
@@ -19,7 +19,7 @@ __all__ = ["cmp","dircmp","cmpfiles"]
_cache = {}
BUFSIZE=8*1024
-def cmp(f1, f2, shallow=1, use_statcache=None):
+def cmp(f1, f2, shallow=1):
"""Compare two files.
Arguments:
@@ -31,8 +31,6 @@ def cmp(f1, f2, shallow=1, use_statcache=None):
shallow -- Just check stat signature (do not read the files).
defaults to 1.
- use_statcache -- obsolete argument.
-
Return value:
True if the files are the same, False otherwise.
@@ -41,9 +39,6 @@ def cmp(f1, f2, shallow=1, use_statcache=None):
with a cache invalidation mechanism relying on stale signatures.
"""
- if use_statcache is not None:
- warnings.warn("use_statcache argument is deprecated",
- DeprecationWarning)
s1 = _sig(os.stat(f1))
s2 = _sig(os.stat(f2))
@@ -244,13 +239,12 @@ class dircmp:
self.methodmap[attr](self)
return getattr(self, attr)
-def cmpfiles(a, b, common, shallow=1, use_statcache=None):
+def cmpfiles(a, b, common, shallow=1):
"""Compare common files in two directories.
a, b -- directory names
common -- list of file names found in both directories
shallow -- if true, do comparison based solely on stat() information
- use_statcache -- obsolete argument
Returns a tuple of three lists:
files that compare equal
@@ -258,9 +252,6 @@ def cmpfiles(a, b, common, shallow=1, use_statcache=None):
filenames that aren't regular files.
"""
- if use_statcache is not None:
- warnings.warn("use_statcache argument is deprecated",
- DeprecationWarning)
res = ([], [], [])
for x in common:
ax = os.path.join(a, x)
diff --git a/Misc/NEWS b/Misc/NEWS
index b20b872..63c89d2 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -21,6 +21,8 @@ Extension Modules
Library
-------
+- the filecmp module no longer uses the deprecated use_statcache argument.
+
- unittest.TestCase.run() and unittest.TestSuite.run() can now be successfully
extended or overridden by subclasses. Formerly, the subclassed method would
be ignored by the rest of the module. (Bug #1078905).