1 """Read and cache directory listings.
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."""
9 __all__ = ["listdir", "opendir", "annotate", "reset"]
14 """Reset the cache completely."""
19 """List directory contents, using cache."""
21 cached_mtime, list = cache[path]
24 cached_mtime, list = -1, []
25 mtime = os.stat(path).st_mtime
26 if mtime != cached_mtime:
27 list = os.listdir(path)
29 cache[path] = mtime, list
32 opendir = listdir # XXX backward compatibility
34 def annotate(head, list):
35 """Add '/' suffixes to directories."""
36 for i in range(len(list)):
37 if os.path.isdir(os.path.join(head, list[i])):
38 list[i] = list[i] + '/'