open-like access

No files or tests are named. Start by reviewing the package's current cache access and iterator behavior, then compare the requested API with Python's builtin open parameters; done means defining supported behavior, preserving one file version during iteration, and raising NotImplementedError for unsupported operations.

Another feature I would like is an API like the builtin open. This is less urgent, and does not even need to be part of this package. If you are not keen, it can exist only in coala.

It might seem a little strange to rewrap the cache in a file open-like API, but it helps ensure our access is strictly an iteraror, and it means the semantics are familiar and not tied to this implementation. The iterator needs to ensure one version of the file is processed, even if the file has been modified, and thus the cache is invalidated.

It can, and should, raise exceptions such as NotImplementedError for open parameters that are not able to be provided for the wrapped file cache object, or the operation is possible but not yet built because it is non-trivial to build properly.

Again, I am happy to build if you are happy for this feature to reside in your package.