kivagant/runonce

Run any shell command only once (deny concurrent execution)

0.0.4 2016-05-10 07:21 UTC

Requires

• liip/process-manager: ^1.0

Apache License v2.0

• Eugene Glotov

• shell
• pid
• once

README

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.

Warnings

NO WARRANTY implied!

Only Unix is supported. This tool does not working neither in OSX nor in Windows. Tested in RHEL 7.

Installation

Download this repo somewhere or run.

composer require kivagant/runonce

Usage and examples

Basic usage:

 ./vendor/bin/runonce your-command

Verbose output:

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

Example 1:

Run first command:

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

Run another one: different options are considered as different processes.

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

Run the first command again:

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

Example 2:

More complex commands:

./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.

Contributing

Just fork and send me a pull request.

License

Apache License 2.0