net_bazzline / php_component_process_pipe
free as in freedom php component process to easy up creation of pipe process in php
Installs: 1 152
Dependents: 3
Suggesters: 0
Security: 0
Stars: 3
Watchers: 5
Forks: 0
Open Issues: 0
Requires
- php: >=5.3.3
Requires (Dev)
- mockery/mockery: 0.9.4
- phpunit/phpunit: ~4.8||~5.4
This package is auto-updated.
Last update: 2024-10-29 12:47:38 UTC
README
This free as in freedom component ease up creation of a pipe for processes in php.
Indeed, it is a pseudo pipeline (process collection or process batch) since the php process is single threaded so far.
Currently, there is no plan to bloat the code base with an implementation of STDIN, STDOUT or STDERR. Errors can be handled by the thrown exception. Input is defined by the ExecutableInterface, as well as the output (return value).
The build status of the current master branch is tracked by Travis CI:
It is also available at openhub.net.
Changelog can be found here.
Why?
- separate complex operations into simpler
- easy up unit testing for smaller processes
- separate responsibility (data generator/transformer/validator/flow manipulator)
- create process chains you can read in the code (separate integration code from operation code)
- no dependencies (except you want to join the development team)
Examples
- no input
- input array
- failing execution
- input generator
- input transformer
- input validator
- data flow manipulator
Install
By Hand
mkdir -p vendor/net_bazzline/php_component_process_pipe
cd vendor/net_bazzline/php_component_process_pipe
git clone https://github.com/bazzline/php_component_process_pipe
With Packagist
composer require net_bazzline/php_component_process_pipe:dev-master
Usage
By using the pipe method for multiple process
use Net\Bazzline\Component\ProcessPipe\ExecutableException; use Net\Bazzline\Component\ProcessPipe\InvalidArgumentException; use Net\Bazzline\Component\ProcessPipe\Pipe; try { $pipe = new Pipe(); $pipe->pipe( new ProcessOne(), new ProcessTwo() ); $output = $pipe->execute($input); } catch (ExecutableException) { //handle process exception } catch (InvalidArgumentException) { //handle pipe exception }
By using the pipe method once for each process
use Net\Bazzline\Component\ProcessPipe\ExecutableException; use Net\Bazzline\Component\ProcessPipe\InvalidArgumentException; use Net\Bazzline\Component\ProcessPipe\Pipe; try { $pipe = new Pipe(); $pipe->pipe(new ProcessOne()); $pipe->pipe(new ProcessTwo()); $output = $pipe->execute($input); } catch (ExecutableException) { //handle process exception } catch (InvalidArgumentException) { //handle pipe exception }
By instantiation
use Net\Bazzline\Component\ProcessPipe\ExecutableException; use Net\Bazzline\Component\ProcessPipe\InvalidArgumentException; use Net\Bazzline\Component\ProcessPipe\Pipe; try { $pipe = new Pipe( new ProcessOne(), new ProcessTwo() ); $output = $pipe->execute($input); } catch (ExecutableException) { //handle process exception } catch (InvalidArgumentException) { //handle pipe exception }
By doing all
use Net\Bazzline\Component\ProcessPipe\ExecutableException; use Net\Bazzline\Component\ProcessPipe\InvalidArgumentException; use Net\Bazzline\Component\ProcessPipe\Pipe; try { $pipe = new Pipe( new ProcessOne(), new ProcessTwo() ); $pipe->pipe(new ProcessThree()); $pipe->pipe( new ProcessFour(), new ProcessFive() ); $output = $pipe->execute($input); } catch (ExecutableException) { //handle process exception } catch (InvalidArgumentException) { //handle pipe exception }
API
API is available at bazzline.net.
Development notes
After code changes, please run:
composer check ./vendor/bin/rector process ./vendor/bin/php-cs-fixer fix example ./vendor/bin/php-cs-fixer fix source ./vendor/bin/php-cs-fixer fix test
Links
Thanks to
Other pipe implementations
Final Words
Star it if you like it :-). Add issues if you need it. Pull patches if you enjoy it. Write a blog entry if you use it. Donate something if you love it :-].