Home | History | Annotate | Download | only in python2.7
      1 """Read and cache directory listings.
      2 
      3 The listdir() routine returns a sorted list of the files in a directory,
      4 using a cache to avoid reading the directory more often than necessary.
      5 The annotate() routine appends slashes to directories."""
      6 from warnings import warnpy3k
      7 warnpy3k("the dircache module has been removed in Python 3.0", stacklevel=2)
      8 del warnpy3k
      9 
     10 import os
     11 
     12 __all__ = ["listdir", "opendir", "annotate", "reset"]
     13 
     14 cache = {}
     15 
     16 def reset():
     17     """Reset the cache completely."""
     18     global cache
     19     cache = {}
     20 
     21 def listdir(path):
     22     """List directory contents, using cache."""
     23     try:
     24         cached_mtime, list = cache[path]
     25         del cache[path]
     26     except KeyError:
     27         cached_mtime, list = -1, []
     28     mtime = os.stat(path).st_mtime
     29     if mtime != cached_mtime:
     30         list = os.listdir(path)
     31         list.sort()
     32     cache[path] = mtime, list
     33     return list
     34 
     35 opendir = listdir # XXX backward compatibility
     36 
     37 def annotate(head, list):
     38     """Add '/' suffixes to directories."""
     39     for i in range(len(list)):
     40         if os.path.isdir(os.path.join(head, list[i])):
     41             list[i] = list[i] + '/'
     42