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

Deprecated since release 2.2. Use os.stat() directly instead of using the cache; the cache introduces a very high level of fragility in applications using it and complicates application code with the addition of cache management support.

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.