Command-line executable Python script to re-run the given command every timefiles are modified in the current directory or its subdirectories.
Project description
Usage
rerun [--help|-h] [--verbose|-v] [--ignore|-i=<file>] [--version] <command>
Where:
<command> Command to execute
--help|-h Show this help message and exit.
--ignore|-i=<file> File or directory to ignore. Any directories of the
given name (and their subdirs) are excluded from the
search for changed files. Any modification to files of
the given name are ignored. The given value is
compared to basenames, so for example, "--ignore=def"
will skip the contents of directory "./abc/def/" and
will ignore file "./ghi/def". Can be specified multiple
times.
--verbose|-v Display the names of changed files before the command
output.
--version Show version number and exit.
Description
Rerun detects changes to files by polling file modification times once per second. It looks in the current directory and all its subdirectories. On detecting any changes, it clears the terminal and reruns the given command.
It always ignores directories called .svn, .git, .hg, .bzr, build and dist.
It always ignores files ending with .pyc or .pyo.
e.g:
rerun python -m unittest mypackage.mymodule
will rerun your tests every time you save your source code, but it won’t rerun the tests a second time when .pyo files get updated as a result of executing the tests. Handy for seeing the new test results in another console window after you hit ‘save’ in your editor, without having to change window focus.
Dependencies
Tested on MacOSX, Ubuntu, WindowsXP, Windows 7.
Tested under Python2.7 or 3.2. May run under Python 2.6 or older with PyPI package ‘argparse’ installed.
No other dependencies.
Install
pip install rerun
Known Problems
Polling for modification times perhaps isn’t ideal. Registering of OS-specific notifications of file system events might be better. In practice though, I haven’t noticed it burden my machine in directories containing hundreds of files.
It might be handy if ‘–ignore’ accepted globs, e.g. “*.tmp”
See issues at https://bitbucket.org/tartley/rerun/issues?status=new&status=open
Alternatives
PyPI package ‘watchdog’ is a cross-platform library for handling file-system events, which includes script ‘watchmedo’, which looks like a more serious and heavy-duty version of ‘Rerun’.
Thanks
The idea came from the Bash command ‘watch’, and inspiration for this implementation came from an old blog post by Jeff Winkler, whos website http://jeffwinkler.net seems to have now died.
Contact
- Documentation & download:
- Souce code and issues:
- Contact the author:
Jonathan Hartley, email: tartley at domain tartley.com, Twitter: @tartley.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
File details
Details for the file rerun-1.0.15.zip.
File metadata
- Download URL: rerun-1.0.15.zip
- Upload date:
- Size: 12.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | abed0dc8109b156cb539afabf05f268adb6ef27c587d7831d5b27f1038a504c5 |
|
| MD5 | 14ae57d0d3e7aa77b2330265b1287635 |
|
| BLAKE2b-256 | a226c01f1893a92c031858b56ac005539154fead831500e9573d6aac51be3cf8 |
File details
Details for the file rerun-1.0.15.tar.gz.
File metadata
- Download URL: rerun-1.0.15.tar.gz
- Upload date:
- Size: 6.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 1f774c2ffd5e3fdfb616da1afbc56f27b8a6f872dfced9d8806d41771fe64e27 |
|
| MD5 | 2b907bde5bc4e4fb17ab5f81a8ca759c |
|
| BLAKE2b-256 | 3b200e663f3946651601e6d06f87b91d9f791ef9430cc58f91a518425eb12eb8 |
