cpython/Lib/dircache.py

45 lines
1.1 KiB
Python
Raw Normal View History

"""Read and cache directory listings.
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."""
1990-10-13 16:23:40 -03:00
1992-03-31 14:55:40 -04:00
import os
1990-10-13 16:23:40 -03:00
__all__ = ["listdir", "opendir", "annotate", "reset"]
1990-10-13 16:23:40 -03:00
cache = {}
def reset():
2001-03-16 04:29:48 -04:00
"""Reset the cache completely."""
global cache
cache = {}
def listdir(path):
"""List directory contents, using cache."""
try:
cached_mtime, list = cache[path]
del cache[path]
except KeyError:
cached_mtime, list = -1, []
try:
mtime = os.stat(path)[8]
except os.error:
return []
if mtime != cached_mtime:
try:
list = os.listdir(path)
except os.error:
return []
list.sort()
cache[path] = mtime, list
return list
1990-10-13 16:23:40 -03:00
opendir = listdir # XXX backward compatibility
def annotate(head, list):
"""Add '/' suffixes to directories."""
for i in range(len(list)):
if os.path.isdir(os.path.join(head, list[i])):
list[i] = list[i] + '/'