cs.filestate 20181107

Trivial FileState class used to watch for file changes.

Facility to track file state.

This is used to watch for size or modification time changes, or to notice when a file path no longer points at the same file.

Function FileState(path, do_lstat=False, missing_ok=False)

Return a signature object for a file state derived from os.stat (or os.lstat if do_lstat is true). path may also be an int, in which case os.fstat is used. This returns an object with mtime, size, dev and ino attributes and can be compared for equality with other signatures. missing_ok: return None if the target file is missing, otherwise raise. Default False.