WatchYap -- automatic action each time you hit save

WatchYap automagically perform an action each time you touch watched files.

For instance, WatchYap can backup a timestamped snapshot of a file that you edit with any program, without getting in your way.

For example, each time you hit Ctrl-S within a drawing software, WatchYap will make a copy the current version of your file, along with the precise date of this version.

This may be useful for digital artists that want to prepare a time-lapse of their on-going work without having to think about it. You can even do an automatic Git commit the same way.

Usage

You should start WatchYap with the files you want to save as argument(s) and let it run during the time you want to perform your action(s). Once started, it will watch for modifications on the given file(s) and, for instance, create the snapshots by himself each time something happens.

Currently, WatchYap can perform the following actions:

• --save,
• --inkscape,
• --git,
• --log,
• --dbus (disabled if the sdbus python module is not installed),
• --zenity (disabled if the zenity command is not installed, or if no graphical display is available),
• --cmd [COMMAND].

You can pass multiple actions. For instance, you can both export a PNG and do a Git commit.

By default, timestamped snapshots have the same name than the targeted files, with the addition of the timestamp. For instance, with a target file named test.svg, a snapshot will look like test_2017-11-28T21:02:59.svg.

Synopsis

watchyap.py [-h] [--save] [--inkscape] [--git] [--log] [--dbus] [-d DIRECTORY] [-y DELAY] [-s SEPARATOR] [-t TEMPLATE] [-w] [-v {DEBUG,INFO,WARNING,ERROR}] [-e {opened,moved,deleted,created,modified,closed}...] target [target ...]

Required positional argument

target: The file to watch.

Optional arguments

Actions:

• --save: Save a snapshot of the watched file.

• --inkscape: Save a PNG snpashot of the watched SVG file.

• --git: Commit the watched file if it has been modified.

• --log: Print a message.

• --dbus: Send a notification to the system's D-Bus.

• --zenity: Pop-up a dialog window.

• --cmd [COMMAND]: Run the passed command for each watched file. You can use tags, which will be replaced by actual data:

    - {target} (the current watched file),
    - {flick} (the timestamped absolute filename, containing the --directory),
    - {directory} (cf. --directory, where to put timestamped files),
    - {separator} (cf. --separator),
    - {timestamp} (the timestamp formatted by --template),
    - {alt_ext} (cf. --alt-ext alternate extension),
    - {no_overwrite} (cf. --no-overwrite boolean, 1 if True, 0 if False),
    - {event} (the event type, cf. --events).
  

Common actions parameters:

• -y DELAY, --delay DELAY: The minimum time (in seconds) between running actions. (default: 10)
• -e {opened,moved,deleted,created,modified,closed}..., --events: The events touching the watched file for which you want your action perfomed. You can pass multiple (space-separated) events, then the action will be performed for each of them. (default: modified)

Actions parameters affecting only certain actions:

• -d DIRECTORY, --directory DIRECTORY: The directory in which to copy the saved versions. (default: .)
• -s SEPARATOR, --separator SEPARATOR: Separator character between the file name and the date stamp. (default: _)
• -t TEMPLATE, --template TEMPLATE: Template of the date stamp. (default: %Y-%m-%dT%H:%M:%S)
• -w, --no-overwrite: Do not overwrite snapshots created at the same time, but append a number to their name (especially useful if you watch several events).
• -x EXTENSION, --alt-ext EXTENSION: Alternate extension for the timestamped snapshot (do not forget the dot). (default: )

Other:

• -h, --help: show this help message and exit.
• -v {DEBUG,INFO,WARNING,ERROR}, --verbose {DEBUG,INFO,WARNING,ERROR}: Verbosity level. (default: WARNING)

Examples

Command line

Just start WatchYap with your target file as an argument:

$ watchyap --save my_file.svg

Then edit your file and save it. As usual, hit Ctrl-C (or close the terminal) to stop WatchYap.

If you want to specify a directory in which to put your snapshots, with no more than one separate file every minute:

$ watchyap --inkscape --directory watchyap --delay 60 my_file.svg

You can call sevral actions, for instance export a PNG and commit the source SVG:

$ watchyap --inkscape --git my_file.svg

You can use your shell to create the file list:

$ watchyap --git *.py

And even handle files in subdirectories:

$ watchyap --log */*.log

You may want to save both the file before and after it was modified by any program:

$ watchyap --save --events opened closed --no-overwrite my_file

You can export PNGs and commit their source across sub-directories, and be notified when it's done:

$ watchyap --inkscape --git --dbus --events closed */*.svg

You can also prepare the list of files to watch by using a subcommand:

$ watchyap --log $(find . -type f -name *.png | grep -v test)

If you want to pass your own command:

$ watchyap --cmd "git commit -a -m 'whatever'" my_file
$ watchyap --cmd "git add {target} ; git commit -m 'Automated commit' ; git tag '{timestamp}'"
$ watchyap --cmd "echo '{flick}' > watching_pipe" *.log
$ watchyap --alt-ext .jpg --cmd "convert -antialias {target} {flick}" my_file.png

Authors

Original Author: nojhan ()