kivagant/runonce

Run any shell command only once (deny concurrent execution)

RunOnce

, _(*1)

About

RunOnce is the php-based Unix tool that help you to run any command only once. This tool will only execute command and will not waiting for result., _(*2)

Warnings

NO WARRANTY implied!, _(*3)

Only Unix is supported. This tool does not working neither in OSX nor in Windows. Tested in RHEL 7., _(*4)

Installation

Download this repo somewhere or run., _(*5)

composer require kivagant/runonce

Usage and examples

Basic usage:, _(*6)

 ./vendor/bin/runonce your-command

Verbose output:, _(*7)

 ./vendor/bin/runonce -v your-command

Example 1:, _(*8)

Run first command:, _(*9)

./vendor/bin/runonce sleep 10 && echo 'first launch' || echo 'already running';
> first launch

Run another one: different options are considered as different processes., _(*10)

./vendor/bin/runonce sleep 20 && echo 'first launch' || echo 'already running';
> first launch

Run the first command again:, _(*11)

./vendor/bin/runonce sleep 10 && echo 'first launch' || echo 'already running';
> already running

Example 2:, _(*12)

More complex commands:, _(*13)

./vendor/bin/runonce php ./cron.php -v=\"some string\" && echo 'first launch' || echo 'already running';
> first launch

./vendor/bin/runonce -v php ./cron.php -v=\"some string\" && echo 'first launch' || echo 'already running';
> Command was already executed with PID  20438
> already running

Dependencies

This tool based on the liip/process-manager., _(*14)

Contributing

Just fork and send me a pull request., _(*15)

License

Apache License 2.0, _(*16)