Several changes which allow subclasses to do some calculation for each

file processed.  This would allow for example, a throttling algorithm
which limited the number of files processed per time period, or when
load averages were too high.  Specifically,

run(): Allow __oneloop() to return any false value, not just zero, to
trigger the snooze alarm.

__oneloop(): After each file is processed, call _shortcircuit() and
break out of the file loop if that returns a true value.  This way,
_shortcircuit() is executed for each file processed, and gives
subclasses a chance to do some per-file calculation.  _doperiodic()
is at a finer granularity, since it conflates per-file and
per-processing-loop calculations.

_cleanup(), _dispose(), _doperiodic(), _snooze(), _shortcircuit(): Add
docstrings describing their interface.

_shortcircuit(): Default is to return 0, meaning don't shortcircuit.

0 files changed, 0 insertions, 0 deletions