Download the PHP package lrackwitz/para without Composer
On this page you can find all versions of the php package lrackwitz/para. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download lrackwitz/para
More information about lrackwitz/para
Files in lrackwitz/para
Package para
Short Description A command-line tool for parallel execution of shell commands in multiple directories.
License GPL-3.0-or-later
Informations about the package para
Para
A command-line tool for parallel execution of shell commands in multiple directories.
How to use it?
These instructions will show you how to install para
on your local machine and how to work with it.
Prerequisites
In order to install para
the following software is needed:
Installing
To install para
you can choose one of the following methods.
Standalone (Recommended)
This is the easiest way to install para
on your local machine.
Just copy the following command-line and paste it into your terminal to run the automatic install script.
As composer package
This will install para
into your global composer vendor folder.
Manually
Follow these instructions if you want to install para
manually:
If para
has been installed correctly you should get the installed version by entering the following command:
Configuring
Before you can use para
you need at least to add the directories you want para
to manage.
This can be done by executing the following command:
Arguments:
- The value of the argument
project_name
should be a unique single word to identify the directory you want to add. - The value of the argument
project_path
should be the absolute path of the directory you want to manage. - The value of the optional argument
group_name
should be a unique single word to identify a group of projects. The default value isdefault
.
Example
This will result in two groups called my_group
and default
.
The group my_group
will contain project1
, project2
and project3
.
The group default
will contain only project4
.
color: To see which color code you can choose execute the script tools/colortable.sh
To see the current configuration enter this command:
Executing a command in multiple directories (para projects) at the same time
The following example shows what you need to do to let para execute a shell command in every project configured for a specific group.
Open the para shell for a configured project group.
Example
And execute any shell command you like.
After pressing enter the shell will output something like this:
You can continue entering more shell commands or type exit
to leave the para shell
.
Example
Imagine project1
, project2
and project3
have a composer.json
file.
We changed something in the composer.json
of project2
and want to sync the changes to project1
and project3
.
Showing a log by para
project
Every command you execute in the interactive para shell
will be logged.
Enter the following command to see which commands you've executed and what the output was.
Example
Show the log of para
project project2
.
Extending the functionality with your own code
To extend the functionality of para
with your own code, you simply need to create a new composer
package. The type
in the composer.json
needs to be para-plugin
.
See the example composer.json file:
Get a list of available para plugins
Installing a custom para
plugin
Uninstalling a plugin
Get a list of installed plugins
If everything worked, you can now use the extended functionality of your custom para
plugin
when executing para
as usual.
Synchronization of files within para
projects
In order to be able to synchronize files within para
projects you need to install the para-sync
plugin.
The code of the para plugin is here: https://github.com/rackberg/para-sync
Contributing
Please read CONTRIBUTING.md for details on the code of conduct, and the process for creating issues or submitting pull requests.
Versioning
This project uses SemVer for versioning. For the versions available, see the tags on this repository.
Have a look at the CHANGELOG.md.
Authors
- Lars Rosenberg - Initial work - Para
Credits
I want to say thank you to comm-press GmbH for supporting me developing para
.
License
This project is licensed under the GPL-3.0-or-later License - see the LICENSE.md file for details.
All versions of para with dependencies
oomphinc/composer-installers-extender Version ^1.1
symfony/console Version >=2.9 ^3.4
symfony/process Version >=2.9 ^3.4
symfony/monolog-bundle Version >=2.9 ^3.0
symfony/yaml Version >=2.9 ^3.4
monolog/monolog Version ^1.22
symfony/finder Version ^4.0
composer/composer Version ^1.6
guzzlehttp/guzzle Version ^6.3