Deprecate the dircache module for 3.0.

Doc/library/dircache.rst

@@ -4,6 +4,12 @@
 
 .. module:: dircache
    :synopsis: Return directory listing, with cache mechanism.
+   :deprecated:
+   
+.. deprecated:: 2.6
+   The dircache module has been removed in Python 3.0.
+   
+   
 .. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il>
 
 

Lib/dircache.py

@@ -3,6 +3,9 @@
 The listdir() routine returns a sorted list of the files in a directory,
 using a cache to avoid reading the directory more often than necessary.
 The annotate() routine appends slashes to directories."""
+from warnings import warnpy3k
+warnpy3k("the dircache module has been removed in Python 3.0", stacklevel=2)
+del warnpy3k
 
 import os
 

Lib/test/regrtest.py

@@ -678,7 +678,8 @@ def run_the_test():
 
 def dash_R_cleanup(fs, ps, pic, abcs):
     import gc, copy_reg
-    import _strptime, linecache, dircache
+    import _strptime, linecache
+    dircache = test_support.import_module('dircache', deprecated=True)
     import urlparse, urllib, urllib2, mimetypes, doctest
     import struct, filecmp
     from distutils.dir_util import _path_created

Lib/test/test_dircache.py

@@ -4,8 +4,9 @@
 """
 
 import unittest
-from test.test_support import run_unittest, TESTFN
-import dircache, os, time, sys, tempfile
+from test.test_support import run_unittest, TESTFN, import_module
+dircache = import_module('dircache', deprecated=True)
+import os, time, sys, tempfile
 
 
 class DircacheTests(unittest.TestCase):
@@ -66,7 +67,10 @@ def test_annotate(self):
 
 
 def test_main():
+    try:
         run_unittest(DircacheTests)
+    finally:
+        dircache.reset()
 
 
 if __name__ == "__main__":

Lib/test/test_py3kwarn.py

@@ -129,7 +129,7 @@ class TestStdlibRemovals(unittest.TestCase):
     # test.testall not tested as it executes all unit tests as an
     # import side-effect.
     all_platforms = ('audiodev', 'imputil', 'mutex', 'user', 'new', 'rexec',
-                        'Bastion', 'compiler')
+                        'Bastion', 'compiler', 'dircache')
     inclusive_platforms = {'irix':('pure',)}
     # XXX Don't know if lib-tk is only installed if _tkinter is built.
     optional_modules = ('bsddb185', 'Canvas')