6.5 `statcache` -- An optimization of `os.stat()`

The statcache module provides a simple optimization to os.stat(): remembering the values of previous invocations.

The statcache module defines the following functions:

stat(path): This is the main module entry-point. Identical for os.stat(), except for remembering the result for future invocations of the function.

The rest of the functions are used to clear the cache, or parts of it.

reset(): Clear the cache: forget all results of previous stat() calls.

forget(path): Forget the result of stat(path), if any.

forget_prefix(prefix): Forget all results of stat(path) for path starting with prefix.

forget_dir(prefix): Forget all results of stat(path) for path a file in the directory prefix, including stat(prefix).

forget_except_prefix(prefix): Similar to forget_prefix(), but for all path values not starting with prefix.

Example:

>>> import os, statcache
>>> statcache.stat('.')
(16893, 2049, 772, 18, 1000, 1000, 2048, 929609777, 929609777, 929609777)
>>> os.stat('.')
(16893, 2049, 772, 18, 1000, 1000, 2048, 929609777, 929609777, 929609777)

See About this document... for information on suggesting changes.