Pymon

Created by Curtis Li

Pymon is a Python port of Nodemon. It monitors the file system at a given path/directory, and restarts an application whenever changes are detected.

Features

• Manual restarting of applications by typing rs or restart in command-line interface
• Automatic restarting of applications whenever changes in the file system are detected
• Able to custom specify a directory/path to monitor
• Able to use regex to filter and match which files/directories to monitor
• Use a configuration file or environment variables to preset your settings
• Support for restarting both Python and non-Python applications
• Automated test suite using PyUnit/unittest and Travis
• Build support for both versions Python 2 and Python 3

Installation

Currently, the only way to install Pymon is to download from source:

git clone https://github.com/curtis99877/pymon.git

It may be useful to add the directory to your PATH:

export PATH="$PATH:<pymon root dir>"

In the future, pymon will hopefully be available as a pip module.

Basic Usage

To run an application, run:

./pymon.py app.py [args ...]

or

python pymon.py app.py [args ...]

To restart an application, type:

rs

or

restart

To stop an application, type:

stop

or

<Ctrl+C>

Advanced Usage

Help

./pymon.py --help

Version

./pymon.py --version

Verbose/Debug mode

./pymon.py --debug

Running non-Python applications

Declare the runtime for running the application, e.g. JavaScript:

./pymon.py --exec node app.js

Default settings:

./pymon.py --exec python

Regex matching

To only monitor certain files:

./pymon.py --match ".*[.]py"

To ignore monitoring certain files:

./pymon.py --ignore ".*[.]pyc"

To use multiple regexes:

./pymon.py --match ".*[.]py" --match ".*[.]cfg" --ignore ".*[.]pyc"

TODO

• Add support for multiple apps/processes
• Be installable as a pip library/module

Dependencies

• Watchdog
• Six