Update Composer, update everything
This commit is contained in:
Oliver Davies
parent
ea3e94409f
commit
dda5c284b6
19527 changed files with 1135420 additions and 351004 deletions
15
vendor/consolidation/robo/.editorconfig
vendored
Normal file
15
vendor/consolidation/robo/.editorconfig
vendored
Normal file
|
|
@ -0,0 +1,15 @@
|
|||
# This file is for unifying the coding style for different editors and IDEs
|
||||
# editorconfig.org
|
||||
|
||||
root = true
|
||||
|
||||
[*]
|
||||
end_of_line = lf
|
||||
charset = utf-8
|
||||
trim_trailing_whitespace = true
|
||||
insert_final_newline = true
|
||||
|
||||
[**.php]
|
||||
indent_style = space
|
||||
indent_size = 4
|
||||
|
||||
57
vendor/consolidation/robo/.scenarios.lock/install
vendored
Executable file
57
vendor/consolidation/robo/.scenarios.lock/install
vendored
Executable file
|
|
@ -0,0 +1,57 @@
|
|||
#!/bin/bash
|
||||
|
||||
SCENARIO=$1
|
||||
DEPENDENCIES=${2-install}
|
||||
|
||||
# Convert the aliases 'highest', 'lowest' and 'lock' to
|
||||
# the corresponding composer command to run.
|
||||
case $DEPENDENCIES in
|
||||
highest)
|
||||
DEPENDENCIES=update
|
||||
;;
|
||||
lowest)
|
||||
DEPENDENCIES='update --prefer-lowest'
|
||||
;;
|
||||
lock|default|"")
|
||||
DEPENDENCIES=install
|
||||
;;
|
||||
esac
|
||||
|
||||
original_name=scenarios
|
||||
recommended_name=".scenarios.lock"
|
||||
|
||||
base="$original_name"
|
||||
if [ -d "$recommended_name" ] ; then
|
||||
base="$recommended_name"
|
||||
fi
|
||||
|
||||
# If scenario is not specified, install the lockfile at
|
||||
# the root of the project.
|
||||
dir="$base/${SCENARIO}"
|
||||
if [ -z "$SCENARIO" ] || [ "$SCENARIO" == "default" ] ; then
|
||||
SCENARIO=default
|
||||
dir=.
|
||||
fi
|
||||
|
||||
# Test to make sure that the selected scenario exists.
|
||||
if [ ! -d "$dir" ] ; then
|
||||
echo "Requested scenario '${SCENARIO}' does not exist."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo
|
||||
echo "::"
|
||||
echo ":: Switch to ${SCENARIO} scenario"
|
||||
echo "::"
|
||||
echo
|
||||
|
||||
set -ex
|
||||
|
||||
composer -n validate --working-dir=$dir --no-check-all --ansi
|
||||
composer -n --working-dir=$dir ${DEPENDENCIES} --prefer-dist --no-scripts
|
||||
|
||||
# If called from a CI context, print out some extra information about
|
||||
# what we just installed.
|
||||
if [[ -n "$CI" ]] ; then
|
||||
composer -n --working-dir=$dir info
|
||||
fi
|
||||
2
vendor/consolidation/robo/.scenarios.lock/symfony2/.gitignore
vendored
Normal file
2
vendor/consolidation/robo/.scenarios.lock/symfony2/.gitignore
vendored
Normal file
|
|
@ -0,0 +1,2 @@
|
|||
vendor
|
||||
composer.lock
|
||||
92
vendor/consolidation/robo/.scenarios.lock/symfony2/composer.json
vendored
Normal file
92
vendor/consolidation/robo/.scenarios.lock/symfony2/composer.json
vendored
Normal file
|
|
@ -0,0 +1,92 @@
|
|||
{
|
||||
"name": "consolidation/robo",
|
||||
"description": "Modern task runner",
|
||||
"license": "MIT",
|
||||
"authors": [
|
||||
{
|
||||
"name": "Davert",
|
||||
"email": "davert.php@resend.cc"
|
||||
}
|
||||
],
|
||||
"autoload": {
|
||||
"psr-4": {
|
||||
"Robo\\": "../../src"
|
||||
}
|
||||
},
|
||||
"autoload-dev": {
|
||||
"psr-4": {
|
||||
"Robo\\": "../../tests/src",
|
||||
"RoboExample\\": "../../examples/src"
|
||||
}
|
||||
},
|
||||
"bin": [
|
||||
"robo"
|
||||
],
|
||||
"require": {
|
||||
"symfony/console": "^2.8",
|
||||
"php": ">=5.5.0",
|
||||
"league/container": "^2.2",
|
||||
"consolidation/log": "~1",
|
||||
"consolidation/config": "^1.0.10",
|
||||
"consolidation/annotated-command": "^2.8.2",
|
||||
"consolidation/output-formatters": "^3.1.13",
|
||||
"consolidation/self-update": "^1",
|
||||
"grasmash/yaml-expander": "^1.3",
|
||||
"symfony/finder": "^2.5|^3|^4",
|
||||
"symfony/process": "^2.5|^3|^4",
|
||||
"symfony/filesystem": "^2.5|^3|^4",
|
||||
"symfony/event-dispatcher": "^2.5|^3|^4"
|
||||
},
|
||||
"require-dev": {
|
||||
"g1a/composer-test-scenarios": "^3",
|
||||
"patchwork/jsqueeze": "~2",
|
||||
"natxet/CssMin": "3.0.4",
|
||||
"pear/archive_tar": "^1.4.2",
|
||||
"codeception/base": "^2.3.7",
|
||||
"codeception/verify": "^0.3.2",
|
||||
"codeception/aspect-mock": "^1|^2.1.1",
|
||||
"goaop/parser-reflection": "^1.1.0",
|
||||
"nikic/php-parser": "^3.1.5",
|
||||
"php-coveralls/php-coveralls": "^1",
|
||||
"phpunit/php-code-coverage": "~2|~4",
|
||||
"squizlabs/php_codesniffer": "^2.8"
|
||||
},
|
||||
"scripts": {
|
||||
"cs": "./robo sniff",
|
||||
"unit": "./robo test --coverage",
|
||||
"lint": [
|
||||
"find src -name '*.php' -print0 | xargs -0 -n1 php -l",
|
||||
"find tests/src -name '*.php' -print0 | xargs -0 -n1 php -l"
|
||||
],
|
||||
"test": [
|
||||
"@lint",
|
||||
"@unit",
|
||||
"@cs"
|
||||
],
|
||||
"pre-install-cmd": [
|
||||
"Robo\\composer\\ScriptHandler::checkDependencies"
|
||||
]
|
||||
},
|
||||
"config": {
|
||||
"platform": {
|
||||
"php": "5.5.9"
|
||||
},
|
||||
"optimize-autoloader": true,
|
||||
"sort-packages": true,
|
||||
"vendor-dir": "../../vendor"
|
||||
},
|
||||
"extra": {
|
||||
"branch-alias": {
|
||||
"dev-master": "1.x-dev"
|
||||
}
|
||||
},
|
||||
"suggest": {
|
||||
"pear/archive_tar": "Allows tar archives to be created and extracted in taskPack and taskExtract, respectively.",
|
||||
"henrikbjorn/lurker": "For monitoring filesystem changes in taskWatch",
|
||||
"patchwork/jsqueeze": "For minifying JS files in taskMinify",
|
||||
"natxet/CssMin": "For minifying CSS files in taskMinify"
|
||||
},
|
||||
"replace": {
|
||||
"codegyre/robo": "< 1.0"
|
||||
}
|
||||
}
|
||||
1
vendor/consolidation/robo/.scenarios.lock/symfony4/.gitignore
vendored
Normal file
1
vendor/consolidation/robo/.scenarios.lock/symfony4/.gitignore
vendored
Normal file
|
|
@ -0,0 +1 @@
|
|||
vendor
|
||||
93
vendor/consolidation/robo/.scenarios.lock/symfony4/composer.json
vendored
Normal file
93
vendor/consolidation/robo/.scenarios.lock/symfony4/composer.json
vendored
Normal file
|
|
@ -0,0 +1,93 @@
|
|||
{
|
||||
"name": "consolidation/robo",
|
||||
"description": "Modern task runner",
|
||||
"license": "MIT",
|
||||
"authors": [
|
||||
{
|
||||
"name": "Davert",
|
||||
"email": "davert.php@resend.cc"
|
||||
}
|
||||
],
|
||||
"autoload": {
|
||||
"psr-4": {
|
||||
"Robo\\": "../../src"
|
||||
}
|
||||
},
|
||||
"autoload-dev": {
|
||||
"psr-4": {
|
||||
"Robo\\": "../../tests/src",
|
||||
"RoboExample\\": "../../examples/src"
|
||||
}
|
||||
},
|
||||
"bin": [
|
||||
"robo"
|
||||
],
|
||||
"require": {
|
||||
"symfony/console": "^4",
|
||||
"php": ">=5.5.0",
|
||||
"league/container": "^2.2",
|
||||
"consolidation/log": "~1",
|
||||
"consolidation/config": "^1.0.10",
|
||||
"consolidation/annotated-command": "^2.8.2",
|
||||
"consolidation/output-formatters": "^3.1.13",
|
||||
"consolidation/self-update": "^1",
|
||||
"grasmash/yaml-expander": "^1.3",
|
||||
"symfony/finder": "^2.5|^3|^4",
|
||||
"symfony/process": "^2.5|^3|^4",
|
||||
"symfony/filesystem": "^2.5|^3|^4",
|
||||
"symfony/event-dispatcher": "^2.5|^3|^4"
|
||||
},
|
||||
"require-dev": {
|
||||
"g1a/composer-test-scenarios": "^3",
|
||||
"patchwork/jsqueeze": "~2",
|
||||
"natxet/CssMin": "3.0.4",
|
||||
"pear/archive_tar": "^1.4.2",
|
||||
"codeception/base": "^2.3.7",
|
||||
"goaop/framework": "~2.1.2",
|
||||
"codeception/verify": "^0.3.2",
|
||||
"codeception/aspect-mock": "^1|^2.1.1",
|
||||
"goaop/parser-reflection": "^1.1.0",
|
||||
"nikic/php-parser": "^3.1.5",
|
||||
"php-coveralls/php-coveralls": "^1",
|
||||
"phpunit/php-code-coverage": "~2|~4",
|
||||
"squizlabs/php_codesniffer": "^2.8"
|
||||
},
|
||||
"scripts": {
|
||||
"cs": "./robo sniff",
|
||||
"unit": "./robo test --coverage",
|
||||
"lint": [
|
||||
"find src -name '*.php' -print0 | xargs -0 -n1 php -l",
|
||||
"find tests/src -name '*.php' -print0 | xargs -0 -n1 php -l"
|
||||
],
|
||||
"test": [
|
||||
"@lint",
|
||||
"@unit",
|
||||
"@cs"
|
||||
],
|
||||
"pre-install-cmd": [
|
||||
"Robo\\composer\\ScriptHandler::checkDependencies"
|
||||
]
|
||||
},
|
||||
"config": {
|
||||
"platform": {
|
||||
"php": "7.1.3"
|
||||
},
|
||||
"optimize-autoloader": true,
|
||||
"sort-packages": true,
|
||||
"vendor-dir": "../../vendor"
|
||||
},
|
||||
"extra": {
|
||||
"branch-alias": {
|
||||
"dev-master": "1.x-dev"
|
||||
}
|
||||
},
|
||||
"suggest": {
|
||||
"pear/archive_tar": "Allows tar archives to be created and extracted in taskPack and taskExtract, respectively.",
|
||||
"henrikbjorn/lurker": "For monitoring filesystem changes in taskWatch",
|
||||
"patchwork/jsqueeze": "For minifying JS files in taskMinify",
|
||||
"natxet/CssMin": "For minifying CSS files in taskMinify"
|
||||
},
|
||||
"replace": {
|
||||
"codegyre/robo": "< 1.0"
|
||||
}
|
||||
}
|
||||
3986
vendor/consolidation/robo/.scenarios.lock/symfony4/composer.lock
generated
vendored
Normal file
3986
vendor/consolidation/robo/.scenarios.lock/symfony4/composer.lock
generated
vendored
Normal file
File diff suppressed because it is too large
Load diff
352
vendor/consolidation/robo/CHANGELOG.md
vendored
Normal file
352
vendor/consolidation/robo/CHANGELOG.md
vendored
Normal file
|
|
@ -0,0 +1,352 @@
|
|||
# Changelog
|
||||
|
||||
### 1.3.2 11/21/2018
|
||||
|
||||
* Update to Composer Test Scenarios 3 (#803)
|
||||
* Support Windows line endings in ".semver" file by Cédric Belin (#788)
|
||||
* Ensure that environment variables are preserved in Exec by James Sansbury (#769)
|
||||
* Correct Doxygen in \Robo\Task\Composer\loadTasks. (#772)
|
||||
|
||||
### 1.3.1 8/17/2018
|
||||
|
||||
* Move self:update command to consolidation/self-update project.
|
||||
* Fix overzealous shebang function (#759)
|
||||
* Actualize RoboFile of Codeception project link url in RADME.php by Valerij Ivashchenko (#756)
|
||||
* Workaround - Move g1a/composer-test-scenarios from require-dev to require.
|
||||
* Add --no-progress --no-suggest back in.
|
||||
* Tell dependencies.io to use --no-dev when determining if a PR should be made.
|
||||
* Omit --no-dev when the PR is actually being composed.
|
||||
* Add `Events` as third parameter in watch function (#751)
|
||||
|
||||
### 1.3.0 5/26/2018
|
||||
|
||||
* Add EnvConfig to Robo: set configuration values via environment variables (#737)
|
||||
|
||||
### 1.2.4 5/25/2018
|
||||
|
||||
* Update 'Robo as a Framework' documentation to recommend https://github.com/g1a/starter
|
||||
* Allow CommandStack to exec other tasks by Scott Falkingham (#726)
|
||||
* Fix double escape when specifying a remoteShell with rsync by Rob Peck (#715)
|
||||
|
||||
### 1.2.3 4/5/2018
|
||||
|
||||
* Hide progress indicator prior to 'exec'. (#707)
|
||||
* Dependencies.io config for version 2 preview by Dave Gaeddert (#699)
|
||||
* Fix path to test script in try:para
|
||||
* Correctly parameterize the app name in the self:update command help text.
|
||||
* Refuse to start 'release' script if phar.readonly is set.
|
||||
|
||||
### 1.2.2 2/27/2018
|
||||
|
||||
* Experimental robo plugin mechanism (backwards compatibility not yet guarenteed)
|
||||
* Allow traits to be documented
|
||||
* Do not export scenarios directory
|
||||
* *Breaking* Typo in `\Robo\Runner:errorCondtion()` fixed as `\Robo\Runner:errorCondition()`.
|
||||
|
||||
### 1.2.1 12/28/2017
|
||||
|
||||
* Fixes to tests / build only.
|
||||
|
||||
### 1.2.0 12/12/2017
|
||||
|
||||
* Support Symfony 4 Components (#651)
|
||||
* Test multiple composer dependency permutations with https://github.com/greg-1-anderson/composer-test-scenarios
|
||||
|
||||
### 1.1.5 10/25/2017
|
||||
|
||||
* Load option default values from $input for all options defined in the Application's input definition (#642)
|
||||
* BUGFIX: Store global options in 'options' namespace rather than at the top level of config.
|
||||
|
||||
### 1.1.4 10/16/2017
|
||||
|
||||
* Update order of command event hooks so that the option settings are injected prior to configuration being injected, so that dynamic options are available for config injection. (#636)
|
||||
* Add shallow clone method to GithubStack task. by Stefan Lange (#633)
|
||||
* Make Changelog task more flexible. by Matthew Grasmick(#631)
|
||||
* Adding accessToken() to GitHub task. by Matthew Grasmick (#630)
|
||||
|
||||
### 1.1.3 09/23/2017
|
||||
|
||||
* Add self:update command to update Robo phar distributions to the latest available version on GitHub. by Alexander Menk
|
||||
* Fix Robo\Task\Docker\Base to implement CommandInterface. by Alexei Gorobet (#625)
|
||||
* Add overwrite argument to Robo\Task\Filesystem\loadShortcuts.php::_rename by Alexei Gorobets (#624)
|
||||
* Add failGroup() method for Codeception run command. by Max Gorovenko (#622)
|
||||
* Set up composer-lock-updater on cron. (#618)
|
||||
* Fix robo.yml loader by exporting processor instead of loader. By thomscode (#612)
|
||||
|
||||
### 1.1.2 07/28/2017
|
||||
|
||||
* Inject option default values in help (#607)
|
||||
* Add noRebuild() method for Codeception run command. By Max Gorovenko (#603)
|
||||
|
||||
### 1.1.1 07/07/2017
|
||||
|
||||
* Add an option to wait an interval of time between parallel processes. By Gemma Pou #601
|
||||
* Do not print dire messages about Robo bootstrap problems when a valid command (e.g. help, list, init, --version) runs. #502
|
||||
|
||||
### 1.1.0 06/29/2017
|
||||
|
||||
* Configuration for multiple commands or multiple tasks may now be shared by attaching the configuration values to the task namespace or the command group. #597
|
||||
* *Breaking* Task configuration taken from property `task.PARTIAL_NAMESPACE.CLASSNAME.settings` instead of `task.CLASSNAME.settings`. Breaks backwards compatibility only with experimental configuration features introduced in version 1.0.6. Config is now stable, as of this release; there will be no more breaking config changes until Robo 2.0. #596
|
||||
|
||||
### 1.0.8 06/02/2017
|
||||
|
||||
* Fix regression in 1.0.7: Allow tasks to return results of types other than \Robo\Result. #585
|
||||
* Allow Copydir exclude method to specify subfolders by Alex Skrypnyk #590
|
||||
* Add composer init task, and general rounding out of composer tasks. #586
|
||||
* Enhance SemVer task so that it can be used with files or strings. #589
|
||||
|
||||
#### 1.0.7 05/30/2017
|
||||
|
||||
* Add a state system for collections to allow tasks to pass state to later tasks.
|
||||
* Ensure that task results are returned when in stopOnFail() mode.
|
||||
* Make rawArg() and detectInteractive chainable. By Matthew Grasmick #553 #558
|
||||
* [CopyDir] Use Symfony Filesystem. By malikkotob #555
|
||||
* [Composer] Implement CommandInterface. By Ivan Borzenkov #561
|
||||
|
||||
#### 1.0.6 03/31/2017
|
||||
|
||||
* Add configuration features to inject values into commandline option and task setter methods. Experimental; incompatible changes may be introduced prior to the stable release of configuration in version 1.1.0.
|
||||
|
||||
#### 1.0.5 11/23/2016
|
||||
|
||||
* Incorporate word-wrapping from output-formatters 3.1.5
|
||||
* Incorporate custom event handlers from annotated-command 2.2.0
|
||||
|
||||
#### 1.0.4 11/15/2016
|
||||
|
||||
* Updated to latest changes in `master` branch. Phar and tag issues.
|
||||
|
||||
#### 1.0.0 10/10/2016
|
||||
|
||||
* [Collection] Add tasks to a collection, and implement them as a group with rollback
|
||||
* Tasks may be added to a collection via `$collection->add($task);`
|
||||
* `$collection->run();` runs all tasks in the collection
|
||||
* `$collection->addCode(function () { ... } );` to add arbitrary code to a collection
|
||||
* `$collection->progressMessage(...);` will log a message
|
||||
* `$collection->rollback($task);` and `$collection->rollbackCode($callable);` add a rollback function to clean up after a failed task
|
||||
* `$collection->completion($task);` and `$collection->completionCode($callable);` add a function that is called once the collection completes or rolls back.
|
||||
* `$collection->before();` and `$collection->after();` can be used to add a task or function that runs before or after (respectively) the specified named task. To use this feature, tasks must be given names via an optional `$taskName` parameter when they are added.
|
||||
* Collections may be added to collections, if desired.
|
||||
* [CollectionBuilder] Create tasks and add them to a collection in a single operation.
|
||||
* `$this->collectionBuilder()->taskExec('pwd')->taskExec('ls')->run()`
|
||||
* Add output formatters
|
||||
* If a Robo command returns a string, or a `Result` object with a `$message`, then it will be printed
|
||||
* Commands may be annotated to describe output formats that may be used
|
||||
* Structured arrays returned from function results may be converted into different formats, such as a table, yml, json, etc.
|
||||
* Tasks must `use TaskIO` for output methods. It is no longer possible to `use IO` from a task. For direct access use `Robo::output()` (not recommended).
|
||||
* Use league/container to do Dependency Injection
|
||||
* *Breaking* Tasks' loadTasks traits must use `$this->task(TaskClass::class);` instead of `new TaskClass();`
|
||||
* *Breaking* Tasks that use other tasks must use `$this->collectionBuilder()->taskName();` instead of `new TaskClass();` when creating task objects to call. Implement `Robo\Contract\BuilderAwareInterface` and use `Robo\Contract\BuilderAwareTrait` to add the `collectionBuilder()` method to your task class.
|
||||
* *Breaking* The `arg()`, `args()` and `option()` methods in CommandArguments now escape the values passed in to them. There is now a `rawArg()` method if you need to add just one argument that has already been escaped.
|
||||
* *Breaking* taskWrite is now called taskWriteToFile
|
||||
* [Extract] task added
|
||||
* [Pack] task added
|
||||
* [TmpDir], [WorkDir] and [TmpFile] tasks added
|
||||
* Support Robo scripts that allows scripts starting with `#!/usr/bin/env robo` to define multiple robo commands. Use `#!/usr/bin/env robo run` to define a single robo command implemented by the `run()` method.
|
||||
* Provide ProgresIndicatorAwareInterface and ProgressIndicatorAwareTrait that make it easy to add progress indicators to tasks
|
||||
* Add --simulate mode that causes tasks to print what they would have done, but make no changes
|
||||
* Add `robo generate:task` code-generator to make new stack-based task wrappers around existing classes
|
||||
* Add `robo sniff` by @dustinleblanc. Runs the PHP code sniffer followed by the code beautifier, if needed.
|
||||
* Implement ArrayInterface for Result class, so result data may be accessed like an array
|
||||
* Defer execution of operations in taskWriteToFile until the run() method
|
||||
* Add Write::textIfMatch() for taskWriteToFile
|
||||
* ResourceExistenceChecker used for error checking in DeleteDir, CopyDir, CleanDir and Concat tasks by @burzum
|
||||
* Provide ResultData base class for Result; ResultData may be used in instances where a specific `$task` instance is not available (e.g. in a Robo command)
|
||||
* ArgvInput now available via $this->getInput() in RoboFile by Thomas Spigel
|
||||
* Add optional message to git tag task by Tim Tegeler
|
||||
* Rename 'FileSystem' to 'Filesystem' wherever it occurs.
|
||||
* Current directory is changed with `chdir` only if specified via the `--load-from` option (RC2)
|
||||
|
||||
#### 0.6.0 10/30/2015
|
||||
|
||||
* Added `--load-from` option to make Robo start RoboFiles from other directories. Use it like `robo --load-from /path/to/where/RobFile/located`.
|
||||
* Robo will not ask to create RoboFile if it does not exist, `init` command should be used.
|
||||
* [ImageMinify] task added by @gabor-udvari
|
||||
* [OpenBrowser] task added by @oscarotero
|
||||
* [FlattenDir] task added by @gabor-udvari
|
||||
* Robo Runner can easily extended for custom runner by passing RoboClass and RoboFile parameters to constructor. By @rdeutz See #232
|
||||
|
||||
#### 0.5.4 08/31/2015
|
||||
|
||||
* [WriteToFile] Fixed by @gabor-udvari: always writing to file regardless whether any changes were made or not. This can bring the taskrunner into an inifinite loop if a replaced file is being watched.
|
||||
* [Scss] task added, requires `leafo/scssphp` library to compile by @gabor-udvari
|
||||
* [PhpSpec] TAP formatter added by @orls
|
||||
* [Less] Added ability to set import dir for less compilers by @MAXakaWIZARD
|
||||
* [Less] fixed passing closure as compiler by @pr0nbaer
|
||||
* [Sass] task added by *2015-08-31*
|
||||
|
||||
#### 0.5.3 07/15/2015
|
||||
|
||||
* [Rsync] Ability to use remote shell with identity file by @Mihailoff
|
||||
* [Less] Task added by @burzum
|
||||
* [PHPUnit] allow to test specific files with `files` parameter by @burzum.
|
||||
* [GitStack] `tag` added by @SebSept
|
||||
* [Concat] Fixing concat, it breaks some files if there is no new line. @burzum *2015-03-03-13*
|
||||
* [Minify] BC fix to support Jsqueeze 1.x and 2.x @burzum *2015-03-12*
|
||||
* [PHPUnit] Replace log-xml with log-junit @vkunz *2015-03-06*
|
||||
* [Minify] Making it possible to pass options to the JS minification @burzum *2015-03-05*
|
||||
* [CopyDir] Create destination recursively @boedah *2015-02-28*
|
||||
|
||||
#### 0.5.2 02/24/2015
|
||||
|
||||
* [Phar] do not compress phar if more than 1000 files included (causes internal PHP error) *2015-02-24*
|
||||
* _copyDir and _mirrorDir shortcuts fixed by @boedah *2015-02-24*
|
||||
* [File\Write] methods replace() and regexReplace() added by @asterixcapri *2015-02-24*
|
||||
* [Codecept] Allow to set custom name of coverage file raw name by @raistlin *2015-02-24*
|
||||
* [Ssh] Added property `remoteDir` by @boedah *2015-02-24*
|
||||
* [PhpServer] fixed passing arguments to server *2015-02-24*
|
||||
|
||||
|
||||
#### 0.5.1 01/27/2015
|
||||
|
||||
* [Exec] fixed execution of background jobs, processes persist till the end of PHP script *2015-01-27*
|
||||
* [Ssh] Fixed SSH task by @Butochnikov *2015-01-27*
|
||||
* [CopyDir] fixed shortcut usage by @boedah *2015-01-27*
|
||||
* Added default value options for Configuration trait by @TamasBarta *2015-01-27*
|
||||
|
||||
#### 0.5.0 01/22/2015
|
||||
|
||||
Refactored core
|
||||
|
||||
* All traits moved to `Robo\Common` namespace
|
||||
* Interfaces moved to `Robo\Contract` namespace
|
||||
* All task extend `Robo\Task\BaseTask` to use common IO.
|
||||
* All classes follow PSR-4 standard
|
||||
* Tasks are loaded into RoboFile with `loadTasks` trait
|
||||
* One-line tasks are available as shortcuts loaded by `loadShortucts` and used like `$this->_exec('ls')`
|
||||
* Robo runner is less coupled. Output can be set by `\Robo\Config::setOutput`, `RoboFile` can be changed to any provided class.
|
||||
* Tasks can be used outside of Robo runner (inside a project)
|
||||
* Timer for long-running tasks added
|
||||
* Tasks can be globally configured (WIP) via `Robo\Config` class.
|
||||
* Updated to Symfony >= 2.5
|
||||
* IO methods added `askHidden`, `askDefault`, `confirm`
|
||||
* TaskIO methods added `printTaskError`, `printTaskSuccess` with different formatting.
|
||||
* [Docker] Tasks added
|
||||
* [Gulp] Task added by @schorsch3000
|
||||
|
||||
#### 0.4.7 12/26/2014
|
||||
|
||||
* [Minify] Task added by @Rarst. Requires additional dependencies installed *2014-12-26*
|
||||
* [Help command is populated from annotation](https://github.com/consolidation-org/Robo/pull/71) by @jonsa *2014-12-26*
|
||||
* Allow empty values as defaults to optional options by @jonsa *2014-12-26*
|
||||
* `PHP_WINDOWS_VERSION_BUILD` constant is used to check for Windows in tasks by @boedah *2014-12-26*
|
||||
* [Copy][EmptyDir] Fixed infinite loop by @boedah *2014-12-26*
|
||||
* [ApiGen] Task added by @drobert *2014-12-26*
|
||||
* [FileSystem] Equalized `copy` and `chmod` argument to defaults by @Rarst (BC break) *2014-12-26*
|
||||
* [FileSystem] Added missing umask argument to chmod() method of FileSystemStack by @Rarst
|
||||
* [SemVer] Fixed file read and exit code
|
||||
* [Codeception] fixed codeception coverageHtml option by @gunfrank *2014-12-26*
|
||||
* [phpspec] Task added by @SebSept *2014-12-26*
|
||||
* Shortcut options: if option name is like foo|f, assign f as shortcut by @jschnare *2014-12-26*
|
||||
* [Rsync] Shell escape rsync exclude pattern by @boedah. Fixes #77 (BC break) *2014-12-26*
|
||||
* [Npm] Task added by @AAlakkad *2014-12-26*
|
||||
|
||||
#### 0.4.6 10/17/2014
|
||||
|
||||
* [Exec] Output from buffer is not spoiled by special chars *2014-10-17*
|
||||
* [PHPUnit] detect PHPUnit on Windows or when is globally installed with Composer *2014-10-17*
|
||||
* Output: added methods askDefault and confirm by @bkawakami *2014-10-17*
|
||||
* [Svn] Task added by @anvi *2014-08-13*
|
||||
* [Stack] added dir and printed options *2014-08-12*
|
||||
* [ExecTask] now uses Executable trait with printed, dir, arg, option methods added *2014-08-12*
|
||||
|
||||
|
||||
#### 0.4.5 08/05/2014
|
||||
|
||||
* [Watch] bugfix: Watch only tracks last file if given array of files #46 *2014-08-05*
|
||||
* All executable tasks can configure working directory with `dir` option
|
||||
* If no value for an option is provided, assume it's a VALUE_NONE option. #47 by @pfaocle
|
||||
* [Changelog] changed style *2014-06-27*
|
||||
* [GenMarkDown] fixed formatting annotations *2014-06-27*
|
||||
|
||||
#### 0.4.4 06/05/2014
|
||||
|
||||
* Output can be disabled in all executable tasks by ->printed(false)
|
||||
* disabled timeouts by default in ParallelExec
|
||||
* better descriptions for Result output
|
||||
* changed ParallelTask to display failed process in list
|
||||
* Changed Output to be stored globally in Robo\Runner class
|
||||
* Added **SshTask** by @boedah
|
||||
* Added **RsyncTask** by @boedah
|
||||
* false option added to proceess* callbacks in GenMarkDownTask to skip processing
|
||||
|
||||
|
||||
#### 0.4.3 05/21/2014
|
||||
|
||||
* added `SemVer` task by **@jadb**
|
||||
* `yell` output method added
|
||||
* task `FileSystemStack` added
|
||||
* `MirrorDirTask` added by **@devster**
|
||||
* switched to Symfony Filesystem component
|
||||
* options can be used to commands
|
||||
* array arguments can be used in commands
|
||||
|
||||
#### 0.4.2 05/09/2014
|
||||
|
||||
* ask can now hide answers
|
||||
* Trait Executable added to provide standard way for passing arguments and options
|
||||
* added ComposerDumpAutoload task by **@pmcjury**
|
||||
* added FileSystem task by **@jadb**
|
||||
* added CommonStack metatsk to have similar interface for all stacked tasks by **@jadb**
|
||||
* arguments and options can be passed into variable and used in exec task
|
||||
* passing options into commands
|
||||
|
||||
|
||||
#### 0.4.1 05/05/2014
|
||||
|
||||
* [BC] `taskGit` task renamed to `taskGitStack` for compatibility
|
||||
* unit and functional tests added
|
||||
* all command tasks now use Symfony\Process to execute them
|
||||
* enabled Bower and Concat tasks
|
||||
* added `printed` param to Exec task
|
||||
* codeception `suite` method now returns `$this`
|
||||
* timeout options added to Exec task
|
||||
|
||||
|
||||
#### 0.4.0 04/27/2014
|
||||
|
||||
* Codeception task added
|
||||
* PHPUnit task improved
|
||||
* Bower task added by @jadb
|
||||
* ParallelExec task added
|
||||
* Symfony Process component used for execution
|
||||
* Task descriptions taken from first line of annotations
|
||||
* `CommandInterface` added to use tasks as parameters
|
||||
|
||||
#### 0.3.3 02/25/2014
|
||||
|
||||
* PHPUnit basic task
|
||||
* fixed doc generation
|
||||
|
||||
#### 0.3.5 02/21/2014
|
||||
|
||||
* changed generated init template
|
||||
|
||||
|
||||
#### 0.3.4 02/21/2014
|
||||
|
||||
* [PackPhar] ->executable command will remove hashbang when generated stub file
|
||||
* [Git][Exec] stopOnFail option for Git and Exec stack
|
||||
* [ExecStack] shortcut for executing bash commands in stack
|
||||
|
||||
#### 0.3.2 02/20/2014
|
||||
|
||||
* release process now includes phar
|
||||
* phar executable method added
|
||||
* git checkout added
|
||||
* phar pack created
|
||||
|
||||
|
||||
#### 0.3.0 02/11/2014
|
||||
|
||||
* Dynamic configuration via magic methods
|
||||
* added WriteToFile task
|
||||
* Result class for managing exit codes and error messages
|
||||
|
||||
#### 0.2.0 01/29/2014
|
||||
|
||||
* Merged Tasks and Traits to same file
|
||||
* Added Watcher task
|
||||
* Added GitHubRelease task
|
||||
* Added Changelog task
|
||||
* Added ReplaceInFile task
|
||||
15
vendor/consolidation/robo/CONTRIBUTING.md
vendored
Normal file
15
vendor/consolidation/robo/CONTRIBUTING.md
vendored
Normal file
|
|
@ -0,0 +1,15 @@
|
|||
# Contributing to Robo
|
||||
|
||||
Thank you for your interest in contributing to Robo! Here are some of the guidelines you should follow to make the most of your efforts:
|
||||
|
||||
## Code Style Guidelines
|
||||
|
||||
Robo adheres to the [PSR-2 Coding Style Guide](http://www.php-fig.org/psr/psr-2/) for PHP code. An `.editorconfig` file is included with the repository to help you get up and running quickly. Most modern editors support this standard, but if yours does not or you would like to configure your editor manually, follow the guidelines in the document linked above.
|
||||
|
||||
You can run the PHP Codesniffer on your work using a convenient command built into this project's own `RoboFile.php`:
|
||||
```
|
||||
robo sniff src/Foo.php --autofix
|
||||
```
|
||||
The above will run the PHP Codesniffer on the `src/Foo.php` file and automatically correct variances from the PSR-2 standard. Please ensure all contributions are compliant _before_ submitting a pull request.
|
||||
|
||||
|
||||
44
vendor/consolidation/robo/LICENSE
vendored
Normal file
44
vendor/consolidation/robo/LICENSE
vendored
Normal file
|
|
@ -0,0 +1,44 @@
|
|||
The MIT License (MIT)
|
||||
|
||||
Copyright (c) 2014-2018 Codegyre Developers Team, Consolidation Team
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
this software and associated documentation files (the "Software"), to deal in
|
||||
the Software without restriction, including without limitation the rights to
|
||||
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
|
||||
DEPENDENCY LICENSES:
|
||||
|
||||
Name Version License
|
||||
consolidation/annotated-command 2.10.0 MIT
|
||||
consolidation/config 1.1.1 MIT
|
||||
consolidation/log 1.0.6 MIT
|
||||
consolidation/output-formatters 3.4.0 MIT
|
||||
consolidation/self-update 1.1.5 MIT
|
||||
container-interop/container-interop 1.2.0 MIT
|
||||
dflydev/dot-access-data v1.1.0 MIT
|
||||
grasmash/expander 1.0.0 MIT
|
||||
grasmash/yaml-expander 1.4.0 MIT
|
||||
league/container 2.4.1 MIT
|
||||
psr/container 1.0.0 MIT
|
||||
psr/log 1.1.0 MIT
|
||||
symfony/console v4.1.7 MIT
|
||||
symfony/event-dispatcher v4.1.7 MIT
|
||||
symfony/filesystem v4.1.7 MIT
|
||||
symfony/finder v3.4.18 MIT
|
||||
symfony/polyfill-ctype v1.10.0 MIT
|
||||
symfony/polyfill-mbstring v1.10.0 MIT
|
||||
symfony/process v4.1.7 MIT
|
||||
symfony/yaml v4.1.7 MIT
|
||||
180
vendor/consolidation/robo/README.md
vendored
Normal file
180
vendor/consolidation/robo/README.md
vendored
Normal file
|
|
@ -0,0 +1,180 @@
|
|||
# RoboTask
|
||||
|
||||
**Modern and simple PHP task runner** inspired by Gulp and Rake aimed to automate common tasks:
|
||||
|
||||
[](https://gitter.im/consolidation-org/Robo?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
||||
[](https://packagist.org/packages/consolidation/robo)
|
||||
[](https://packagist.org/packages/consolidation/robo)
|
||||
[](https://packagist.org/packages/consolidation/robo)
|
||||
[](https://travis-ci.org/consolidation/Robo)
|
||||
[](https://www.versioneye.com/user/projects/57c4a6fe968d64004d97620a?child=57c4a6fe968d64004d97620a#tab-licenses)
|
||||
|
||||
[](https://travis-ci.org/consolidation/Robo)
|
||||
[](https://ci.appveyor.com/project/greg-1-anderson/robo)
|
||||
[](https://scrutinizer-ci.com/g/consolidation/Robo/?branch=master)
|
||||
[](https://www.versioneye.com/user/projects/57c4a6fe968d64004d97620a)
|
||||
|
||||
* writing cross-platform scripts
|
||||
* processing assets (less, sass, minification)
|
||||
* running tests
|
||||
* executing daemons (and workers)
|
||||
* watching filesystem changes
|
||||
* deployment with sftp/ssh/docker
|
||||
|
||||
## Installing
|
||||
|
||||
### Phar
|
||||
|
||||
[Download robo.phar >](http://robo.li/robo.phar)
|
||||
|
||||
```
|
||||
wget http://robo.li/robo.phar
|
||||
```
|
||||
|
||||
To install globally put `robo.phar` in `/usr/bin`. (`/usr/local/bin/` in OSX 10.11+)
|
||||
|
||||
```
|
||||
chmod +x robo.phar && sudo mv robo.phar /usr/bin/robo
|
||||
```
|
||||
|
||||
OSX 10.11+
|
||||
```
|
||||
chmod +x robo.phar && sudo mv robo.phar /usr/local/bin/robo
|
||||
```
|
||||
|
||||
Now you can use it just like `robo`.
|
||||
|
||||
### Composer
|
||||
|
||||
* Run `composer require consolidation/robo:~1`
|
||||
* Use `vendor/bin/robo` to execute Robo tasks.
|
||||
|
||||
## Usage
|
||||
|
||||
All tasks are defined as **public methods** in `RoboFile.php`. It can be created by running `robo`.
|
||||
All protected methods in traits that start with `task` prefix are tasks and can be configured and executed in your tasks.
|
||||
|
||||
## Examples
|
||||
|
||||
The best way to learn Robo by example is to take a look into [its own RoboFile](https://github.com/consolidation-org/Robo/blob/master/RoboFile.php)
|
||||
or [RoboFile of Codeception project](https://github.com/Codeception/Codeception/blob/2.4/RoboFile.php). There are also some basic example commands in examples/RoboFile.php.
|
||||
|
||||
Here are some snippets from them:
|
||||
|
||||
---
|
||||
|
||||
Run acceptance test with local server and selenium server started.
|
||||
|
||||
|
||||
``` php
|
||||
<?php
|
||||
class RoboFile extends \Robo\Tasks
|
||||
{
|
||||
|
||||
function testAcceptance($seleniumPath = '~/selenium-server-standalone-2.39.0.jar')
|
||||
{
|
||||
// launches PHP server on port 8000 for web dir
|
||||
// server will be executed in background and stopped in the end
|
||||
$this->taskServer(8000)
|
||||
->background()
|
||||
->dir('web')
|
||||
->run();
|
||||
|
||||
// running Selenium server in background
|
||||
$this->taskExec('java -jar ' . $seleniumPath)
|
||||
->background()
|
||||
->run();
|
||||
|
||||
// loading Symfony Command and running with passed argument
|
||||
$this->taskSymfonyCommand(new \Codeception\Command\Run('run'))
|
||||
->arg('suite','acceptance')
|
||||
->run();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
If you execute `robo` you will see this task added to list of available task with name: `test:acceptance`.
|
||||
To execute it you should run `robo test:acceptance`. You may change path to selenium server by passing new path as a argument:
|
||||
|
||||
```
|
||||
robo test:acceptance "C:\Downloads\selenium.jar"
|
||||
```
|
||||
|
||||
Using `watch` task so you can use it for running tests or building assets.
|
||||
|
||||
``` php
|
||||
<?php
|
||||
class RoboFile extends \Robo\Tasks {
|
||||
|
||||
function watchComposer()
|
||||
{
|
||||
// when composer.json changes `composer update` will be executed
|
||||
$this->taskWatch()->monitor('composer.json', function() {
|
||||
$this->taskComposerUpdate()->run();
|
||||
})->run();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
Cleaning logs and cache
|
||||
|
||||
``` php
|
||||
<?php
|
||||
class RoboFile extends \Robo\Tasks
|
||||
{
|
||||
public function clean()
|
||||
{
|
||||
$this->taskCleanDir([
|
||||
'app/cache',
|
||||
'app/logs'
|
||||
])->run();
|
||||
|
||||
$this->taskDeleteDir([
|
||||
'web/assets/tmp_uploads',
|
||||
])->run();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
This task cleans `app/cache` and `app/logs` dirs (ignoring .gitignore and .gitkeep files)
|
||||
Can be executed by running:
|
||||
|
||||
```
|
||||
robo clean
|
||||
```
|
||||
|
||||
----
|
||||
|
||||
Creating Phar archive
|
||||
|
||||
``` php
|
||||
function buildPhar()
|
||||
{
|
||||
$files = Finder::create()->ignoreVCS(true)->files()->name('*.php')->in(__DIR__);
|
||||
$packer = $this->taskPackPhar('robo.phar');
|
||||
foreach ($files as $file) {
|
||||
$packer->addFile($file->getRelativePathname(), $file->getRealPath());
|
||||
}
|
||||
$packer->addFile('robo','robo')
|
||||
->executable('robo')
|
||||
->run();
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## We need more tasks!
|
||||
|
||||
Create your own tasks and send them as Pull Requests or create packages [with `"type": "robo-tasks"` in `composer.json` on Packagist](https://packagist.org/?type=robo-tasks).
|
||||
|
||||
## Credits
|
||||
|
||||
Follow [@robo_php](http://twitter.com/robo_php) for updates.
|
||||
|
||||
Brought to you by [Consolidation Team](https://github.com/orgs/consolidation/people) and our [awesome contributors](https://github.com/consolidation/Robo/graphs/contributors).
|
||||
|
||||
## License
|
||||
|
||||
[MIT](https://github.com/consolidation/Robo/blob/master/LICENSE)
|
||||
473
vendor/consolidation/robo/RoboFile.php
vendored
Normal file
473
vendor/consolidation/robo/RoboFile.php
vendored
Normal file
|
|
@ -0,0 +1,473 @@
|
|||
<?php
|
||||
use Symfony\Component\Finder\Finder;
|
||||
|
||||
class RoboFile extends \Robo\Tasks
|
||||
{
|
||||
/**
|
||||
* Run the Robo unit tests.
|
||||
*/
|
||||
public function test(array $args, $options =
|
||||
[
|
||||
'coverage-html' => false,
|
||||
'coverage' => false
|
||||
])
|
||||
{
|
||||
$taskCodecept = $this->taskCodecept()
|
||||
->args($args);
|
||||
|
||||
if ($options['coverage']) {
|
||||
$taskCodecept->coverageXml('../../build/logs/clover.xml');
|
||||
}
|
||||
if ($options['coverage-html']) {
|
||||
$taskCodecept->coverageHtml('../../build/logs/coverage');
|
||||
}
|
||||
|
||||
return $taskCodecept->run();
|
||||
}
|
||||
|
||||
/**
|
||||
* Code sniffer.
|
||||
*
|
||||
* Run the PHP Codesniffer on a file or directory.
|
||||
*
|
||||
* @param string $file
|
||||
* A file or directory to analyze.
|
||||
* @option $autofix Whether to run the automatic fixer or not.
|
||||
* @option $strict Show warnings as well as errors.
|
||||
* Default is to show only errors.
|
||||
*/
|
||||
public function sniff(
|
||||
$file = 'src/',
|
||||
$options = [
|
||||
'autofix' => false,
|
||||
'strict' => false,
|
||||
]
|
||||
) {
|
||||
$strict = $options['strict'] ? '' : '-n';
|
||||
$result = $this->taskExec("./vendor/bin/phpcs --standard=PSR2 --exclude=Squiz.Classes.ValidClassName {$strict} {$file}")->run();
|
||||
if (!$result->wasSuccessful()) {
|
||||
if (!$options['autofix']) {
|
||||
$options['autofix'] = $this->confirm('Would you like to run phpcbf to fix the reported errors?');
|
||||
}
|
||||
if ($options['autofix']) {
|
||||
$result = $this->taskExec("./vendor/bin/phpcbf --standard=PSR2 --exclude=Squiz.Classes.ValidClassName {$file}")->run();
|
||||
}
|
||||
}
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Generate a new Robo task that wraps an existing utility class.
|
||||
*
|
||||
* @param $className The name of the existing utility class to wrap.
|
||||
* @param $wrapperClassName The name of the wrapper class to create. Optional.
|
||||
* @usage generate:task 'Symfony\Component\Filesystem\Filesystem' FilesystemStack
|
||||
*/
|
||||
public function generateTask($className, $wrapperClassName = "")
|
||||
{
|
||||
return $this->taskGenTask($className, $wrapperClassName)->run();
|
||||
}
|
||||
|
||||
/**
|
||||
* Release Robo.
|
||||
*/
|
||||
public function release($opts = ['beta' => false])
|
||||
{
|
||||
$this->checkPharReadonly();
|
||||
|
||||
$version = \Robo\Robo::VERSION;
|
||||
$stable = !$opts['beta'];
|
||||
if ($stable) {
|
||||
$version = preg_replace('/-.*/', '', $version);
|
||||
}
|
||||
else {
|
||||
$version = $this->incrementVersion($version, 'beta');
|
||||
}
|
||||
$this->writeVersion($version);
|
||||
$this->yell("Releasing Robo $version");
|
||||
|
||||
$this->docs();
|
||||
$this->taskGitStack()
|
||||
->add('-A')
|
||||
->commit("Robo release $version")
|
||||
->pull()
|
||||
->push()
|
||||
->run();
|
||||
|
||||
if ($stable) {
|
||||
$this->pharPublish();
|
||||
}
|
||||
$this->publish();
|
||||
|
||||
$this->taskGitStack()
|
||||
->tag($version)
|
||||
->push('origin master --tags')
|
||||
->run();
|
||||
|
||||
if ($stable) {
|
||||
$version = $this->incrementVersion($version) . '-dev';
|
||||
$this->writeVersion($version);
|
||||
|
||||
$this->taskGitStack()
|
||||
->add('-A')
|
||||
->commit("Prepare for $version")
|
||||
->push()
|
||||
->run();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Update changelog.
|
||||
*
|
||||
* Add an entry to the Robo CHANGELOG.md file.
|
||||
*
|
||||
* @param string $addition The text to add to the change log.
|
||||
*/
|
||||
public function changed($addition)
|
||||
{
|
||||
$version = preg_replace('/-.*/', '', \Robo\Robo::VERSION);
|
||||
return $this->taskChangelog()
|
||||
->version($version)
|
||||
->change($addition)
|
||||
->run();
|
||||
}
|
||||
|
||||
/**
|
||||
* Update the version of Robo.
|
||||
*
|
||||
* @param string $version The new verison for Robo.
|
||||
* Defaults to the next minor (bugfix) version after the current relelase.
|
||||
* @option stage The version stage: dev, alpha, beta or rc. Use empty for stable.
|
||||
*/
|
||||
public function versionBump($version = '', $options = ['stage' => ''])
|
||||
{
|
||||
// If the user did not specify a version, then update the current version.
|
||||
if (empty($version)) {
|
||||
$version = $this->incrementVersion(\Robo\Robo::VERSION, $options['stage']);
|
||||
}
|
||||
return $this->writeVersion($version);
|
||||
}
|
||||
|
||||
/**
|
||||
* Write the specified version string back into the Robo.php file.
|
||||
* @param string $version
|
||||
*/
|
||||
protected function writeVersion($version)
|
||||
{
|
||||
// Write the result to a file.
|
||||
return $this->taskReplaceInFile(__DIR__.'/src/Robo.php')
|
||||
->regex("#VERSION = '[^']*'#")
|
||||
->to("VERSION = '".$version."'")
|
||||
->run();
|
||||
}
|
||||
|
||||
/**
|
||||
* Advance to the next SemVer version.
|
||||
*
|
||||
* The behavior depends on the parameter $stage.
|
||||
* - If $stage is empty, then the patch or minor version of $version is incremented
|
||||
* - If $stage matches the current stage in the current version, then add one
|
||||
* to the stage (e.g. alpha3 -> alpha4)
|
||||
* - If $stage does not match the current stage in the current version, then
|
||||
* reset to '1' (e.g. alpha4 -> beta1)
|
||||
*
|
||||
* @param string $version A SemVer version
|
||||
* @param string $stage dev, alpha, beta, rc or an empty string for stable.
|
||||
* @return string
|
||||
*/
|
||||
protected function incrementVersion($version, $stage = '')
|
||||
{
|
||||
$stable = empty($stage);
|
||||
$versionStageNumber = '0';
|
||||
preg_match('/-([a-zA-Z]*)([0-9]*)/', $version, $match);
|
||||
$match += ['', '', ''];
|
||||
$versionStage = $match[1];
|
||||
$versionStageNumber = $match[2];
|
||||
if ($versionStage != $stage) {
|
||||
$versionStageNumber = 0;
|
||||
}
|
||||
$version = preg_replace('/-.*/', '', $version);
|
||||
$versionParts = explode('.', $version);
|
||||
if ($stable) {
|
||||
$versionParts[count($versionParts)-1]++;
|
||||
}
|
||||
$version = implode('.', $versionParts);
|
||||
if (!$stable) {
|
||||
$version .= '-' . $stage;
|
||||
if ($stage != 'dev') {
|
||||
$versionStageNumber++;
|
||||
$version .= $versionStageNumber;
|
||||
}
|
||||
}
|
||||
return $version;
|
||||
}
|
||||
|
||||
/**
|
||||
* Generate the Robo documentation files.
|
||||
*/
|
||||
public function docs()
|
||||
{
|
||||
$collection = $this->collectionBuilder();
|
||||
$collection->progressMessage('Generate documentation from source code.');
|
||||
$files = Finder::create()->files()->name('*.php')->in('src/Task');
|
||||
$docs = [];
|
||||
foreach ($files as $file) {
|
||||
if ($file->getFileName() == 'loadTasks.php') {
|
||||
continue;
|
||||
}
|
||||
if ($file->getFileName() == 'loadShortcuts.php') {
|
||||
continue;
|
||||
}
|
||||
$ns = $file->getRelativePath();
|
||||
if (!$ns) {
|
||||
continue;
|
||||
}
|
||||
$class = basename(substr($file, 0, -4));
|
||||
class_exists($class = "Robo\\Task\\$ns\\$class");
|
||||
$docs[$ns][] = $class;
|
||||
}
|
||||
ksort($docs);
|
||||
|
||||
foreach ($docs as $ns => $tasks) {
|
||||
$taskGenerator = $collection->taskGenDoc("docs/tasks/$ns.md");
|
||||
$taskGenerator->filterClasses(function (\ReflectionClass $r) {
|
||||
return !($r->isAbstract() || $r->isTrait()) && $r->implementsInterface('Robo\Contract\TaskInterface');
|
||||
})->prepend("# $ns Tasks");
|
||||
sort($tasks);
|
||||
foreach ($tasks as $class) {
|
||||
$taskGenerator->docClass($class);
|
||||
}
|
||||
|
||||
$taskGenerator->filterMethods(
|
||||
function (\ReflectionMethod $m) {
|
||||
if ($m->isConstructor() || $m->isDestructor() || $m->isStatic()) {
|
||||
return false;
|
||||
}
|
||||
$undocumentedMethods =
|
||||
[
|
||||
'',
|
||||
'run',
|
||||
'__call',
|
||||
'inflect',
|
||||
'injectDependencies',
|
||||
'getCommand',
|
||||
'getPrinted',
|
||||
'getConfig',
|
||||
'setConfig',
|
||||
'logger',
|
||||
'setLogger',
|
||||
'setProgressIndicator',
|
||||
'progressIndicatorSteps',
|
||||
'setBuilder',
|
||||
'getBuilder',
|
||||
'collectionBuilder',
|
||||
'setVerbosityThreshold',
|
||||
'verbosityThreshold',
|
||||
'setOutputAdapter',
|
||||
'outputAdapter',
|
||||
'hasOutputAdapter',
|
||||
'verbosityMeetsThreshold',
|
||||
'writeMessage',
|
||||
'detectInteractive',
|
||||
'background',
|
||||
'timeout',
|
||||
'idleTimeout',
|
||||
'env',
|
||||
'envVars',
|
||||
'setInput',
|
||||
'interactive',
|
||||
'silent',
|
||||
'printed',
|
||||
'printOutput',
|
||||
'printMetadata',
|
||||
];
|
||||
return !in_array($m->name, $undocumentedMethods) && $m->isPublic(); // methods are not documented
|
||||
}
|
||||
)->processClassSignature(
|
||||
function ($c) {
|
||||
return "## " . preg_replace('~Task$~', '', $c->getShortName()) . "\n";
|
||||
}
|
||||
)->processClassDocBlock(
|
||||
function (\ReflectionClass $c, $doc) {
|
||||
$doc = preg_replace('~@method .*?(.*?)\)~', '* `$1)` ', $doc);
|
||||
$doc = str_replace('\\'.$c->name, '', $doc);
|
||||
return $doc;
|
||||
}
|
||||
)->processMethodSignature(
|
||||
function (\ReflectionMethod $m, $text) {
|
||||
return str_replace('#### *public* ', '* `', $text) . '`';
|
||||
}
|
||||
)->processMethodDocBlock(
|
||||
function (\ReflectionMethod $m, $text) {
|
||||
|
||||
return $text ? ' ' . trim(strtok($text, "\n"), "\n") : '';
|
||||
}
|
||||
);
|
||||
}
|
||||
$collection->progressMessage('Documentation generation complete.');
|
||||
return $collection->run();
|
||||
}
|
||||
|
||||
/**
|
||||
* Publish Robo.
|
||||
*
|
||||
* Builds a site in gh-pages branch. Uses mkdocs
|
||||
*/
|
||||
public function publish()
|
||||
{
|
||||
$current_branch = exec('git rev-parse --abbrev-ref HEAD');
|
||||
|
||||
return $this->collectionBuilder()
|
||||
->taskGitStack()
|
||||
->checkout('site')
|
||||
->merge('master')
|
||||
->completion($this->taskGitStack()->checkout($current_branch))
|
||||
->taskFilesystemStack()
|
||||
->copy('CHANGELOG.md', 'docs/changelog.md')
|
||||
->completion($this->taskFilesystemStack()->remove('docs/changelog.md'))
|
||||
->taskExec('mkdocs gh-deploy')
|
||||
->run();
|
||||
}
|
||||
|
||||
/**
|
||||
* Build the Robo phar executable.
|
||||
*/
|
||||
public function pharBuild()
|
||||
{
|
||||
$this->checkPharReadonly();
|
||||
|
||||
// Create a collection builder to hold the temporary
|
||||
// directory until the pack phar task runs.
|
||||
$collection = $this->collectionBuilder();
|
||||
|
||||
$workDir = $collection->tmpDir();
|
||||
$roboBuildDir = "$workDir/robo";
|
||||
|
||||
// Before we run `composer install`, we will remove the dev
|
||||
// dependencies that we only use in the unit tests. Any dev dependency
|
||||
// that is in the 'suggested' section is used by a core task;
|
||||
// we will include all of those in the phar.
|
||||
$devProjectsToRemove = $this->devDependenciesToRemoveFromPhar();
|
||||
|
||||
// We need to create our work dir and run `composer install`
|
||||
// before we prepare the pack phar task, so create a separate
|
||||
// collection builder to do this step in.
|
||||
$prepTasks = $this->collectionBuilder();
|
||||
|
||||
$preparationResult = $prepTasks
|
||||
->taskFilesystemStack()
|
||||
->mkdir($workDir)
|
||||
->taskRsync()
|
||||
->fromPath(
|
||||
[
|
||||
__DIR__ . '/composer.json',
|
||||
__DIR__ . '/scripts',
|
||||
__DIR__ . '/src',
|
||||
__DIR__ . '/data'
|
||||
]
|
||||
)
|
||||
->toPath($roboBuildDir)
|
||||
->recursive()
|
||||
->progress()
|
||||
->stats()
|
||||
->taskComposerRemove()
|
||||
->dir($roboBuildDir)
|
||||
->dev()
|
||||
->noUpdate()
|
||||
->args($devProjectsToRemove)
|
||||
->taskComposerInstall()
|
||||
->dir($roboBuildDir)
|
||||
->noScripts()
|
||||
->printed(true)
|
||||
->run();
|
||||
|
||||
// Exit if the preparation step failed
|
||||
if (!$preparationResult->wasSuccessful()) {
|
||||
return $preparationResult;
|
||||
}
|
||||
|
||||
// Decide which files we're going to pack
|
||||
$files = Finder::create()->ignoreVCS(true)
|
||||
->files()
|
||||
->name('*.php')
|
||||
->name('*.exe') // for 1symfony/console/Resources/bin/hiddeninput.exe
|
||||
->name('GeneratedWrapper.tmpl')
|
||||
->path('src')
|
||||
->path('vendor')
|
||||
->notPath('docs')
|
||||
->notPath('/vendor\/.*\/[Tt]est/')
|
||||
->in(is_dir($roboBuildDir) ? $roboBuildDir : __DIR__);
|
||||
|
||||
// Build the phar
|
||||
return $collection
|
||||
->taskPackPhar('robo.phar')
|
||||
->addFiles($files)
|
||||
->addFile('robo', 'robo')
|
||||
->executable('robo')
|
||||
->taskFilesystemStack()
|
||||
->chmod('robo.phar', 0777)
|
||||
->run();
|
||||
}
|
||||
|
||||
protected function checkPharReadonly()
|
||||
{
|
||||
if (ini_get('phar.readonly')) {
|
||||
throw new \Exception('Must set "phar.readonly = Off" in php.ini to build phars.');
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* The phar:build command removes the project requirements from the
|
||||
* 'require-dev' section that are not in the 'suggest' section.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
protected function devDependenciesToRemoveFromPhar()
|
||||
{
|
||||
$composerInfo = (array) json_decode(file_get_contents(__DIR__ . '/composer.json'));
|
||||
|
||||
$devDependencies = array_keys((array)$composerInfo['require-dev']);
|
||||
$suggestedProjects = array_keys((array)$composerInfo['suggest']);
|
||||
|
||||
return array_diff($devDependencies, $suggestedProjects);
|
||||
}
|
||||
|
||||
/**
|
||||
* Install Robo phar.
|
||||
*
|
||||
* Installs the Robo phar executable in /usr/bin. Uses 'sudo'.
|
||||
*/
|
||||
public function pharInstall()
|
||||
{
|
||||
return $this->taskExec('sudo cp')
|
||||
->arg('robo.phar')
|
||||
->arg('/usr/bin/robo')
|
||||
->run();
|
||||
}
|
||||
|
||||
/**
|
||||
* Publish Robo phar.
|
||||
*
|
||||
* Commits the phar executable to Robo's GitHub pages site.
|
||||
*/
|
||||
public function pharPublish()
|
||||
{
|
||||
$this->pharBuild();
|
||||
|
||||
$this->collectionBuilder()
|
||||
->taskFilesystemStack()
|
||||
->rename('robo.phar', 'robo-release.phar')
|
||||
->taskGitStack()
|
||||
->checkout('site')
|
||||
->pull('origin site')
|
||||
->taskFilesystemStack()
|
||||
->remove('robotheme/robo.phar')
|
||||
->rename('robo-release.phar', 'robotheme/robo.phar')
|
||||
->taskGitStack()
|
||||
->add('robotheme/robo.phar')
|
||||
->commit('Update robo.phar to ' . \Robo\Robo::VERSION)
|
||||
->push('origin site')
|
||||
->checkout('master')
|
||||
->run();
|
||||
}
|
||||
}
|
||||
21
vendor/consolidation/robo/codeception.yml
vendored
Normal file
21
vendor/consolidation/robo/codeception.yml
vendored
Normal file
|
|
@ -0,0 +1,21 @@
|
|||
actor: Guy
|
||||
paths:
|
||||
tests: tests
|
||||
log: tests/_log
|
||||
data: tests/_data
|
||||
helpers: tests/_helpers
|
||||
settings:
|
||||
bootstrap: _bootstrap.php
|
||||
colors: true
|
||||
memory_limit: 1024M
|
||||
modules:
|
||||
config:
|
||||
Db:
|
||||
dsn: ''
|
||||
user: ''
|
||||
password: ''
|
||||
dump: tests/_data/dump.sql
|
||||
coverage:
|
||||
enabled: true
|
||||
include:
|
||||
- src/*
|
||||
118
vendor/consolidation/robo/composer.json
vendored
Normal file
118
vendor/consolidation/robo/composer.json
vendored
Normal file
|
|
@ -0,0 +1,118 @@
|
|||
{
|
||||
"name": "consolidation/robo",
|
||||
"description": "Modern task runner",
|
||||
"license": "MIT",
|
||||
"authors": [
|
||||
{
|
||||
"name": "Davert",
|
||||
"email": "davert.php@resend.cc"
|
||||
}
|
||||
],
|
||||
"autoload":{
|
||||
"psr-4":{
|
||||
"Robo\\":"src"
|
||||
}
|
||||
},
|
||||
"autoload-dev":{
|
||||
"psr-4":{
|
||||
"Robo\\":"tests/src",
|
||||
"RoboExample\\":"examples/src"
|
||||
}
|
||||
},
|
||||
"bin":["robo"],
|
||||
"require": {
|
||||
"php": ">=5.5.0",
|
||||
"league/container": "^2.2",
|
||||
"consolidation/log": "~1",
|
||||
"consolidation/config": "^1.0.10",
|
||||
"consolidation/annotated-command": "^2.8.2",
|
||||
"consolidation/output-formatters": "^3.1.13",
|
||||
"consolidation/self-update": "^1",
|
||||
"grasmash/yaml-expander": "^1.3",
|
||||
"symfony/finder": "^2.5|^3|^4",
|
||||
"symfony/console": "^2.8|^3|^4",
|
||||
"symfony/process": "^2.5|^3|^4",
|
||||
"symfony/filesystem": "^2.5|^3|^4",
|
||||
"symfony/event-dispatcher": "^2.5|^3|^4"
|
||||
},
|
||||
"require-dev": {
|
||||
"g1a/composer-test-scenarios": "^3",
|
||||
"patchwork/jsqueeze": "~2",
|
||||
"natxet/CssMin": "3.0.4",
|
||||
"pear/archive_tar": "^1.4.2",
|
||||
"codeception/base": "^2.3.7",
|
||||
"goaop/framework": "~2.1.2",
|
||||
"codeception/verify": "^0.3.2",
|
||||
"codeception/aspect-mock": "^1|^2.1.1",
|
||||
"goaop/parser-reflection": "^1.1.0",
|
||||
"nikic/php-parser": "^3.1.5",
|
||||
"php-coveralls/php-coveralls": "^1",
|
||||
"phpunit/php-code-coverage": "~2|~4",
|
||||
"squizlabs/php_codesniffer": "^2.8"
|
||||
},
|
||||
"scripts": {
|
||||
"cs": "./robo sniff",
|
||||
"unit": "./robo test --coverage",
|
||||
"lint": [
|
||||
"find src -name '*.php' -print0 | xargs -0 -n1 php -l",
|
||||
"find tests/src -name '*.php' -print0 | xargs -0 -n1 php -l"
|
||||
],
|
||||
"test": [
|
||||
"@lint",
|
||||
"@unit",
|
||||
"@cs"
|
||||
],
|
||||
"pre-install-cmd": [
|
||||
"Robo\\composer\\ScriptHandler::checkDependencies"
|
||||
]
|
||||
},
|
||||
"config": {
|
||||
"optimize-autoloader": true,
|
||||
"sort-packages": true,
|
||||
"platform": {
|
||||
"php": "5.6.3"
|
||||
}
|
||||
},
|
||||
"extra": {
|
||||
"scenarios": {
|
||||
"symfony4": {
|
||||
"require": {
|
||||
"symfony/console": "^4"
|
||||
},
|
||||
"config": {
|
||||
"platform": {
|
||||
"php": "7.1.3"
|
||||
}
|
||||
}
|
||||
},
|
||||
"symfony2": {
|
||||
"require": {
|
||||
"symfony/console": "^2.8"
|
||||
},
|
||||
"remove": [
|
||||
"goaop/framework"
|
||||
],
|
||||
"config": {
|
||||
"platform": {
|
||||
"php": "5.5.9"
|
||||
}
|
||||
},
|
||||
"scenario-options": {
|
||||
"create-lockfile": "false"
|
||||
}
|
||||
}
|
||||
},
|
||||
"branch-alias": {
|
||||
"dev-master": "1.x-dev"
|
||||
}
|
||||
},
|
||||
"suggest": {
|
||||
"pear/archive_tar": "Allows tar archives to be created and extracted in taskPack and taskExtract, respectively.",
|
||||
"henrikbjorn/lurker": "For monitoring filesystem changes in taskWatch",
|
||||
"patchwork/jsqueeze": "For minifying JS files in taskMinify",
|
||||
"natxet/CssMin": "For minifying CSS files in taskMinify"
|
||||
},
|
||||
"replace": {
|
||||
"codegyre/robo": "< 1.0"
|
||||
}
|
||||
}
|
||||
4035
vendor/consolidation/robo/composer.lock
generated
vendored
Normal file
4035
vendor/consolidation/robo/composer.lock
generated
vendored
Normal file
File diff suppressed because it is too large
Load diff
39
vendor/consolidation/robo/data/Task/Development/GeneratedWrapper.tmpl
vendored
Normal file
39
vendor/consolidation/robo/data/Task/Development/GeneratedWrapper.tmpl
vendored
Normal file
|
|
@ -0,0 +1,39 @@
|
|||
<?php
|
||||
namespace Robo\Task\{delegateNamespace};
|
||||
|
||||
use Robo\Result;
|
||||
use Robo\Task\StackBasedTask;
|
||||
use {delegateNamespace}\{delegate};
|
||||
|
||||
/**
|
||||
* Wrapper for {delegate} Component.
|
||||
* Comands are executed in stack and can be stopped on first fail with `stopOnFail` option.
|
||||
*
|
||||
* ``` php
|
||||
* <?php
|
||||
* $this->task{wrapperClassName}()
|
||||
* ...
|
||||
* ->run();
|
||||
*
|
||||
* // one line
|
||||
* ...
|
||||
*
|
||||
* ?>
|
||||
* ```
|
||||
*
|
||||
{methodList}
|
||||
*/
|
||||
class {wrapperClassName} extends StackBasedTask
|
||||
{
|
||||
protected $delegate;
|
||||
|
||||
public function __construct()
|
||||
{
|
||||
$this->delegate = new {delegate}();
|
||||
}
|
||||
|
||||
protected function getDelegate()
|
||||
{
|
||||
return $this->delegate;
|
||||
}{immediateMethods}{methodImplementations}
|
||||
}
|
||||
14
vendor/consolidation/robo/dependencies.yml
vendored
Normal file
14
vendor/consolidation/robo/dependencies.yml
vendored
Normal file
|
|
@ -0,0 +1,14 @@
|
|||
version: 2
|
||||
dependencies:
|
||||
- type: php
|
||||
settings:
|
||||
composer_options: "--no-dev" # used in "collection", overriden when actually making updates
|
||||
lockfile_updates:
|
||||
settings:
|
||||
composer_options: ""
|
||||
manifest_updates:
|
||||
settings:
|
||||
composer_options: ""
|
||||
filters:
|
||||
- name: ".*"
|
||||
versions: "L.Y.Y"
|
||||
36
vendor/consolidation/robo/phpunit.xml
vendored
Normal file
36
vendor/consolidation/robo/phpunit.xml
vendored
Normal file
|
|
@ -0,0 +1,36 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
|
||||
<phpunit
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
|
||||
backupGlobals="false"
|
||||
backupStaticAttributes="false"
|
||||
beStrictAboutChangesToGlobalState="true"
|
||||
beStrictAboutOutputDuringTests="true"
|
||||
beStrictAboutTestsThatDoNotTestAnything="true"
|
||||
bootstrap="vendor/autoload.php"
|
||||
colors="true"
|
||||
columns="max"
|
||||
convertErrorsToExceptions="true"
|
||||
convertNoticesToExceptions="true"
|
||||
convertWarningsToExceptions="true"
|
||||
processIsolation="false"
|
||||
stopOnError="false"
|
||||
stopOnFailure="false"
|
||||
stopOnRisky="false"
|
||||
verbose="true"
|
||||
>
|
||||
<php>
|
||||
<ini name="error_reporting" value="E_ALL" />
|
||||
</php>
|
||||
|
||||
<filter>
|
||||
<whitelist processUncoveredFilesFromWhitelist="true">
|
||||
<directory suffix=".php">./src</directory>
|
||||
</whitelist>
|
||||
</filter>
|
||||
|
||||
<logging>
|
||||
<log type="coverage-clover" target="build/logs/clover.xml"/>
|
||||
</logging>
|
||||
</phpunit>
|
||||
29
vendor/consolidation/robo/robo
vendored
Executable file
29
vendor/consolidation/robo/robo
vendored
Executable file
|
|
@ -0,0 +1,29 @@
|
|||
#!/usr/bin/env php
|
||||
<?php
|
||||
/**
|
||||
* if we're running from phar load the phar autoload,
|
||||
* else let the script 'robo' search for the autoloader.
|
||||
* If we cannot find a vendor/autoload.php file, then
|
||||
* we will go ahead and try the phar.
|
||||
*/
|
||||
$pharPath = \Phar::running(true);
|
||||
if ($pharPath) {
|
||||
$autoloaderPath = "$pharPath/vendor/autoload.php";
|
||||
} else {
|
||||
if (file_exists(__DIR__.'/vendor/autoload.php')) {
|
||||
$autoloaderPath = __DIR__.'/vendor/autoload.php';
|
||||
} elseif (file_exists(__DIR__.'/../../autoload.php')) {
|
||||
$autoloaderPath = __DIR__ . '/../../autoload.php';
|
||||
}
|
||||
}
|
||||
$classLoader = require $autoloaderPath;
|
||||
$configFilePath = getenv('ROBO_CONFIG') ?: getenv('HOME') . '/.robo/robo.yml';
|
||||
$runner = new \Robo\Runner();
|
||||
$runner
|
||||
->setRelativePluginNamespace('Robo\Plugin')
|
||||
->setSelfUpdateRepository('consolidation/robo')
|
||||
->setConfigurationFilename($configFilePath)
|
||||
->setEnvConfigPrefix('ROBO')
|
||||
->setClassLoader($classLoader);
|
||||
$statusCode = $runner->execute($_SERVER['argv']);
|
||||
exit($statusCode);
|
||||
8
vendor/consolidation/robo/robo.yml
vendored
Normal file
8
vendor/consolidation/robo/robo.yml
vendored
Normal file
|
|
@ -0,0 +1,8 @@
|
|||
options:
|
||||
progress-delay: 2
|
||||
simulate: null
|
||||
command:
|
||||
try:
|
||||
config:
|
||||
options:
|
||||
opt: wow
|
||||
58
vendor/consolidation/robo/scripts/composer/ScriptHandler.php
vendored
Normal file
58
vendor/consolidation/robo/scripts/composer/ScriptHandler.php
vendored
Normal file
|
|
@ -0,0 +1,58 @@
|
|||
<?php
|
||||
|
||||
/**
|
||||
* @file
|
||||
* Contains \Robo\composer\ScriptHandler.
|
||||
*/
|
||||
|
||||
namespace Robo\composer;
|
||||
|
||||
use Composer\Script\Event;
|
||||
use Symfony\Component\Filesystem\Filesystem;
|
||||
|
||||
class ScriptHandler
|
||||
{
|
||||
|
||||
/**
|
||||
* Run prior to `composer installl` when a composer.lock is present.
|
||||
* @param Event $event
|
||||
*/
|
||||
public static function checkDependencies(Event $event)
|
||||
{
|
||||
if (version_compare(PHP_VERSION, '5.6.0') < 0) {
|
||||
static::checkDependenciesFor55();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Check to see if the dependencies in composer.lock are compatible
|
||||
* with php 5.5.
|
||||
*/
|
||||
protected static function checkDependenciesFor55()
|
||||
{
|
||||
$fs = new Filesystem();
|
||||
if (!$fs->exists('composer.lock')) {
|
||||
return;
|
||||
}
|
||||
|
||||
$composerLockContents = file_get_contents('composer.lock');
|
||||
if (preg_match('#"php":.*(5\.6)#', $composerLockContents)) {
|
||||
static::fixDependenciesFor55();
|
||||
}
|
||||
}
|
||||
|
||||
protected static function fixDependenciesFor55()
|
||||
{
|
||||
$fs = new Filesystem();
|
||||
$status = 0;
|
||||
|
||||
$fs->remove('composer.lock');
|
||||
|
||||
// Composer has already read our composer.json file, so we will
|
||||
// need to run in a new process to fix things up.
|
||||
passthru('composer install --ansi', $status);
|
||||
|
||||
// Don't continue with the initial 'composer install' command
|
||||
exit($status);
|
||||
}
|
||||
}
|
||||
74
vendor/consolidation/robo/src/Application.php
vendored
Normal file
74
vendor/consolidation/robo/src/Application.php
vendored
Normal file
|
|
@ -0,0 +1,74 @@
|
|||
<?php
|
||||
namespace Robo;
|
||||
|
||||
use SelfUpdate\SelfUpdateCommand;
|
||||
use Symfony\Component\Console\Application as SymfonyApplication;
|
||||
use Symfony\Component\Console\Command\Command;
|
||||
use Symfony\Component\Console\Input\InputOption;
|
||||
|
||||
class Application extends SymfonyApplication
|
||||
{
|
||||
/**
|
||||
* @param string $name
|
||||
* @param string $version
|
||||
*/
|
||||
public function __construct($name, $version)
|
||||
{
|
||||
parent::__construct($name, $version);
|
||||
|
||||
$this->getDefinition()
|
||||
->addOption(
|
||||
new InputOption('--simulate', null, InputOption::VALUE_NONE, 'Run in simulated mode (show what would have happened).')
|
||||
);
|
||||
$this->getDefinition()
|
||||
->addOption(
|
||||
new InputOption('--progress-delay', null, InputOption::VALUE_REQUIRED, 'Number of seconds before progress bar is displayed in long-running task collections. Default: 2s.', Config::DEFAULT_PROGRESS_DELAY)
|
||||
);
|
||||
|
||||
$this->getDefinition()
|
||||
->addOption(
|
||||
new InputOption('--define', '-D', InputOption::VALUE_REQUIRED | InputOption::VALUE_IS_ARRAY, 'Define a configuration item value.', [])
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $roboFile
|
||||
* @param string $roboClass
|
||||
*/
|
||||
public function addInitRoboFileCommand($roboFile, $roboClass)
|
||||
{
|
||||
$createRoboFile = new Command('init');
|
||||
$createRoboFile->setDescription("Intitalizes basic RoboFile in current dir");
|
||||
$createRoboFile->setCode(function () use ($roboClass, $roboFile) {
|
||||
$output = Robo::output();
|
||||
$output->writeln("<comment> ~~~ Welcome to Robo! ~~~~ </comment>");
|
||||
$output->writeln("<comment> ". basename($roboFile) ." will be created in the current directory </comment>");
|
||||
file_put_contents(
|
||||
$roboFile,
|
||||
'<?php'
|
||||
. "\n/**"
|
||||
. "\n * This is project's console commands configuration for Robo task runner."
|
||||
. "\n *"
|
||||
. "\n * @see http://robo.li/"
|
||||
. "\n */"
|
||||
. "\nclass " . $roboClass . " extends \\Robo\\Tasks\n{\n // define public methods as commands\n}"
|
||||
);
|
||||
$output->writeln("<comment> Edit this file to add your commands! </comment>");
|
||||
});
|
||||
$this->add($createRoboFile);
|
||||
}
|
||||
|
||||
/**
|
||||
* Add self update command, do nothing if null is provided
|
||||
*
|
||||
* @param string $repository GitHub Repository for self update
|
||||
*/
|
||||
public function addSelfUpdateCommand($repository = null)
|
||||
{
|
||||
if (!$repository || empty(\Phar::running())) {
|
||||
return;
|
||||
}
|
||||
$selfUpdateCommand = new SelfUpdateCommand($this->getName(), $this->getVersion(), $repository);
|
||||
$this->add($selfUpdateCommand);
|
||||
}
|
||||
}
|
||||
26
vendor/consolidation/robo/src/ClassDiscovery/AbstractClassDiscovery.php
vendored
Normal file
26
vendor/consolidation/robo/src/ClassDiscovery/AbstractClassDiscovery.php
vendored
Normal file
|
|
@ -0,0 +1,26 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\ClassDiscovery;
|
||||
|
||||
/**
|
||||
* Class AbstractClassDiscovery
|
||||
*
|
||||
* @package Robo\ClassDiscovery
|
||||
*/
|
||||
abstract class AbstractClassDiscovery implements ClassDiscoveryInterface
|
||||
{
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
protected $searchPattern = '*.php';
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function setSearchPattern($searchPattern)
|
||||
{
|
||||
$this->searchPattern = $searchPattern;
|
||||
|
||||
return $this;
|
||||
}
|
||||
}
|
||||
30
vendor/consolidation/robo/src/ClassDiscovery/ClassDiscoveryInterface.php
vendored
Normal file
30
vendor/consolidation/robo/src/ClassDiscovery/ClassDiscoveryInterface.php
vendored
Normal file
|
|
@ -0,0 +1,30 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\ClassDiscovery;
|
||||
|
||||
/**
|
||||
* Interface ClassDiscoveryInterface
|
||||
*
|
||||
* @package Robo\Plugin\ClassDiscovery
|
||||
*/
|
||||
interface ClassDiscoveryInterface
|
||||
{
|
||||
/**
|
||||
* @param $searchPattern
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setSearchPattern($searchPattern);
|
||||
|
||||
/**
|
||||
* @return string[]
|
||||
*/
|
||||
public function getClasses();
|
||||
|
||||
/**
|
||||
* @param $class
|
||||
*
|
||||
* @return string|null
|
||||
*/
|
||||
public function getFile($class);
|
||||
}
|
||||
112
vendor/consolidation/robo/src/ClassDiscovery/RelativeNamespaceDiscovery.php
vendored
Normal file
112
vendor/consolidation/robo/src/ClassDiscovery/RelativeNamespaceDiscovery.php
vendored
Normal file
|
|
@ -0,0 +1,112 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\ClassDiscovery;
|
||||
|
||||
use Symfony\Component\Finder\Finder;
|
||||
use Composer\Autoload\ClassLoader;
|
||||
|
||||
/**
|
||||
* Class RelativeNamespaceDiscovery
|
||||
*
|
||||
* @package Robo\Plugin\ClassDiscovery
|
||||
*/
|
||||
class RelativeNamespaceDiscovery extends AbstractClassDiscovery
|
||||
{
|
||||
/**
|
||||
* @var \Composer\Autoload\ClassLoader
|
||||
*/
|
||||
protected $classLoader;
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
protected $relativeNamespace = '';
|
||||
|
||||
/**
|
||||
* RelativeNamespaceDiscovery constructor.
|
||||
*
|
||||
* @param \Composer\Autoload\ClassLoader $classLoader
|
||||
*/
|
||||
public function __construct(ClassLoader $classLoader)
|
||||
{
|
||||
$this->classLoader = $classLoader;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $relativeNamespace
|
||||
*
|
||||
* @return RelativeNamespaceDiscovery
|
||||
*/
|
||||
public function setRelativeNamespace($relativeNamespace)
|
||||
{
|
||||
$this->relativeNamespace = $relativeNamespace;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @inheritDoc
|
||||
*/
|
||||
public function getClasses()
|
||||
{
|
||||
$classes = [];
|
||||
$relativePath = $this->convertNamespaceToPath($this->relativeNamespace);
|
||||
|
||||
foreach ($this->classLoader->getPrefixesPsr4() as $baseNamespace => $directories) {
|
||||
$directories = array_filter(array_map(function ($directory) use ($relativePath) {
|
||||
return $directory.$relativePath;
|
||||
}, $directories), 'is_dir');
|
||||
|
||||
if ($directories) {
|
||||
foreach ($this->search($directories, $this->searchPattern) as $file) {
|
||||
$relativePathName = $file->getRelativePathname();
|
||||
$classes[] = $baseNamespace.$this->convertPathToNamespace($relativePath.'/'.$relativePathName);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return $classes;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function getFile($class)
|
||||
{
|
||||
return $this->classLoader->findFile($class);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param $directories
|
||||
* @param $pattern
|
||||
*
|
||||
* @return \Symfony\Component\Finder\Finder
|
||||
*/
|
||||
protected function search($directories, $pattern)
|
||||
{
|
||||
$finder = new Finder();
|
||||
$finder->files()
|
||||
->name($pattern)
|
||||
->in($directories);
|
||||
|
||||
return $finder;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param $path
|
||||
*
|
||||
* @return mixed
|
||||
*/
|
||||
protected function convertPathToNamespace($path)
|
||||
{
|
||||
return str_replace(['/', '.php'], ['\\', ''], trim($path, '/'));
|
||||
}
|
||||
|
||||
/**
|
||||
* @return string
|
||||
*/
|
||||
public function convertNamespaceToPath($namespace)
|
||||
{
|
||||
return '/'.str_replace("\\", '/', trim($namespace, '\\'));
|
||||
}
|
||||
}
|
||||
62
vendor/consolidation/robo/src/Collection/CallableTask.php
vendored
Normal file
62
vendor/consolidation/robo/src/Collection/CallableTask.php
vendored
Normal file
|
|
@ -0,0 +1,62 @@
|
|||
<?php
|
||||
namespace Robo\Collection;
|
||||
|
||||
use Robo\Result;
|
||||
use Robo\Contract\TaskInterface;
|
||||
use Robo\State\StateAwareInterface;
|
||||
use Robo\State\Data;
|
||||
|
||||
/**
|
||||
* Creates a task wrapper that converts any Callable into an
|
||||
* object that can be used directly with a task collection.
|
||||
*
|
||||
* It is not necessary to use this class directly; Collection will
|
||||
* automatically wrap Callables when they are added.
|
||||
*/
|
||||
class CallableTask implements TaskInterface
|
||||
{
|
||||
/**
|
||||
* @var callable
|
||||
*/
|
||||
protected $fn;
|
||||
|
||||
/**
|
||||
* @var \Robo\Contract\TaskInterface
|
||||
*/
|
||||
protected $reference;
|
||||
|
||||
public function __construct(callable $fn, TaskInterface $reference)
|
||||
{
|
||||
$this->fn = $fn;
|
||||
$this->reference = $reference;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
public function run()
|
||||
{
|
||||
$result = call_user_func($this->fn, $this->getState());
|
||||
// If the function returns no result, then count it
|
||||
// as a success.
|
||||
if (!isset($result)) {
|
||||
$result = Result::success($this->reference);
|
||||
}
|
||||
// If the function returns a result, it must either return
|
||||
// a \Robo\Result or an exit code. In the later case, we
|
||||
// convert it to a \Robo\Result.
|
||||
if (!$result instanceof Result) {
|
||||
$result = new Result($this->reference, $result);
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
public function getState()
|
||||
{
|
||||
if ($this->reference instanceof StateAwareInterface) {
|
||||
return $this->reference->getState();
|
||||
}
|
||||
return new Data();
|
||||
}
|
||||
}
|
||||
769
vendor/consolidation/robo/src/Collection/Collection.php
vendored
Normal file
769
vendor/consolidation/robo/src/Collection/Collection.php
vendored
Normal file
|
|
@ -0,0 +1,769 @@
|
|||
<?php
|
||||
namespace Robo\Collection;
|
||||
|
||||
use Robo\Result;
|
||||
use Robo\State\Data;
|
||||
use Psr\Log\LogLevel;
|
||||
use Robo\Contract\TaskInterface;
|
||||
use Robo\Task\StackBasedTask;
|
||||
use Robo\Task\BaseTask;
|
||||
use Robo\TaskInfo;
|
||||
use Robo\Contract\WrappedTaskInterface;
|
||||
use Robo\Exception\TaskException;
|
||||
use Robo\Exception\TaskExitException;
|
||||
use Robo\Contract\CommandInterface;
|
||||
|
||||
use Robo\Contract\InflectionInterface;
|
||||
use Robo\State\StateAwareInterface;
|
||||
use Robo\State\StateAwareTrait;
|
||||
|
||||
/**
|
||||
* Group tasks into a collection that run together. Supports
|
||||
* rollback operations for handling error conditions.
|
||||
*
|
||||
* This is an internal class. Clients should use a CollectionBuilder
|
||||
* rather than direct use of the Collection class. @see CollectionBuilder.
|
||||
*
|
||||
* Below, the example FilesystemStack task is added to a collection,
|
||||
* and associated with a rollback task. If any of the operations in
|
||||
* the FilesystemStack, or if any of the other tasks also added to
|
||||
* the task collection should fail, then the rollback function is
|
||||
* called. Here, taskDeleteDir is used to remove partial results
|
||||
* of an unfinished task.
|
||||
*/
|
||||
class Collection extends BaseTask implements CollectionInterface, CommandInterface, StateAwareInterface
|
||||
{
|
||||
use StateAwareTrait;
|
||||
|
||||
/**
|
||||
* @var \Robo\Collection\Element[]
|
||||
*/
|
||||
protected $taskList = [];
|
||||
|
||||
/**
|
||||
* @var TaskInterface[]
|
||||
*/
|
||||
protected $rollbackStack = [];
|
||||
|
||||
/**
|
||||
* @var TaskInterface[]
|
||||
*/
|
||||
protected $completionStack = [];
|
||||
|
||||
/**
|
||||
* @var CollectionInterface
|
||||
*/
|
||||
protected $parentCollection;
|
||||
|
||||
/**
|
||||
* @var callable[]
|
||||
*/
|
||||
protected $deferredCallbacks = [];
|
||||
|
||||
/**
|
||||
* @var string[]
|
||||
*/
|
||||
protected $messageStoreKeys = [];
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*/
|
||||
public function __construct()
|
||||
{
|
||||
$this->resetState();
|
||||
}
|
||||
|
||||
public function setProgressBarAutoDisplayInterval($interval)
|
||||
{
|
||||
if (!$this->progressIndicator) {
|
||||
return;
|
||||
}
|
||||
return $this->progressIndicator->setProgressBarAutoDisplayInterval($interval);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function add(TaskInterface $task, $name = self::UNNAMEDTASK)
|
||||
{
|
||||
$task = new CompletionWrapper($this, $task);
|
||||
$this->addToTaskList($name, $task);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function addCode(callable $code, $name = self::UNNAMEDTASK)
|
||||
{
|
||||
return $this->add(new CallableTask($code, $this), $name);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function addIterable($iterable, callable $code)
|
||||
{
|
||||
$callbackTask = (new IterationTask($iterable, $code, $this))->inflect($this);
|
||||
return $this->add($callbackTask);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function rollback(TaskInterface $rollbackTask)
|
||||
{
|
||||
// Rollback tasks always try as hard as they can, and never report failures.
|
||||
$rollbackTask = $this->ignoreErrorsTaskWrapper($rollbackTask);
|
||||
return $this->wrapAndRegisterRollback($rollbackTask);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function rollbackCode(callable $rollbackCode)
|
||||
{
|
||||
// Rollback tasks always try as hard as they can, and never report failures.
|
||||
$rollbackTask = $this->ignoreErrorsCodeWrapper($rollbackCode);
|
||||
return $this->wrapAndRegisterRollback($rollbackTask);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function completion(TaskInterface $completionTask)
|
||||
{
|
||||
$collection = $this;
|
||||
$completionRegistrationTask = new CallableTask(
|
||||
function () use ($collection, $completionTask) {
|
||||
|
||||
$collection->registerCompletion($completionTask);
|
||||
},
|
||||
$this
|
||||
);
|
||||
$this->addToTaskList(self::UNNAMEDTASK, $completionRegistrationTask);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function completionCode(callable $completionTask)
|
||||
{
|
||||
$completionTask = new CallableTask($completionTask, $this);
|
||||
return $this->completion($completionTask);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function before($name, $task, $nameOfTaskToAdd = self::UNNAMEDTASK)
|
||||
{
|
||||
return $this->addBeforeOrAfter(__FUNCTION__, $name, $task, $nameOfTaskToAdd);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function after($name, $task, $nameOfTaskToAdd = self::UNNAMEDTASK)
|
||||
{
|
||||
return $this->addBeforeOrAfter(__FUNCTION__, $name, $task, $nameOfTaskToAdd);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function progressMessage($text, $context = [], $level = LogLevel::NOTICE)
|
||||
{
|
||||
$context += ['name' => 'Progress'];
|
||||
$context += TaskInfo::getTaskContext($this);
|
||||
return $this->addCode(
|
||||
function () use ($level, $text, $context) {
|
||||
$context += $this->getState()->getData();
|
||||
$this->printTaskOutput($level, $text, $context);
|
||||
}
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Robo\Contract\TaskInterface $rollbackTask
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
protected function wrapAndRegisterRollback(TaskInterface $rollbackTask)
|
||||
{
|
||||
$collection = $this;
|
||||
$rollbackRegistrationTask = new CallableTask(
|
||||
function () use ($collection, $rollbackTask) {
|
||||
$collection->registerRollback($rollbackTask);
|
||||
},
|
||||
$this
|
||||
);
|
||||
$this->addToTaskList(self::UNNAMEDTASK, $rollbackRegistrationTask);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add either a 'before' or 'after' function or task.
|
||||
*
|
||||
* @param string $method
|
||||
* @param string $name
|
||||
* @param callable|TaskInterface $task
|
||||
* @param string $nameOfTaskToAdd
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
protected function addBeforeOrAfter($method, $name, $task, $nameOfTaskToAdd)
|
||||
{
|
||||
if (is_callable($task)) {
|
||||
$task = new CallableTask($task, $this);
|
||||
}
|
||||
$existingTask = $this->namedTask($name);
|
||||
$fn = [$existingTask, $method];
|
||||
call_user_func($fn, $task, $nameOfTaskToAdd);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Wrap the provided task in a wrapper that will ignore
|
||||
* any errors or exceptions that may be produced. This
|
||||
* is useful, for example, in adding optional cleanup tasks
|
||||
* at the beginning of a task collection, to remove previous
|
||||
* results which may or may not exist.
|
||||
*
|
||||
* TODO: Provide some way to specify which sort of errors
|
||||
* are ignored, so that 'file not found' may be ignored,
|
||||
* but 'permission denied' reported?
|
||||
*
|
||||
* @param \Robo\Contract\TaskInterface $task
|
||||
*
|
||||
* @return \Robo\Collection\CallableTask
|
||||
*/
|
||||
public function ignoreErrorsTaskWrapper(TaskInterface $task)
|
||||
{
|
||||
// If the task is a stack-based task, then tell it
|
||||
// to try to run all of its operations, even if some
|
||||
// of them fail.
|
||||
if ($task instanceof StackBasedTask) {
|
||||
$task->stopOnFail(false);
|
||||
}
|
||||
$ignoreErrorsInTask = function () use ($task) {
|
||||
$data = [];
|
||||
try {
|
||||
$result = $this->runSubtask($task);
|
||||
$message = $result->getMessage();
|
||||
$data = $result->getData();
|
||||
$data['exitcode'] = $result->getExitCode();
|
||||
} catch (\Exception $e) {
|
||||
$message = $e->getMessage();
|
||||
}
|
||||
|
||||
return Result::success($task, $message, $data);
|
||||
};
|
||||
// Wrap our ignore errors callable in a task.
|
||||
return new CallableTask($ignoreErrorsInTask, $this);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param callable $task
|
||||
*
|
||||
* @return \Robo\Collection\CallableTask
|
||||
*/
|
||||
public function ignoreErrorsCodeWrapper(callable $task)
|
||||
{
|
||||
return $this->ignoreErrorsTaskWrapper(new CallableTask($task, $this));
|
||||
}
|
||||
|
||||
/**
|
||||
* Return the list of task names added to this collection.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function taskNames()
|
||||
{
|
||||
return array_keys($this->taskList);
|
||||
}
|
||||
|
||||
/**
|
||||
* Test to see if a specified task name exists.
|
||||
* n.b. before() and after() require that the named
|
||||
* task exist; use this function to test first, if
|
||||
* unsure.
|
||||
*
|
||||
* @param string $name
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function hasTask($name)
|
||||
{
|
||||
return array_key_exists($name, $this->taskList);
|
||||
}
|
||||
|
||||
/**
|
||||
* Find an existing named task.
|
||||
*
|
||||
* @param string $name
|
||||
* The name of the task to insert before. The named task MUST exist.
|
||||
*
|
||||
* @return Element
|
||||
* The task group for the named task. Generally this is only
|
||||
* used to call 'before()' and 'after()'.
|
||||
*/
|
||||
protected function namedTask($name)
|
||||
{
|
||||
if (!$this->hasTask($name)) {
|
||||
throw new \RuntimeException("Could not find task named $name");
|
||||
}
|
||||
return $this->taskList[$name];
|
||||
}
|
||||
|
||||
/**
|
||||
* Add a list of tasks to our task collection.
|
||||
*
|
||||
* @param TaskInterface[] $tasks
|
||||
* An array of tasks to run with rollback protection
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function addTaskList(array $tasks)
|
||||
{
|
||||
foreach ($tasks as $name => $task) {
|
||||
$this->add($task, $name);
|
||||
}
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add the provided task to our task list.
|
||||
*
|
||||
* @param string $name
|
||||
* @param \Robo\Contract\TaskInterface $task
|
||||
*
|
||||
* @return \Robo\Collection\Collection
|
||||
*/
|
||||
protected function addToTaskList($name, TaskInterface $task)
|
||||
{
|
||||
// All tasks are stored in a task group so that we have a place
|
||||
// to hang 'before' and 'after' tasks.
|
||||
$taskGroup = new Element($task);
|
||||
return $this->addCollectionElementToTaskList($name, $taskGroup);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int|string $name
|
||||
* @param \Robo\Collection\Element $taskGroup
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
protected function addCollectionElementToTaskList($name, Element $taskGroup)
|
||||
{
|
||||
// If a task name is not provided, then we'll let php pick
|
||||
// the array index.
|
||||
if (Result::isUnnamed($name)) {
|
||||
$this->taskList[] = $taskGroup;
|
||||
return $this;
|
||||
}
|
||||
// If we are replacing an existing task with the
|
||||
// same name, ensure that our new task is added to
|
||||
// the end.
|
||||
$this->taskList[$name] = $taskGroup;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set the parent collection. This is necessary so that nested
|
||||
* collections' rollback and completion tasks can be added to the
|
||||
* top-level collection, ensuring that the rollbacks for a collection
|
||||
* will run if any later task fails.
|
||||
*
|
||||
* @param \Robo\Collection\NestedCollectionInterface $parentCollection
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setParentCollection(NestedCollectionInterface $parentCollection)
|
||||
{
|
||||
$this->parentCollection = $parentCollection;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the appropriate parent collection to use
|
||||
*
|
||||
* @return CollectionInterface
|
||||
*/
|
||||
public function getParentCollection()
|
||||
{
|
||||
return $this->parentCollection ? $this->parentCollection : $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Register a rollback task to run if there is any failure.
|
||||
*
|
||||
* Clients are free to add tasks to the rollback stack as
|
||||
* desired; however, usually it is preferable to call
|
||||
* Collection::rollback() instead. With that function,
|
||||
* the rollback function will only be called if all of the
|
||||
* tasks added before it complete successfully, AND some later
|
||||
* task fails.
|
||||
*
|
||||
* One example of a good use-case for registering a callback
|
||||
* function directly is to add a task that sends notification
|
||||
* when a task fails.
|
||||
*
|
||||
* @param TaskInterface $rollbackTask
|
||||
* The rollback task to run on failure.
|
||||
*/
|
||||
public function registerRollback(TaskInterface $rollbackTask)
|
||||
{
|
||||
if ($this->parentCollection) {
|
||||
return $this->parentCollection->registerRollback($rollbackTask);
|
||||
}
|
||||
if ($rollbackTask) {
|
||||
$this->rollbackStack[] = $rollbackTask;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Register a completion task to run once all other tasks finish.
|
||||
* Completion tasks run whether or not a rollback operation was
|
||||
* triggered. They do not trigger rollbacks if they fail.
|
||||
*
|
||||
* The typical use-case for a completion function is to clean up
|
||||
* temporary objects (e.g. temporary folders). The preferred
|
||||
* way to do that, though, is to use Temporary::wrap().
|
||||
*
|
||||
* On failures, completion tasks will run after all rollback tasks.
|
||||
* If one task collection is nested inside another task collection,
|
||||
* then the nested collection's completion tasks will run as soon as
|
||||
* the nested task completes; they are not deferred to the end of
|
||||
* the containing collection's execution.
|
||||
*
|
||||
* @param TaskInterface $completionTask
|
||||
* The completion task to run at the end of all other operations.
|
||||
*/
|
||||
public function registerCompletion(TaskInterface $completionTask)
|
||||
{
|
||||
if ($this->parentCollection) {
|
||||
return $this->parentCollection->registerCompletion($completionTask);
|
||||
}
|
||||
if ($completionTask) {
|
||||
// Completion tasks always try as hard as they can, and never report failures.
|
||||
$completionTask = $this->ignoreErrorsTaskWrapper($completionTask);
|
||||
$this->completionStack[] = $completionTask;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Return the count of steps in this collection
|
||||
*
|
||||
* @return int
|
||||
*/
|
||||
public function progressIndicatorSteps()
|
||||
{
|
||||
$steps = 0;
|
||||
foreach ($this->taskList as $name => $taskGroup) {
|
||||
$steps += $taskGroup->progressIndicatorSteps();
|
||||
}
|
||||
return $steps;
|
||||
}
|
||||
|
||||
/**
|
||||
* A Collection of tasks can provide a command via `getCommand()`
|
||||
* if it contains a single task, and that task implements CommandInterface.
|
||||
*
|
||||
* @return string
|
||||
*
|
||||
* @throws \Robo\Exception\TaskException
|
||||
*/
|
||||
public function getCommand()
|
||||
{
|
||||
if (empty($this->taskList)) {
|
||||
return '';
|
||||
}
|
||||
|
||||
if (count($this->taskList) > 1) {
|
||||
// TODO: We could potentially iterate over the items in the collection
|
||||
// and concatenate the result of getCommand() from each one, and fail
|
||||
// only if we encounter a command that is not a CommandInterface.
|
||||
throw new TaskException($this, "getCommand() does not work on arbitrary collections of tasks.");
|
||||
}
|
||||
|
||||
$taskElement = reset($this->taskList);
|
||||
$task = $taskElement->getTask();
|
||||
$task = ($task instanceof WrappedTaskInterface) ? $task->original() : $task;
|
||||
if ($task instanceof CommandInterface) {
|
||||
return $task->getCommand();
|
||||
}
|
||||
|
||||
throw new TaskException($task, get_class($task) . " does not implement CommandInterface, so can't be used to provide a command");
|
||||
}
|
||||
|
||||
/**
|
||||
* Run our tasks, and roll back if necessary.
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
public function run()
|
||||
{
|
||||
$result = $this->runWithoutCompletion();
|
||||
$this->complete();
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
private function runWithoutCompletion()
|
||||
{
|
||||
$result = Result::success($this);
|
||||
|
||||
if (empty($this->taskList)) {
|
||||
return $result;
|
||||
}
|
||||
|
||||
$this->startProgressIndicator();
|
||||
if ($result->wasSuccessful()) {
|
||||
foreach ($this->taskList as $name => $taskGroup) {
|
||||
$taskList = $taskGroup->getTaskList();
|
||||
$result = $this->runTaskList($name, $taskList, $result);
|
||||
if (!$result->wasSuccessful()) {
|
||||
$this->fail();
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
$this->taskList = [];
|
||||
}
|
||||
$this->stopProgressIndicator();
|
||||
$result['time'] = $this->getExecutionTime();
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Run every task in a list, but only up to the first failure.
|
||||
* Return the failing result, or success if all tasks run.
|
||||
*
|
||||
* @param string $name
|
||||
* @param TaskInterface[] $taskList
|
||||
* @param \Robo\Result $result
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*
|
||||
* @throws \Robo\Exception\TaskExitException
|
||||
*/
|
||||
private function runTaskList($name, array $taskList, Result $result)
|
||||
{
|
||||
try {
|
||||
foreach ($taskList as $taskName => $task) {
|
||||
$taskResult = $this->runSubtask($task);
|
||||
$this->advanceProgressIndicator();
|
||||
// If the current task returns an error code, then stop
|
||||
// execution and signal a rollback.
|
||||
if (!$taskResult->wasSuccessful()) {
|
||||
return $taskResult;
|
||||
}
|
||||
// We accumulate our results into a field so that tasks that
|
||||
// have a reference to the collection may examine and modify
|
||||
// the incremental results, if they wish.
|
||||
$key = Result::isUnnamed($taskName) ? $name : $taskName;
|
||||
$result->accumulate($key, $taskResult);
|
||||
// The result message will be the message of the last task executed.
|
||||
$result->setMessage($taskResult->getMessage());
|
||||
}
|
||||
} catch (TaskExitException $exitException) {
|
||||
$this->fail();
|
||||
throw $exitException;
|
||||
} catch (\Exception $e) {
|
||||
// Tasks typically should not throw, but if one does, we will
|
||||
// convert it into an error and roll back.
|
||||
return Result::fromException($task, $e, $result->getData());
|
||||
}
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Force the rollback functions to run
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function fail()
|
||||
{
|
||||
$this->disableProgressIndicator();
|
||||
$this->runRollbackTasks();
|
||||
$this->complete();
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Force the completion functions to run
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function complete()
|
||||
{
|
||||
$this->detatchProgressIndicator();
|
||||
$this->runTaskListIgnoringFailures($this->completionStack);
|
||||
$this->reset();
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Reset this collection, removing all tasks.
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function reset()
|
||||
{
|
||||
$this->taskList = [];
|
||||
$this->completionStack = [];
|
||||
$this->rollbackStack = [];
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Run all of our rollback tasks.
|
||||
*
|
||||
* Note that Collection does not implement RollbackInterface, but
|
||||
* it may still be used as a task inside another task collection
|
||||
* (i.e. you can nest task collections, if desired).
|
||||
*/
|
||||
protected function runRollbackTasks()
|
||||
{
|
||||
$this->runTaskListIgnoringFailures($this->rollbackStack);
|
||||
// Erase our rollback stack once we have finished rolling
|
||||
// everything back. This will allow us to potentially use
|
||||
// a command collection more than once (e.g. to retry a
|
||||
// failed operation after doing some error recovery).
|
||||
$this->rollbackStack = [];
|
||||
}
|
||||
|
||||
/**
|
||||
* @param TaskInterface|NestedCollectionInterface|WrappedTaskInterface $task
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
protected function runSubtask($task)
|
||||
{
|
||||
$original = ($task instanceof WrappedTaskInterface) ? $task->original() : $task;
|
||||
$this->setParentCollectionForTask($original, $this->getParentCollection());
|
||||
if ($original instanceof InflectionInterface) {
|
||||
$original->inflect($this);
|
||||
}
|
||||
if ($original instanceof StateAwareInterface) {
|
||||
$original->setState($this->getState());
|
||||
}
|
||||
$this->doDeferredInitialization($original);
|
||||
$taskResult = $task->run();
|
||||
$taskResult = Result::ensureResult($task, $taskResult);
|
||||
$this->doStateUpdates($original, $taskResult);
|
||||
return $taskResult;
|
||||
}
|
||||
|
||||
protected function doStateUpdates($task, Data $taskResult)
|
||||
{
|
||||
$this->updateState($taskResult);
|
||||
$key = spl_object_hash($task);
|
||||
if (array_key_exists($key, $this->messageStoreKeys)) {
|
||||
$state = $this->getState();
|
||||
list($stateKey, $sourceKey) = $this->messageStoreKeys[$key];
|
||||
$value = empty($sourceKey) ? $taskResult->getMessage() : $taskResult[$sourceKey];
|
||||
$state[$stateKey] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
public function storeState($task, $key, $source = '')
|
||||
{
|
||||
$this->messageStoreKeys[spl_object_hash($task)] = [$key, $source];
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
public function deferTaskConfiguration($task, $functionName, $stateKey)
|
||||
{
|
||||
return $this->defer(
|
||||
$task,
|
||||
function ($task, $state) use ($functionName, $stateKey) {
|
||||
$fn = [$task, $functionName];
|
||||
$value = $state[$stateKey];
|
||||
$fn($value);
|
||||
}
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Defer execution of a callback function until just before a task
|
||||
* runs. Use this time to provide more settings for the task, e.g. from
|
||||
* the collection's shared state, which is populated with the results
|
||||
* of previous test runs.
|
||||
*/
|
||||
public function defer($task, $callback)
|
||||
{
|
||||
$this->deferredCallbacks[spl_object_hash($task)][] = $callback;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
protected function doDeferredInitialization($task)
|
||||
{
|
||||
// If the task is a state consumer, then call its receiveState method
|
||||
if ($task instanceof \Robo\State\Consumer) {
|
||||
$task->receiveState($this->getState());
|
||||
}
|
||||
|
||||
// Check and see if there are any deferred callbacks for this task.
|
||||
$key = spl_object_hash($task);
|
||||
if (!array_key_exists($key, $this->deferredCallbacks)) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Call all of the deferred callbacks
|
||||
foreach ($this->deferredCallbacks[$key] as $fn) {
|
||||
$fn($task, $this->getState());
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @param TaskInterface|NestedCollectionInterface|WrappedTaskInterface $task
|
||||
* @param $parentCollection
|
||||
*/
|
||||
protected function setParentCollectionForTask($task, $parentCollection)
|
||||
{
|
||||
if ($task instanceof NestedCollectionInterface) {
|
||||
$task->setParentCollection($parentCollection);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Run all of the tasks in a provided list, ignoring failures.
|
||||
* This is used to roll back or complete.
|
||||
*
|
||||
* @param TaskInterface[] $taskList
|
||||
*/
|
||||
protected function runTaskListIgnoringFailures(array $taskList)
|
||||
{
|
||||
foreach ($taskList as $task) {
|
||||
try {
|
||||
$this->runSubtask($task);
|
||||
} catch (\Exception $e) {
|
||||
// Ignore rollback failures.
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Give all of our tasks to the provided collection builder.
|
||||
*
|
||||
* @param CollectionBuilder $builder
|
||||
*/
|
||||
public function transferTasks($builder)
|
||||
{
|
||||
foreach ($this->taskList as $name => $taskGroup) {
|
||||
// TODO: We are abandoning all of our before and after tasks here.
|
||||
// At the moment, transferTasks is only called under conditions where
|
||||
// there will be none of these, but care should be taken if that changes.
|
||||
$task = $taskGroup->getTask();
|
||||
$builder->addTaskToCollection($task);
|
||||
}
|
||||
$this->reset();
|
||||
}
|
||||
}
|
||||
571
vendor/consolidation/robo/src/Collection/CollectionBuilder.php
vendored
Normal file
571
vendor/consolidation/robo/src/Collection/CollectionBuilder.php
vendored
Normal file
|
|
@ -0,0 +1,571 @@
|
|||
<?php
|
||||
namespace Robo\Collection;
|
||||
|
||||
use Consolidation\Config\Inject\ConfigForSetters;
|
||||
use Robo\Config\Config;
|
||||
use Psr\Log\LogLevel;
|
||||
use Robo\Contract\InflectionInterface;
|
||||
use Robo\Contract\TaskInterface;
|
||||
use Robo\Contract\CompletionInterface;
|
||||
use Robo\Contract\WrappedTaskInterface;
|
||||
use Robo\Task\Simulator;
|
||||
use ReflectionClass;
|
||||
use Robo\Task\BaseTask;
|
||||
use Robo\Contract\BuilderAwareInterface;
|
||||
use Robo\Contract\CommandInterface;
|
||||
use Robo\Contract\VerbosityThresholdInterface;
|
||||
use Robo\State\StateAwareInterface;
|
||||
use Robo\State\StateAwareTrait;
|
||||
use Robo\Result;
|
||||
|
||||
/**
|
||||
* Creates a collection, and adds tasks to it. The collection builder
|
||||
* offers a streamlined chained-initialization mechanism for easily
|
||||
* creating task groups. Facilities for creating working and temporary
|
||||
* directories are also provided.
|
||||
*
|
||||
* ``` php
|
||||
* <?php
|
||||
* $result = $this->collectionBuilder()
|
||||
* ->taskFilesystemStack()
|
||||
* ->mkdir('g')
|
||||
* ->touch('g/g.txt')
|
||||
* ->rollback(
|
||||
* $this->taskDeleteDir('g')
|
||||
* )
|
||||
* ->taskFilesystemStack()
|
||||
* ->mkdir('g/h')
|
||||
* ->touch('g/h/h.txt')
|
||||
* ->taskFilesystemStack()
|
||||
* ->mkdir('g/h/i/c')
|
||||
* ->touch('g/h/i/i.txt')
|
||||
* ->run()
|
||||
* ?>
|
||||
*
|
||||
* In the example above, the `taskDeleteDir` will be called if
|
||||
* ```
|
||||
*/
|
||||
class CollectionBuilder extends BaseTask implements NestedCollectionInterface, WrappedTaskInterface, CommandInterface, StateAwareInterface
|
||||
{
|
||||
use StateAwareTrait;
|
||||
|
||||
/**
|
||||
* @var \Robo\Tasks
|
||||
*/
|
||||
protected $commandFile;
|
||||
|
||||
/**
|
||||
* @var CollectionInterface
|
||||
*/
|
||||
protected $collection;
|
||||
|
||||
/**
|
||||
* @var TaskInterface
|
||||
*/
|
||||
protected $currentTask;
|
||||
|
||||
/**
|
||||
* @var bool
|
||||
*/
|
||||
protected $simulated;
|
||||
|
||||
/**
|
||||
* @param \Robo\Tasks $commandFile
|
||||
*/
|
||||
public function __construct($commandFile)
|
||||
{
|
||||
$this->commandFile = $commandFile;
|
||||
$this->resetState();
|
||||
}
|
||||
|
||||
public static function create($container, $commandFile)
|
||||
{
|
||||
$builder = new self($commandFile);
|
||||
|
||||
$builder->setLogger($container->get('logger'));
|
||||
$builder->setProgressIndicator($container->get('progressIndicator'));
|
||||
$builder->setConfig($container->get('config'));
|
||||
$builder->setOutputAdapter($container->get('outputAdapter'));
|
||||
|
||||
return $builder;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool $simulated
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function simulated($simulated = true)
|
||||
{
|
||||
$this->simulated = $simulated;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return bool
|
||||
*/
|
||||
public function isSimulated()
|
||||
{
|
||||
if (!isset($this->simulated)) {
|
||||
$this->simulated = $this->getConfig()->get(Config::SIMULATE);
|
||||
}
|
||||
return $this->simulated;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a temporary directory to work in. When the collection
|
||||
* completes or rolls back, the temporary directory will be deleted.
|
||||
* Returns the path to the location where the directory will be
|
||||
* created.
|
||||
*
|
||||
* @param string $prefix
|
||||
* @param string $base
|
||||
* @param bool $includeRandomPart
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function tmpDir($prefix = 'tmp', $base = '', $includeRandomPart = true)
|
||||
{
|
||||
// n.b. Any task that the builder is asked to create is
|
||||
// automatically added to the builder's collection, and
|
||||
// wrapped in the builder object. Therefore, the result
|
||||
// of any call to `taskFoo()` from within the builder will
|
||||
// always be `$this`.
|
||||
return $this->taskTmpDir($prefix, $base, $includeRandomPart)->getPath();
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a working directory to hold results. A temporary directory
|
||||
* is first created to hold the intermediate results. After the
|
||||
* builder finishes, the work directory is moved into its final location;
|
||||
* any results already in place will be moved out of the way and
|
||||
* then deleted.
|
||||
*
|
||||
* @param string $finalDestination The path where the working directory
|
||||
* will be moved once the task collection completes.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function workDir($finalDestination)
|
||||
{
|
||||
// Creating the work dir task in this context adds it to our task collection.
|
||||
return $this->taskWorkDir($finalDestination)->getPath();
|
||||
}
|
||||
|
||||
public function addTask(TaskInterface $task)
|
||||
{
|
||||
$this->getCollection()->add($task);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add arbitrary code to execute as a task.
|
||||
*
|
||||
* @see \Robo\Collection\CollectionInterface::addCode
|
||||
*
|
||||
* @param callable $code
|
||||
* @param int|string $name
|
||||
* @return $this
|
||||
*/
|
||||
public function addCode(callable $code, $name = \Robo\Collection\CollectionInterface::UNNAMEDTASK)
|
||||
{
|
||||
$this->getCollection()->addCode($code, $name);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add a list of tasks to our task collection.
|
||||
*
|
||||
* @param TaskInterface[] $tasks
|
||||
* An array of tasks to run with rollback protection
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function addTaskList(array $tasks)
|
||||
{
|
||||
$this->getCollection()->addTaskList($tasks);
|
||||
return $this;
|
||||
}
|
||||
|
||||
public function rollback(TaskInterface $task)
|
||||
{
|
||||
// Ensure that we have a collection if we are going to add
|
||||
// a rollback function.
|
||||
$this->getCollection()->rollback($task);
|
||||
return $this;
|
||||
}
|
||||
|
||||
public function rollbackCode(callable $rollbackCode)
|
||||
{
|
||||
$this->getCollection()->rollbackCode($rollbackCode);
|
||||
return $this;
|
||||
}
|
||||
|
||||
public function completion(TaskInterface $task)
|
||||
{
|
||||
$this->getCollection()->completion($task);
|
||||
return $this;
|
||||
}
|
||||
|
||||
public function completionCode(callable $completionCode)
|
||||
{
|
||||
$this->getCollection()->completionCode($completionCode);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $text
|
||||
* @param array $context
|
||||
* @param string $level
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function progressMessage($text, $context = [], $level = LogLevel::NOTICE)
|
||||
{
|
||||
$this->getCollection()->progressMessage($text, $context, $level);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Robo\Collection\NestedCollectionInterface $parentCollection
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setParentCollection(NestedCollectionInterface $parentCollection)
|
||||
{
|
||||
$this->getCollection()->setParentCollection($parentCollection);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Called by the factory method of each task; adds the current
|
||||
* task to the task builder.
|
||||
*
|
||||
* TODO: protected
|
||||
*
|
||||
* @param TaskInterface $task
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function addTaskToCollection($task)
|
||||
{
|
||||
// Postpone creation of the collection until the second time
|
||||
// we are called. At that time, $this->currentTask will already
|
||||
// be populated. We call 'getCollection()' so that it will
|
||||
// create the collection and add the current task to it.
|
||||
// Note, however, that if our only tasks implements NestedCollectionInterface,
|
||||
// then we should force this builder to use a collection.
|
||||
if (!$this->collection && (isset($this->currentTask) || ($task instanceof NestedCollectionInterface))) {
|
||||
$this->getCollection();
|
||||
}
|
||||
$this->currentTask = $task;
|
||||
if ($this->collection) {
|
||||
$this->collection->add($task);
|
||||
}
|
||||
return $this;
|
||||
}
|
||||
|
||||
public function getState()
|
||||
{
|
||||
$collection = $this->getCollection();
|
||||
return $collection->getState();
|
||||
}
|
||||
|
||||
public function storeState($key, $source = '')
|
||||
{
|
||||
return $this->callCollectionStateFuntion(__FUNCTION__, func_get_args());
|
||||
}
|
||||
|
||||
public function deferTaskConfiguration($functionName, $stateKey)
|
||||
{
|
||||
return $this->callCollectionStateFuntion(__FUNCTION__, func_get_args());
|
||||
}
|
||||
|
||||
public function defer($callback)
|
||||
{
|
||||
return $this->callCollectionStateFuntion(__FUNCTION__, func_get_args());
|
||||
}
|
||||
|
||||
protected function callCollectionStateFuntion($functionName, $args)
|
||||
{
|
||||
$currentTask = ($this->currentTask instanceof WrappedTaskInterface) ? $this->currentTask->original() : $this->currentTask;
|
||||
|
||||
array_unshift($args, $currentTask);
|
||||
$collection = $this->getCollection();
|
||||
$fn = [$collection, $functionName];
|
||||
|
||||
call_user_func_array($fn, $args);
|
||||
return $this;
|
||||
}
|
||||
|
||||
public function setVerbosityThreshold($verbosityThreshold)
|
||||
{
|
||||
$currentTask = ($this->currentTask instanceof WrappedTaskInterface) ? $this->currentTask->original() : $this->currentTask;
|
||||
if ($currentTask) {
|
||||
$currentTask->setVerbosityThreshold($verbosityThreshold);
|
||||
return $this;
|
||||
}
|
||||
parent::setVerbosityThreshold($verbosityThreshold);
|
||||
return $this;
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Return the current task for this collection builder.
|
||||
* TODO: Not needed?
|
||||
*
|
||||
* @return \Robo\Contract\TaskInterface
|
||||
*/
|
||||
public function getCollectionBuilderCurrentTask()
|
||||
{
|
||||
return $this->currentTask;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a new builder with its own task collection
|
||||
*
|
||||
* @return CollectionBuilder
|
||||
*/
|
||||
public function newBuilder()
|
||||
{
|
||||
$collectionBuilder = new self($this->commandFile);
|
||||
$collectionBuilder->inflect($this);
|
||||
$collectionBuilder->simulated($this->isSimulated());
|
||||
$collectionBuilder->setVerbosityThreshold($this->verbosityThreshold());
|
||||
$collectionBuilder->setState($this->getState());
|
||||
|
||||
return $collectionBuilder;
|
||||
}
|
||||
|
||||
/**
|
||||
* Calling the task builder with methods of the current
|
||||
* task calls through to that method of the task.
|
||||
*
|
||||
* There is extra complexity in this function that could be
|
||||
* simplified if we attached the 'LoadAllTasks' and custom tasks
|
||||
* to the collection builder instead of the RoboFile. While that
|
||||
* change would be a better design overall, it would require that
|
||||
* the user do a lot more work to set up and use custom tasks.
|
||||
* We therefore take on some additional complexity here in order
|
||||
* to allow users to maintain their tasks in their RoboFile, which
|
||||
* is much more convenient.
|
||||
*
|
||||
* Calls to $this->collectionBuilder()->taskFoo() cannot be made
|
||||
* directly because all of the task methods are protected. These
|
||||
* calls will therefore end up here. If the method name begins
|
||||
* with 'task', then it is eligible to be used with the builder.
|
||||
*
|
||||
* When we call getBuiltTask, below, it will use the builder attached
|
||||
* to the commandfile to build the task. However, this is not what we
|
||||
* want: the task needs to be built from THIS collection builder, so that
|
||||
* it will be affected by whatever state is active in this builder.
|
||||
* To do this, we have two choices: 1) save and restore the builder
|
||||
* in the commandfile, or 2) clone the commandfile and set this builder
|
||||
* on the copy. 1) is vulnerable to failure in multithreaded environments
|
||||
* (currently not supported), while 2) might cause confusion if there
|
||||
* is shared state maintained in the commandfile, which is in the
|
||||
* domain of the user.
|
||||
*
|
||||
* Note that even though we are setting up the commandFile to
|
||||
* use this builder, getBuiltTask always creates a new builder
|
||||
* (which is constructed using all of the settings from the
|
||||
* commandFile's builder), and the new task is added to that.
|
||||
* We therefore need to transfer the newly built task into this
|
||||
* builder. The temporary builder is discarded.
|
||||
*
|
||||
* @param string $fn
|
||||
* @param array $args
|
||||
*
|
||||
* @return $this|mixed
|
||||
*/
|
||||
public function __call($fn, $args)
|
||||
{
|
||||
if (preg_match('#^task[A-Z]#', $fn) && (method_exists($this->commandFile, 'getBuiltTask'))) {
|
||||
$saveBuilder = $this->commandFile->getBuilder();
|
||||
$this->commandFile->setBuilder($this);
|
||||
$temporaryBuilder = $this->commandFile->getBuiltTask($fn, $args);
|
||||
$this->commandFile->setBuilder($saveBuilder);
|
||||
if (!$temporaryBuilder) {
|
||||
throw new \BadMethodCallException("No such method $fn: task does not exist in " . get_class($this->commandFile));
|
||||
}
|
||||
$temporaryBuilder->getCollection()->transferTasks($this);
|
||||
return $this;
|
||||
}
|
||||
if (!isset($this->currentTask)) {
|
||||
throw new \BadMethodCallException("No such method $fn: current task undefined in collection builder.");
|
||||
}
|
||||
// If the method called is a method of the current task,
|
||||
// then call through to the current task's setter method.
|
||||
$result = call_user_func_array([$this->currentTask, $fn], $args);
|
||||
|
||||
// If something other than a setter method is called, then return its result.
|
||||
$currentTask = ($this->currentTask instanceof WrappedTaskInterface) ? $this->currentTask->original() : $this->currentTask;
|
||||
if (isset($result) && ($result !== $currentTask)) {
|
||||
return $result;
|
||||
}
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Construct the desired task and add it to this builder.
|
||||
*
|
||||
* @param string|object $name
|
||||
* @param array $args
|
||||
*
|
||||
* @return \Robo\Collection\CollectionBuilder
|
||||
*/
|
||||
public function build($name, $args)
|
||||
{
|
||||
$reflection = new ReflectionClass($name);
|
||||
$task = $reflection->newInstanceArgs($args);
|
||||
if (!$task) {
|
||||
throw new RuntimeException("Can not construct task $name");
|
||||
}
|
||||
$task = $this->fixTask($task, $args);
|
||||
$this->configureTask($name, $task);
|
||||
return $this->addTaskToCollection($task);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param InflectionInterface $task
|
||||
* @param array $args
|
||||
*
|
||||
* @return \Robo\Collection\CompletionWrapper|\Robo\Task\Simulator
|
||||
*/
|
||||
protected function fixTask($task, $args)
|
||||
{
|
||||
if ($task instanceof InflectionInterface) {
|
||||
$task->inflect($this);
|
||||
}
|
||||
if ($task instanceof BuilderAwareInterface) {
|
||||
$task->setBuilder($this);
|
||||
}
|
||||
if ($task instanceof VerbosityThresholdInterface) {
|
||||
$task->setVerbosityThreshold($this->verbosityThreshold());
|
||||
}
|
||||
|
||||
// Do not wrap our wrappers.
|
||||
if ($task instanceof CompletionWrapper || $task instanceof Simulator) {
|
||||
return $task;
|
||||
}
|
||||
|
||||
// Remember whether or not this is a task before
|
||||
// it gets wrapped in any decorator.
|
||||
$isTask = $task instanceof TaskInterface;
|
||||
$isCollection = $task instanceof NestedCollectionInterface;
|
||||
|
||||
// If the task implements CompletionInterface, ensure
|
||||
// that its 'complete' method is called when the application
|
||||
// terminates -- but only if its 'run' method is called
|
||||
// first. If the task is added to a collection, then the
|
||||
// task will be unwrapped via its `original` method, and
|
||||
// it will be re-wrapped with a new completion wrapper for
|
||||
// its new collection.
|
||||
if ($task instanceof CompletionInterface) {
|
||||
$task = new CompletionWrapper(Temporary::getCollection(), $task);
|
||||
}
|
||||
|
||||
// If we are in simulated mode, then wrap any task in
|
||||
// a TaskSimulator.
|
||||
if ($isTask && !$isCollection && ($this->isSimulated())) {
|
||||
$task = new \Robo\Task\Simulator($task, $args);
|
||||
$task->inflect($this);
|
||||
}
|
||||
|
||||
return $task;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check to see if there are any setter methods defined in configuration
|
||||
* for this task.
|
||||
*/
|
||||
protected function configureTask($taskClass, $task)
|
||||
{
|
||||
$taskClass = static::configClassIdentifier($taskClass);
|
||||
$configurationApplier = new ConfigForSetters($this->getConfig(), $taskClass, 'task.');
|
||||
$configurationApplier->apply($task, 'settings');
|
||||
|
||||
// TODO: If we counted each instance of $taskClass that was called from
|
||||
// this builder, then we could also apply configuration from
|
||||
// "task.{$taskClass}[$N].settings"
|
||||
|
||||
// TODO: If the builder knew what the current command name was,
|
||||
// then we could also search for task configuration under
|
||||
// command-specific keys such as "command.{$commandname}.task.{$taskClass}.settings".
|
||||
}
|
||||
|
||||
/**
|
||||
* When we run the collection builder, run everything in the collection.
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
public function run()
|
||||
{
|
||||
$this->startTimer();
|
||||
$result = $this->runTasks();
|
||||
$this->stopTimer();
|
||||
$result['time'] = $this->getExecutionTime();
|
||||
$result->mergeData($this->getState()->getData());
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* If there is a single task, run it; if there is a collection, run
|
||||
* all of its tasks.
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
protected function runTasks()
|
||||
{
|
||||
if (!$this->collection && $this->currentTask) {
|
||||
$result = $this->currentTask->run();
|
||||
return Result::ensureResult($this->currentTask, $result);
|
||||
}
|
||||
return $this->getCollection()->run();
|
||||
}
|
||||
|
||||
/**
|
||||
* @return string
|
||||
*/
|
||||
public function getCommand()
|
||||
{
|
||||
if (!$this->collection && $this->currentTask) {
|
||||
$task = $this->currentTask;
|
||||
$task = ($task instanceof WrappedTaskInterface) ? $task->original() : $task;
|
||||
if ($task instanceof CommandInterface) {
|
||||
return $task->getCommand();
|
||||
}
|
||||
}
|
||||
|
||||
return $this->getCollection()->getCommand();
|
||||
}
|
||||
|
||||
/**
|
||||
* @return \Robo\Collection\Collection
|
||||
*/
|
||||
public function original()
|
||||
{
|
||||
return $this->getCollection();
|
||||
}
|
||||
|
||||
/**
|
||||
* Return the collection of tasks associated with this builder.
|
||||
*
|
||||
* @return CollectionInterface
|
||||
*/
|
||||
public function getCollection()
|
||||
{
|
||||
if (!isset($this->collection)) {
|
||||
$this->collection = new Collection();
|
||||
$this->collection->inflect($this);
|
||||
$this->collection->setState($this->getState());
|
||||
$this->collection->setProgressBarAutoDisplayInterval($this->getConfig()->get(Config::PROGRESS_BAR_AUTO_DISPLAY_INTERVAL));
|
||||
|
||||
if (isset($this->currentTask)) {
|
||||
$this->collection->add($this->currentTask);
|
||||
}
|
||||
}
|
||||
return $this->collection;
|
||||
}
|
||||
}
|
||||
151
vendor/consolidation/robo/src/Collection/CollectionInterface.php
vendored
Normal file
151
vendor/consolidation/robo/src/Collection/CollectionInterface.php
vendored
Normal file
|
|
@ -0,0 +1,151 @@
|
|||
<?php
|
||||
namespace Robo\Collection;
|
||||
|
||||
use Psr\Log\LogLevel;
|
||||
use Robo\Contract\TaskInterface;
|
||||
|
||||
interface CollectionInterface extends NestedCollectionInterface
|
||||
{
|
||||
/**
|
||||
* Unnamed tasks are assigned an arbitrary numeric index
|
||||
* in the task list. Any numeric value may be used, but the
|
||||
* UNNAMEDTASK constant is recommended for clarity.
|
||||
*
|
||||
* @var int
|
||||
*/
|
||||
const UNNAMEDTASK = 0;
|
||||
|
||||
/**
|
||||
* Add a task or a list of tasks to our task collection. Each task
|
||||
* will run via its 'run()' method once (and if) all of the tasks
|
||||
* added before it complete successfully. If the task also implements
|
||||
* RollbackInterface, then it will be rolled back via its 'rollback()'
|
||||
* method ONLY if its 'run()' method completes successfully, and some
|
||||
* task added after it fails.
|
||||
*
|
||||
* @param TaskInterface $task
|
||||
* The task to add to our collection.
|
||||
* @param int|string $name
|
||||
* An optional name for the task -- missing or UNNAMEDTASK for unnamed tasks.
|
||||
* Names are used for positioning before and after tasks.
|
||||
*
|
||||
* @return CollectionInterface
|
||||
*/
|
||||
public function add(TaskInterface $task, $name = self::UNNAMEDTASK);
|
||||
|
||||
/**
|
||||
* Add arbitrary code to execute as a task.
|
||||
*
|
||||
* @param callable $code Code to execute as a task
|
||||
* @param int|string $name
|
||||
* An optional name for the task -- missing or UNNAMEDTASK for unnamed tasks.
|
||||
* Names are used for positioning before and after tasks.
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function addCode(callable $code, $name = self::UNNAMEDTASK);
|
||||
|
||||
/**
|
||||
* Add arbitrary code that will be called once for every item in the
|
||||
* provided array or iterable object. If the function result of the
|
||||
* provided callback is a TaskInterface or Collection, then it will be
|
||||
* executed.
|
||||
*
|
||||
* @param CollectionInterface|array $iterable A collection of things to iterate
|
||||
* @param $code $code A callback function to call for each item in the collection.
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function addIterable($iterable, callable $code);
|
||||
|
||||
/**
|
||||
* Add a rollback task to our task collection. A rollback task
|
||||
* will execute ONLY if all of the tasks added before it complete
|
||||
* successfully, AND some task added after it fails.
|
||||
*
|
||||
* @param TaskInterface $rollbackTask
|
||||
* The rollback task to add. Note that the 'run()' method of the
|
||||
* task executes, not its 'rollback()' method. To use the 'rollback()'
|
||||
* method, add the task via 'Collection::add()' instead.
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function rollback(TaskInterface $rollbackTask);
|
||||
|
||||
/**
|
||||
* Add arbitrary code to execute as a rollback.
|
||||
*
|
||||
* @param callable $rollbackTask Code to execute during rollback processing
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function rollbackCode(callable $rollbackTask);
|
||||
|
||||
/**
|
||||
* Add a completion task to our task collection. A completion task
|
||||
* will execute EITHER after all tasks succeed, OR immediatley after
|
||||
* any task fails. Completion tasks never cause errors to be returned
|
||||
* from Collection::run(), even if they fail.
|
||||
*
|
||||
* @param TaskInterface $completionTask
|
||||
* The completion task to add. Note that the 'run()' method of the
|
||||
* task executes, just as if the task was added normally.
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function completion(TaskInterface $completionTask);
|
||||
|
||||
/**
|
||||
* Add arbitrary code to execute as a completion.
|
||||
*
|
||||
* @param callable $completionTask Code to execute after collection completes
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function completionCode(callable $completionTask);
|
||||
|
||||
/**
|
||||
* Add a task before an existing named task.
|
||||
*
|
||||
* @param string $name
|
||||
* The name of the task to insert before. The named task MUST exist.
|
||||
* @param callable|TaskInterface $task
|
||||
* The task to add.
|
||||
* @param int|string $nameOfTaskToAdd
|
||||
* The name of the task to add. If not provided, will be associated
|
||||
* with the named task it was added before.
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function before($name, $task, $nameOfTaskToAdd = self::UNNAMEDTASK);
|
||||
|
||||
/**
|
||||
* Add a task after an existing named task.
|
||||
*
|
||||
* @param string $name
|
||||
* The name of the task to insert before. The named task MUST exist.
|
||||
* @param callable|TaskInterface $task
|
||||
* The task to add.
|
||||
* @param int|string $nameOfTaskToAdd
|
||||
* The name of the task to add. If not provided, will be associated
|
||||
* with the named task it was added after.
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function after($name, $task, $nameOfTaskToAdd = self::UNNAMEDTASK);
|
||||
|
||||
/**
|
||||
* Print a progress message after Collection::run() has executed
|
||||
* all of the tasks that were added prior to the point when this
|
||||
* method was called. If one of the previous tasks fail, then this
|
||||
* message will not be printed.
|
||||
*
|
||||
* @param string $text Message to print.
|
||||
* @param array $context Extra context data for use by the logger. Note
|
||||
* that the data from the collection state is merged with the provided context.
|
||||
* @param \Psr\Log\LogLevel|string $level The log level to print the information at. Default is NOTICE.
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function progressMessage($text, $context = [], $level = LogLevel::NOTICE);
|
||||
}
|
||||
35
vendor/consolidation/robo/src/Collection/CollectionProcessHook.php
vendored
Normal file
35
vendor/consolidation/robo/src/Collection/CollectionProcessHook.php
vendored
Normal file
|
|
@ -0,0 +1,35 @@
|
|||
<?php
|
||||
namespace Robo\Collection;
|
||||
|
||||
use Consolidation\AnnotatedCommand\Hooks\ProcessResultInterface;
|
||||
use Consolidation\AnnotatedCommand\CommandData;
|
||||
use Robo\Contract\TaskInterface;
|
||||
use Robo\Result;
|
||||
|
||||
/**
|
||||
* The collection process hook is added to the annotation command
|
||||
* hook manager in Runner::configureContainer(). This hook will be
|
||||
* called every time a command runs. If the command result is a
|
||||
* \Robo\Contract\TaskInterface (in particular, \Robo\Collection\Collection),
|
||||
* then we run the collection, and return the result. We ignore results
|
||||
* of any other type.
|
||||
*/
|
||||
class CollectionProcessHook implements ProcessResultInterface
|
||||
{
|
||||
/**
|
||||
* @param \Robo\Result|\Robo\Contract\TaskInterface $result
|
||||
* @param \Consolidation\AnnotatedCommand\CommandData $commandData
|
||||
*
|
||||
* @return null|\Robo\Result
|
||||
*/
|
||||
public function process($result, CommandData $commandData)
|
||||
{
|
||||
if ($result instanceof TaskInterface) {
|
||||
try {
|
||||
return $result->run();
|
||||
} catch (\Exception $e) {
|
||||
return Result::fromException($result, $e);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
106
vendor/consolidation/robo/src/Collection/CompletionWrapper.php
vendored
Normal file
106
vendor/consolidation/robo/src/Collection/CompletionWrapper.php
vendored
Normal file
|
|
@ -0,0 +1,106 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Collection;
|
||||
|
||||
use Robo\Task\BaseTask;
|
||||
use Robo\Contract\TaskInterface;
|
||||
use Robo\Contract\RollbackInterface;
|
||||
use Robo\Contract\CompletionInterface;
|
||||
use Robo\Contract\WrappedTaskInterface;
|
||||
|
||||
/**
|
||||
* Creates a task wrapper that will manage rollback and collection
|
||||
* management to a task when it runs. Tasks are automatically
|
||||
* wrapped in a CompletionWrapper when added to a task collection.
|
||||
*
|
||||
* Clients may need to wrap their task in a CompletionWrapper if it
|
||||
* creates temporary objects.
|
||||
*
|
||||
* @see \Robo\Task\Filesystem\loadTasks::taskTmpDir
|
||||
*/
|
||||
class CompletionWrapper extends BaseTask implements WrappedTaskInterface
|
||||
{
|
||||
/**
|
||||
* @var \Robo\Collection\Collection
|
||||
*/
|
||||
private $collection;
|
||||
|
||||
/**
|
||||
* @var \Robo\Contract\TaskInterface
|
||||
*/
|
||||
private $task;
|
||||
|
||||
/**
|
||||
* @var NULL|\Robo\Contract\TaskInterface
|
||||
*/
|
||||
private $rollbackTask;
|
||||
|
||||
/**
|
||||
* Create a CompletionWrapper.
|
||||
*
|
||||
* Temporary tasks are always wrapped in a CompletionWrapper, as are
|
||||
* any tasks that are added to a collection. If a temporary task
|
||||
* is added to a collection, then it is first unwrapped from its
|
||||
* CompletionWrapper (via its original() method), and then added to a
|
||||
* new CompletionWrapper for the collection it is added to.
|
||||
*
|
||||
* In this way, when the CompletionWrapper is finally executed, the
|
||||
* task's rollback and completion handlers will be registered on
|
||||
* whichever collection it was registered on.
|
||||
*
|
||||
* @todo Why not CollectionInterface the type of the $collection argument?
|
||||
*
|
||||
* @param \Robo\Collection\Collection $collection
|
||||
* @param \Robo\Contract\TaskInterface $task
|
||||
* @param \Robo\Contract\TaskInterface|NULL $rollbackTask
|
||||
*/
|
||||
public function __construct(Collection $collection, TaskInterface $task, TaskInterface $rollbackTask = null)
|
||||
{
|
||||
$this->collection = $collection;
|
||||
$this->task = ($task instanceof WrappedTaskInterface) ? $task->original() : $task;
|
||||
$this->rollbackTask = $rollbackTask;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function original()
|
||||
{
|
||||
return $this->task;
|
||||
}
|
||||
|
||||
/**
|
||||
* Before running this task, register its rollback and completion
|
||||
* handlers on its collection. The reason this class exists is to
|
||||
* defer registration of rollback and completion tasks until 'run()' time.
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
public function run()
|
||||
{
|
||||
if ($this->rollbackTask) {
|
||||
$this->collection->registerRollback($this->rollbackTask);
|
||||
}
|
||||
if ($this->task instanceof RollbackInterface) {
|
||||
$this->collection->registerRollback(new CallableTask([$this->task, 'rollback'], $this->task));
|
||||
}
|
||||
if ($this->task instanceof CompletionInterface) {
|
||||
$this->collection->registerCompletion(new CallableTask([$this->task, 'complete'], $this->task));
|
||||
}
|
||||
|
||||
return $this->task->run();
|
||||
}
|
||||
|
||||
/**
|
||||
* Make this wrapper object act like the class it wraps.
|
||||
*
|
||||
* @param string $function
|
||||
* @param array $args
|
||||
*
|
||||
* @return mixed
|
||||
*/
|
||||
public function __call($function, $args)
|
||||
{
|
||||
return call_user_func_array(array($this->task, $function), $args);
|
||||
}
|
||||
}
|
||||
116
vendor/consolidation/robo/src/Collection/Element.php
vendored
Normal file
116
vendor/consolidation/robo/src/Collection/Element.php
vendored
Normal file
|
|
@ -0,0 +1,116 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Collection;
|
||||
|
||||
use Robo\Contract\TaskInterface;
|
||||
use Robo\Contract\WrappedTaskInterface;
|
||||
use Robo\Contract\ProgressIndicatorAwareInterface;
|
||||
|
||||
/**
|
||||
* One element in a collection. Each element consists of a task
|
||||
* all of its before tasks, and all of its after tasks.
|
||||
*
|
||||
* This class is internal to Collection; it should not be used directly.
|
||||
*/
|
||||
class Element
|
||||
{
|
||||
/**
|
||||
* @var \Robo\Contract\TaskInterface
|
||||
*/
|
||||
protected $task;
|
||||
|
||||
/**
|
||||
* @var array
|
||||
*/
|
||||
protected $before = [];
|
||||
|
||||
/**
|
||||
* @var array
|
||||
*/
|
||||
protected $after = [];
|
||||
|
||||
public function __construct(TaskInterface $task)
|
||||
{
|
||||
$this->task = $task;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param mixed $before
|
||||
* @param string $name
|
||||
*/
|
||||
public function before($before, $name)
|
||||
{
|
||||
if ($name) {
|
||||
$this->before[$name] = $before;
|
||||
} else {
|
||||
$this->before[] = $before;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @param mixed $after
|
||||
* @param string $name
|
||||
*/
|
||||
public function after($after, $name)
|
||||
{
|
||||
if ($name) {
|
||||
$this->after[$name] = $after;
|
||||
} else {
|
||||
$this->after[] = $after;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array
|
||||
*/
|
||||
public function getBefore()
|
||||
{
|
||||
return $this->before;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array
|
||||
*/
|
||||
public function getAfter()
|
||||
{
|
||||
return $this->after;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return \Robo\Contract\TaskInterface
|
||||
*/
|
||||
public function getTask()
|
||||
{
|
||||
return $this->task;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array
|
||||
*/
|
||||
public function getTaskList()
|
||||
{
|
||||
return array_merge($this->getBefore(), [$this->getTask()], $this->getAfter());
|
||||
}
|
||||
|
||||
/**
|
||||
* @return int
|
||||
*/
|
||||
public function progressIndicatorSteps()
|
||||
{
|
||||
$steps = 0;
|
||||
foreach ($this->getTaskList() as $task) {
|
||||
if ($task instanceof WrappedTaskInterface) {
|
||||
$task = $task->original();
|
||||
}
|
||||
// If the task is a ProgressIndicatorAwareInterface, then it
|
||||
// will advance the progress indicator a number of times.
|
||||
if ($task instanceof ProgressIndicatorAwareInterface) {
|
||||
$steps += $task->progressIndicatorSteps();
|
||||
}
|
||||
// We also advance the progress indicator once regardless
|
||||
// of whether it is progress-indicator aware or not.
|
||||
$steps++;
|
||||
}
|
||||
return $steps;
|
||||
}
|
||||
}
|
||||
12
vendor/consolidation/robo/src/Collection/NestedCollectionInterface.php
vendored
Normal file
12
vendor/consolidation/robo/src/Collection/NestedCollectionInterface.php
vendored
Normal file
|
|
@ -0,0 +1,12 @@
|
|||
<?php
|
||||
namespace Robo\Collection;
|
||||
|
||||
interface NestedCollectionInterface
|
||||
{
|
||||
/**
|
||||
* @param \Robo\Collection\NestedCollectionInterface $parentCollection
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setParentCollection(NestedCollectionInterface $parentCollection);
|
||||
}
|
||||
214
vendor/consolidation/robo/src/Collection/TaskForEach.php
vendored
Normal file
214
vendor/consolidation/robo/src/Collection/TaskForEach.php
vendored
Normal file
|
|
@ -0,0 +1,214 @@
|
|||
<?php
|
||||
namespace Robo\Collection;
|
||||
|
||||
use Robo\Result;
|
||||
use Robo\TaskInfo;
|
||||
use Robo\Task\BaseTask;
|
||||
use Robo\Contract\BuilderAwareInterface;
|
||||
use Robo\Common\BuilderAwareTrait;
|
||||
|
||||
/**
|
||||
* Creates a task wrapper that converts any Callable into an
|
||||
* object that will execute the callback once for each item in the
|
||||
* provided collection.
|
||||
*
|
||||
* It is not necessary to use this class directly; Collection::addIterable
|
||||
* will automatically create one when it is called.
|
||||
*/
|
||||
class TaskForEach extends BaseTask implements NestedCollectionInterface, BuilderAwareInterface
|
||||
{
|
||||
use BuilderAwareTrait;
|
||||
|
||||
/**
|
||||
* @var callable[]
|
||||
*/
|
||||
protected $functionStack = [];
|
||||
|
||||
/**
|
||||
* @var callable[]
|
||||
*/
|
||||
protected $countingStack = [];
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
protected $message;
|
||||
|
||||
/**
|
||||
* @var array
|
||||
*/
|
||||
protected $context = [];
|
||||
|
||||
/**
|
||||
* @var array $iterable
|
||||
*/
|
||||
protected $iterable = [];
|
||||
|
||||
/**
|
||||
* @var \Robo\Collection\NestedCollectionInterface
|
||||
*/
|
||||
protected $parentCollection;
|
||||
|
||||
/**
|
||||
* @var array $iterable
|
||||
*/
|
||||
public function __construct($iterable = [])
|
||||
{
|
||||
$this->setIterable($iterable);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array $iterable
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setIterable($iterable)
|
||||
{
|
||||
$this->iterable = $iterable;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $message
|
||||
* @param array $context
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function iterationMessage($message, $context = [])
|
||||
{
|
||||
$this->message = $message;
|
||||
$this->context = $context + ['name' => 'Progress'];
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int|string $key
|
||||
* @param mixed $value
|
||||
*/
|
||||
protected function showIterationMessage($key, $value)
|
||||
{
|
||||
if ($this->message) {
|
||||
$context = ['key' => $key, 'value' => $value];
|
||||
$context += $this->context;
|
||||
$context += TaskInfo::getTaskContext($this);
|
||||
$this->printTaskInfo($this->message, $context);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @param callable $fn
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function withEachKeyValueCall(callable $fn)
|
||||
{
|
||||
$this->functionStack[] = $fn;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param callable $fn
|
||||
*
|
||||
* @return \Robo\Collection\TaskForEach
|
||||
*/
|
||||
public function call(callable $fn)
|
||||
{
|
||||
return $this->withEachKeyValueCall(
|
||||
function ($key, $value) use ($fn) {
|
||||
return call_user_func($fn, $value);
|
||||
}
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param callable $fn
|
||||
*
|
||||
* @return \Robo\Collection\TaskForEach
|
||||
*/
|
||||
public function withBuilder(callable $fn)
|
||||
{
|
||||
$this->countingStack[] =
|
||||
function ($key, $value) use ($fn) {
|
||||
// Create a new builder for every iteration
|
||||
$builder = $this->collectionBuilder();
|
||||
// The user function should build task operations using
|
||||
// the $key / $value parameters; we will call run() on
|
||||
// the builder thus constructed.
|
||||
call_user_func($fn, $builder, $key, $value);
|
||||
return $builder->getCollection()->progressIndicatorSteps();
|
||||
};
|
||||
return $this->withEachKeyValueCall(
|
||||
function ($key, $value) use ($fn) {
|
||||
// Create a new builder for every iteration
|
||||
$builder = $this->collectionBuilder()
|
||||
->setParentCollection($this->parentCollection);
|
||||
// The user function should build task operations using
|
||||
// the $key / $value parameters; we will call run() on
|
||||
// the builder thus constructed.
|
||||
call_user_func($fn, $builder, $key, $value);
|
||||
return $builder->run();
|
||||
}
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function setParentCollection(NestedCollectionInterface $parentCollection)
|
||||
{
|
||||
$this->parentCollection = $parentCollection;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function progressIndicatorSteps()
|
||||
{
|
||||
$multiplier = count($this->functionStack);
|
||||
if (!empty($this->countingStack) && count($this->iterable)) {
|
||||
$value = reset($this->iterable);
|
||||
$key = key($this->iterable);
|
||||
foreach ($this->countingStack as $fn) {
|
||||
$multiplier += call_user_func($fn, $key, $value);
|
||||
}
|
||||
}
|
||||
return count($this->iterable) * $multiplier;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function run()
|
||||
{
|
||||
$finalResult = Result::success($this);
|
||||
$this->startProgressIndicator();
|
||||
foreach ($this->iterable as $key => $value) {
|
||||
$this->showIterationMessage($key, $value);
|
||||
try {
|
||||
foreach ($this->functionStack as $fn) {
|
||||
$result = call_user_func($fn, $key, $value);
|
||||
$this->advanceProgressIndicator();
|
||||
if (!isset($result)) {
|
||||
$result = Result::success($this);
|
||||
}
|
||||
// If the function returns a result, it must either return
|
||||
// a \Robo\Result or an exit code. In the later case, we
|
||||
// convert it to a \Robo\Result.
|
||||
if (!$result instanceof Result) {
|
||||
$result = new Result($this, $result);
|
||||
}
|
||||
if (!$result->wasSuccessful()) {
|
||||
return $result;
|
||||
}
|
||||
$finalResult = $result->merge($finalResult);
|
||||
}
|
||||
} catch (\Exception $e) {
|
||||
return Result::fromException($result, $e);
|
||||
}
|
||||
}
|
||||
$this->stopProgressIndicator();
|
||||
return $finalResult;
|
||||
}
|
||||
}
|
||||
57
vendor/consolidation/robo/src/Collection/Temporary.php
vendored
Normal file
57
vendor/consolidation/robo/src/Collection/Temporary.php
vendored
Normal file
|
|
@ -0,0 +1,57 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Collection;
|
||||
|
||||
/**
|
||||
* The temporary collection keeps track of the global collection of
|
||||
* temporary cleanup tasks in instances where temporary-generating
|
||||
* tasks are executed directly via their run() method, rather than
|
||||
* as part of a collection.
|
||||
*
|
||||
* In general, temporary-generating tasks should always be run in
|
||||
* a collection, as the cleanup functions registered with the
|
||||
* Temporary collection will not run until requested.
|
||||
*
|
||||
* Since the results could be undefined if cleanup functions were called
|
||||
* at arbitrary times during a program's execution, cleanup should only
|
||||
* be done immeidately prior to program termination, when there is no
|
||||
* danger of cleaning up after some unrelated task.
|
||||
*
|
||||
* An application need never use Temporary directly, save to
|
||||
* call Temporary::wrap() inside loadTasks or loadShortcuts, and
|
||||
* to call Temporary::complete() immediately prior to terminating.
|
||||
* This is recommended, but not required; this function will be
|
||||
* registered as a shutdown function, and called on termination.
|
||||
*/
|
||||
class Temporary
|
||||
{
|
||||
private static $collection;
|
||||
|
||||
/**
|
||||
* Provides direct access to the collection of temporaries, if necessary.
|
||||
*/
|
||||
public static function getCollection()
|
||||
{
|
||||
if (!static::$collection) {
|
||||
static::$collection = \Robo\Robo::getContainer()->get('collection');
|
||||
register_shutdown_function(function () {
|
||||
static::complete();
|
||||
});
|
||||
}
|
||||
|
||||
return static::$collection;
|
||||
}
|
||||
|
||||
/**
|
||||
* Call the complete method of all of the registered objects.
|
||||
*/
|
||||
public static function complete()
|
||||
{
|
||||
// Run the collection of tasks. This will also run the
|
||||
// completion tasks.
|
||||
$collection = static::getCollection();
|
||||
$collection->run();
|
||||
// Make sure that our completion functions do not run twice.
|
||||
$collection->reset();
|
||||
}
|
||||
}
|
||||
17
vendor/consolidation/robo/src/Collection/loadTasks.php
vendored
Normal file
17
vendor/consolidation/robo/src/Collection/loadTasks.php
vendored
Normal file
|
|
@ -0,0 +1,17 @@
|
|||
<?php
|
||||
namespace Robo\Collection;
|
||||
|
||||
trait loadTasks
|
||||
{
|
||||
/**
|
||||
* Run a callback function on each item in a collection
|
||||
*
|
||||
* @param array $collection
|
||||
*
|
||||
* @return \Robo\Collection\TaskForEach|\Robo\Collection\CollectionBuilder
|
||||
*/
|
||||
protected function taskForEach($collection = [])
|
||||
{
|
||||
return $this->task(TaskForEach::class, $collection);
|
||||
}
|
||||
}
|
||||
45
vendor/consolidation/robo/src/Common/BuilderAwareTrait.php
vendored
Normal file
45
vendor/consolidation/robo/src/Common/BuilderAwareTrait.php
vendored
Normal file
|
|
@ -0,0 +1,45 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Common;
|
||||
|
||||
use Robo\Collection\CollectionBuilder;
|
||||
|
||||
trait BuilderAwareTrait
|
||||
{
|
||||
/**
|
||||
* @var \Robo\Collection\CollectionBuilder
|
||||
*/
|
||||
protected $builder;
|
||||
|
||||
/**
|
||||
* @see \Robo\Contract\BuilderAwareInterface::setBuilder()
|
||||
*
|
||||
* @param \Robo\Collection\CollectionBuilder $builder
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setBuilder(CollectionBuilder $builder)
|
||||
{
|
||||
$this->builder = $builder;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @see \Robo\Contract\BuilderAwareInterface::getBuilder()
|
||||
*
|
||||
* @return \Robo\Collection\CollectionBuilder
|
||||
*/
|
||||
public function getBuilder()
|
||||
{
|
||||
return $this->builder;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return \Robo\Collection\CollectionBuilder
|
||||
*/
|
||||
protected function collectionBuilder()
|
||||
{
|
||||
return $this->getBuilder()->newBuilder();
|
||||
}
|
||||
}
|
||||
130
vendor/consolidation/robo/src/Common/CommandArguments.php
vendored
Normal file
130
vendor/consolidation/robo/src/Common/CommandArguments.php
vendored
Normal file
|
|
@ -0,0 +1,130 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
use Robo\Common\ProcessUtils;
|
||||
|
||||
/**
|
||||
* Use this to add arguments and options to the $arguments property.
|
||||
*/
|
||||
trait CommandArguments
|
||||
{
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
protected $arguments = '';
|
||||
|
||||
/**
|
||||
* Pass argument to executable. Its value will be automatically escaped.
|
||||
*
|
||||
* @param string $arg
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function arg($arg)
|
||||
{
|
||||
return $this->args($arg);
|
||||
}
|
||||
|
||||
/**
|
||||
* Pass methods parameters as arguments to executable. Argument values
|
||||
* are automatically escaped.
|
||||
*
|
||||
* @param string|string[] $args
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function args($args)
|
||||
{
|
||||
if (!is_array($args)) {
|
||||
$args = func_get_args();
|
||||
}
|
||||
$this->arguments .= ' ' . implode(' ', array_map('static::escape', $args));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Pass the provided string in its raw (as provided) form as an argument to executable.
|
||||
*
|
||||
* @param string $arg
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function rawArg($arg)
|
||||
{
|
||||
$this->arguments .= " $arg";
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Escape the provided value, unless it contains only alphanumeric
|
||||
* plus a few other basic characters.
|
||||
*
|
||||
* @param string $value
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function escape($value)
|
||||
{
|
||||
if (preg_match('/^[a-zA-Z0-9\/\.@~_-]+$/', $value)) {
|
||||
return $value;
|
||||
}
|
||||
return ProcessUtils::escapeArgument($value);
|
||||
}
|
||||
|
||||
/**
|
||||
* Pass option to executable. Options are prefixed with `--` , value can be provided in second parameter.
|
||||
* Option values are automatically escaped.
|
||||
*
|
||||
* @param string $option
|
||||
* @param string $value
|
||||
* @param string $separator
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function option($option, $value = null, $separator = ' ')
|
||||
{
|
||||
if ($option !== null and strpos($option, '-') !== 0) {
|
||||
$option = "--$option";
|
||||
}
|
||||
$this->arguments .= null == $option ? '' : " " . $option;
|
||||
$this->arguments .= null == $value ? '' : $separator . static::escape($value);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Pass multiple options to executable. The associative array contains
|
||||
* the key:value pairs that become `--key value`, for each item in the array.
|
||||
* Values are automatically escaped.
|
||||
*/
|
||||
public function options(array $options, $separator = ' ')
|
||||
{
|
||||
foreach ($options as $option => $value) {
|
||||
$this->option($option, $value, $separator);
|
||||
}
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Pass an option with multiple values to executable. Value can be a string or array.
|
||||
* Option values are automatically escaped.
|
||||
*
|
||||
* @param string $option
|
||||
* @param string|array $value
|
||||
* @param string $separator
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function optionList($option, $value = array(), $separator = ' ')
|
||||
{
|
||||
if (is_array($value)) {
|
||||
foreach ($value as $item) {
|
||||
$this->optionList($option, $item, $separator);
|
||||
}
|
||||
} else {
|
||||
$this->option($option, $value, $separator);
|
||||
}
|
||||
|
||||
return $this;
|
||||
}
|
||||
}
|
||||
30
vendor/consolidation/robo/src/Common/CommandReceiver.php
vendored
Normal file
30
vendor/consolidation/robo/src/Common/CommandReceiver.php
vendored
Normal file
|
|
@ -0,0 +1,30 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
use Robo\Contract\CommandInterface;
|
||||
use Robo\Exception\TaskException;
|
||||
|
||||
/**
|
||||
* This task can receive commands from task implementing CommandInterface.
|
||||
*/
|
||||
trait CommandReceiver
|
||||
{
|
||||
/**
|
||||
* @param string|\Robo\Contract\CommandInterface $command
|
||||
*
|
||||
* @return string
|
||||
*
|
||||
* @throws \Robo\Exception\TaskException
|
||||
*/
|
||||
protected function receiveCommand($command)
|
||||
{
|
||||
if (!is_object($command)) {
|
||||
return $command;
|
||||
}
|
||||
if ($command instanceof CommandInterface) {
|
||||
return $command->getCommand();
|
||||
} else {
|
||||
throw new TaskException($this, get_class($command) . " does not implement CommandInterface, so can't be passed into this task");
|
||||
}
|
||||
}
|
||||
}
|
||||
109
vendor/consolidation/robo/src/Common/ConfigAwareTrait.php
vendored
Normal file
109
vendor/consolidation/robo/src/Common/ConfigAwareTrait.php
vendored
Normal file
|
|
@ -0,0 +1,109 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Common;
|
||||
|
||||
use Robo\Robo;
|
||||
use Consolidation\Config\ConfigInterface;
|
||||
|
||||
trait ConfigAwareTrait
|
||||
{
|
||||
/**
|
||||
* @var ConfigInterface
|
||||
*/
|
||||
protected $config;
|
||||
|
||||
/**
|
||||
* Set the config management object.
|
||||
*
|
||||
* @param ConfigInterface $config
|
||||
*
|
||||
* @return $this
|
||||
*
|
||||
* @see \Robo\Contract\ConfigAwareInterface::setConfig()
|
||||
*/
|
||||
public function setConfig(ConfigInterface $config)
|
||||
{
|
||||
$this->config = $config;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the config management object.
|
||||
*
|
||||
* @return ConfigInterface
|
||||
*
|
||||
* @see \Robo\Contract\ConfigAwareInterface::getConfig()
|
||||
*/
|
||||
public function getConfig()
|
||||
{
|
||||
return $this->config;
|
||||
}
|
||||
|
||||
/**
|
||||
* Any class that uses ConfigAwareTrait SHOULD override this method
|
||||
* , and define a prefix for its configuration items. This is usually
|
||||
* done in a base class. When used, this method should return a string
|
||||
* that ends with a "."; see BaseTask::configPrefix().
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected static function configPrefix()
|
||||
{
|
||||
return '';
|
||||
}
|
||||
|
||||
protected static function configClassIdentifier($classname)
|
||||
{
|
||||
$configIdentifier = strtr($classname, '\\', '.');
|
||||
$configIdentifier = preg_replace('#^(.*\.Task\.|\.)#', '', $configIdentifier);
|
||||
|
||||
return $configIdentifier;
|
||||
}
|
||||
|
||||
protected static function configPostfix()
|
||||
{
|
||||
return '';
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $key
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
private static function getClassKey($key)
|
||||
{
|
||||
$configPrefix = static::configPrefix(); // task.
|
||||
$configClass = static::configClassIdentifier(get_called_class()); // PARTIAL_NAMESPACE.CLASSNAME
|
||||
$configPostFix = static::configPostfix(); // .settings
|
||||
|
||||
return sprintf('%s%s%s.%s', $configPrefix, $configClass, $configPostFix, $key);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $key
|
||||
* @param mixed $value
|
||||
* @param Config|null $config
|
||||
*/
|
||||
public static function configure($key, $value, $config = null)
|
||||
{
|
||||
if (!$config) {
|
||||
$config = Robo::config();
|
||||
}
|
||||
$config->setDefault(static::getClassKey($key), $value);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $key
|
||||
* @param mixed|null $default
|
||||
*
|
||||
* @return mixed|null
|
||||
*/
|
||||
protected function getConfigValue($key, $default = null)
|
||||
{
|
||||
if (!$this->getConfig()) {
|
||||
return $default;
|
||||
}
|
||||
return $this->getConfig()->get(static::getClassKey($key), $default);
|
||||
}
|
||||
}
|
||||
45
vendor/consolidation/robo/src/Common/DynamicParams.php
vendored
Normal file
45
vendor/consolidation/robo/src/Common/DynamicParams.php
vendored
Normal file
|
|
@ -0,0 +1,45 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
/**
|
||||
* Simplifies generating of configuration chanined methods.
|
||||
* You can only define configuration properties and use magic methods to set them.
|
||||
* Methods will be named the same way as properties.
|
||||
* * Boolean properties are switched on/off if no values is provided.
|
||||
* * Array properties can accept non-array values, in this case value will be appended to array.
|
||||
* You should also define phpdoc for methods.
|
||||
*/
|
||||
trait DynamicParams
|
||||
{
|
||||
/**
|
||||
* @param string $property
|
||||
* @param array $args
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function __call($property, $args)
|
||||
{
|
||||
if (!property_exists($this, $property)) {
|
||||
throw new \RuntimeException("Property $property in task ".get_class($this).' does not exists');
|
||||
}
|
||||
|
||||
// toggle boolean values
|
||||
if (!isset($args[0]) and (is_bool($this->$property))) {
|
||||
$this->$property = !$this->$property;
|
||||
return $this;
|
||||
}
|
||||
|
||||
// append item to array
|
||||
if (is_array($this->$property)) {
|
||||
if (is_array($args[0])) {
|
||||
$this->$property = $args[0];
|
||||
} else {
|
||||
array_push($this->$property, $args[0]);
|
||||
}
|
||||
return $this;
|
||||
}
|
||||
|
||||
$this->$property = $args[0];
|
||||
return $this;
|
||||
}
|
||||
}
|
||||
148
vendor/consolidation/robo/src/Common/ExecCommand.php
vendored
Normal file
148
vendor/consolidation/robo/src/Common/ExecCommand.php
vendored
Normal file
|
|
@ -0,0 +1,148 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
use Robo\Result;
|
||||
use Symfony\Component\Process\ExecutableFinder;
|
||||
use Symfony\Component\Process\Process;
|
||||
|
||||
/**
|
||||
* This task is supposed to be executed as shell command.
|
||||
* You can specify working directory and if output is printed.
|
||||
*/
|
||||
trait ExecCommand
|
||||
{
|
||||
use ExecTrait;
|
||||
|
||||
/**
|
||||
* @var \Robo\Common\TimeKeeper
|
||||
*/
|
||||
protected $execTimer;
|
||||
|
||||
/**
|
||||
* @return \Robo\Common\TimeKeeper
|
||||
*/
|
||||
protected function getExecTimer()
|
||||
{
|
||||
if (!isset($this->execTimer)) {
|
||||
$this->execTimer = new TimeKeeper();
|
||||
}
|
||||
return $this->execTimer;
|
||||
}
|
||||
|
||||
/**
|
||||
* Look for a "{$cmd}.phar" in the current working
|
||||
* directory; return a string to exec it if it is
|
||||
* found. Otherwise, look for an executable command
|
||||
* of the same name via findExecutable.
|
||||
*
|
||||
* @param string $cmd
|
||||
*
|
||||
* @return bool|string
|
||||
*/
|
||||
protected function findExecutablePhar($cmd)
|
||||
{
|
||||
if (file_exists("{$cmd}.phar")) {
|
||||
return "php {$cmd}.phar";
|
||||
}
|
||||
return $this->findExecutable($cmd);
|
||||
}
|
||||
|
||||
/**
|
||||
* Return the best path to the executable program
|
||||
* with the provided name. Favor vendor/bin in the
|
||||
* current project. If not found there, use
|
||||
* whatever is on the $PATH.
|
||||
*
|
||||
* @param string $cmd
|
||||
*
|
||||
* @return bool|string
|
||||
*/
|
||||
protected function findExecutable($cmd)
|
||||
{
|
||||
$pathToCmd = $this->searchForExecutable($cmd);
|
||||
if ($pathToCmd) {
|
||||
return $this->useCallOnWindows($pathToCmd);
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $cmd
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
private function searchForExecutable($cmd)
|
||||
{
|
||||
$projectBin = $this->findProjectBin();
|
||||
|
||||
$localComposerInstallation = $projectBin . DIRECTORY_SEPARATOR . $cmd;
|
||||
if (file_exists($localComposerInstallation)) {
|
||||
return $localComposerInstallation;
|
||||
}
|
||||
$finder = new ExecutableFinder();
|
||||
return $finder->find($cmd, null, []);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return bool|string
|
||||
*/
|
||||
protected function findProjectBin()
|
||||
{
|
||||
$cwd = getcwd();
|
||||
$candidates = [ __DIR__ . '/../../vendor/bin', __DIR__ . '/../../bin', $cwd . '/vendor/bin' ];
|
||||
|
||||
// If this project is inside a vendor directory, give highest priority
|
||||
// to that directory.
|
||||
$vendorDirContainingUs = realpath(__DIR__ . '/../../../..');
|
||||
if (is_dir($vendorDirContainingUs) && (basename($vendorDirContainingUs) == 'vendor')) {
|
||||
array_unshift($candidates, $vendorDirContainingUs . '/bin');
|
||||
}
|
||||
|
||||
foreach ($candidates as $dir) {
|
||||
if (is_dir("$dir")) {
|
||||
return realpath($dir);
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Wrap Windows executables in 'call' per 7a88757d
|
||||
*
|
||||
* @param string $cmd
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function useCallOnWindows($cmd)
|
||||
{
|
||||
if (defined('PHP_WINDOWS_VERSION_BUILD')) {
|
||||
if (file_exists("{$cmd}.bat")) {
|
||||
$cmd = "{$cmd}.bat";
|
||||
}
|
||||
return "call $cmd";
|
||||
}
|
||||
return $cmd;
|
||||
}
|
||||
|
||||
protected function getCommandDescription()
|
||||
{
|
||||
return $this->process->getCommandLine();
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $command
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
protected function executeCommand($command)
|
||||
{
|
||||
// TODO: Symfony 4 requires that we supply the working directory.
|
||||
$result_data = $this->execute(new Process($command, getcwd()));
|
||||
return new Result(
|
||||
$this,
|
||||
$result_data->getExitCode(),
|
||||
$result_data->getMessage(),
|
||||
$result_data->getData()
|
||||
);
|
||||
}
|
||||
}
|
||||
12
vendor/consolidation/robo/src/Common/ExecOneCommand.php
vendored
Normal file
12
vendor/consolidation/robo/src/Common/ExecOneCommand.php
vendored
Normal file
|
|
@ -0,0 +1,12 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
/**
|
||||
* This task specifies exactly one shell command.
|
||||
* It can take additional arguments and options as config parameters.
|
||||
*/
|
||||
trait ExecOneCommand
|
||||
{
|
||||
use ExecCommand;
|
||||
use CommandArguments;
|
||||
}
|
||||
413
vendor/consolidation/robo/src/Common/ExecTrait.php
vendored
Normal file
413
vendor/consolidation/robo/src/Common/ExecTrait.php
vendored
Normal file
|
|
@ -0,0 +1,413 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Common;
|
||||
|
||||
use Robo\ResultData;
|
||||
use Symfony\Component\Process\Process;
|
||||
|
||||
/**
|
||||
* Class ExecTrait
|
||||
* @package Robo\Common
|
||||
*/
|
||||
trait ExecTrait
|
||||
{
|
||||
/**
|
||||
* @var bool
|
||||
*/
|
||||
protected $background = false;
|
||||
|
||||
/**
|
||||
* @var null|int
|
||||
*/
|
||||
protected $timeout = null;
|
||||
|
||||
/**
|
||||
* @var null|int
|
||||
*/
|
||||
protected $idleTimeout = null;
|
||||
|
||||
/**
|
||||
* @var null|array
|
||||
*/
|
||||
protected $env = null;
|
||||
|
||||
/**
|
||||
* @var Process
|
||||
*/
|
||||
protected $process;
|
||||
|
||||
/**
|
||||
* @var resource|string
|
||||
*/
|
||||
protected $input;
|
||||
|
||||
/**
|
||||
* @var boolean
|
||||
*/
|
||||
protected $interactive = null;
|
||||
|
||||
/**
|
||||
* @var bool
|
||||
*/
|
||||
protected $isPrinted = true;
|
||||
|
||||
/**
|
||||
* @var bool
|
||||
*/
|
||||
protected $isMetadataPrinted = true;
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
protected $workingDirectory;
|
||||
|
||||
/**
|
||||
* @return string
|
||||
*/
|
||||
abstract public function getCommandDescription();
|
||||
|
||||
/** Typically provided by Timer trait via ProgressIndicatorAwareTrait. */
|
||||
abstract public function startTimer();
|
||||
abstract public function stopTimer();
|
||||
abstract public function getExecutionTime();
|
||||
|
||||
/**
|
||||
* Typically provided by TaskIO Trait.
|
||||
*/
|
||||
abstract public function hideTaskProgress();
|
||||
abstract public function showTaskProgress($inProgress);
|
||||
abstract public function printTaskInfo($text, $context = null);
|
||||
|
||||
/**
|
||||
* Typically provided by VerbosityThresholdTrait.
|
||||
*/
|
||||
abstract public function verbosityMeetsThreshold();
|
||||
abstract public function writeMessage($message);
|
||||
|
||||
/**
|
||||
* Sets $this->interactive() based on posix_isatty().
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function detectInteractive()
|
||||
{
|
||||
// If the caller did not explicity set the 'interactive' mode,
|
||||
// and output should be produced by this task (verbosityMeetsThreshold),
|
||||
// then we will automatically set interactive mode based on whether
|
||||
// or not output was redirected when robo was executed.
|
||||
if (!isset($this->interactive) && function_exists('posix_isatty') && $this->verbosityMeetsThreshold()) {
|
||||
$this->interactive = posix_isatty(STDOUT);
|
||||
}
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Executes command in background mode (asynchronously)
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function background($arg = true)
|
||||
{
|
||||
$this->background = $arg;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Stop command if it runs longer then $timeout in seconds
|
||||
*
|
||||
* @param int $timeout
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function timeout($timeout)
|
||||
{
|
||||
$this->timeout = $timeout;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Stops command if it does not output something for a while
|
||||
*
|
||||
* @param int $timeout
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function idleTimeout($timeout)
|
||||
{
|
||||
$this->idleTimeout = $timeout;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set a single environment variable, or multiple.
|
||||
*/
|
||||
public function env($env, $value = null)
|
||||
{
|
||||
if (!is_array($env)) {
|
||||
$env = [$env => ($value ? $value : true)];
|
||||
}
|
||||
return $this->envVars($env);
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the environment variables for the command
|
||||
*
|
||||
* @param array $env
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function envVars(array $env)
|
||||
{
|
||||
$this->env = $this->env ? $env + $this->env : $env;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Pass an input to the process. Can be resource created with fopen() or string
|
||||
*
|
||||
* @param resource|string $input
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setInput($input)
|
||||
{
|
||||
$this->input = $input;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Attach tty to process for interactive input
|
||||
*
|
||||
* @param $interactive bool
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function interactive($interactive = true)
|
||||
{
|
||||
$this->interactive = $interactive;
|
||||
return $this;
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Is command printing its output to screen
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function getPrinted()
|
||||
{
|
||||
return $this->isPrinted;
|
||||
}
|
||||
|
||||
/**
|
||||
* Changes working directory of command
|
||||
*
|
||||
* @param string $dir
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function dir($dir)
|
||||
{
|
||||
$this->workingDirectory = $dir;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Shortcut for setting isPrinted() and isMetadataPrinted() to false.
|
||||
*
|
||||
* @param bool $arg
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function silent($arg)
|
||||
{
|
||||
if (is_bool($arg)) {
|
||||
$this->isPrinted = !$arg;
|
||||
$this->isMetadataPrinted = !$arg;
|
||||
}
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Should command output be printed
|
||||
*
|
||||
* @param bool $arg
|
||||
*
|
||||
* @return $this
|
||||
*
|
||||
* @deprecated
|
||||
*/
|
||||
public function printed($arg)
|
||||
{
|
||||
$this->logger->warning("printed() is deprecated. Please use printOutput().");
|
||||
return $this->printOutput($arg);
|
||||
}
|
||||
|
||||
/**
|
||||
* Should command output be printed
|
||||
*
|
||||
* @param bool $arg
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function printOutput($arg)
|
||||
{
|
||||
if (is_bool($arg)) {
|
||||
$this->isPrinted = $arg;
|
||||
}
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Should command metadata be printed. I,e., command and timer.
|
||||
*
|
||||
* @param bool $arg
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function printMetadata($arg)
|
||||
{
|
||||
if (is_bool($arg)) {
|
||||
$this->isMetadataPrinted = $arg;
|
||||
}
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param Process $process
|
||||
* @param callable $output_callback
|
||||
*
|
||||
* @return \Robo\ResultData
|
||||
*/
|
||||
protected function execute($process, $output_callback = null)
|
||||
{
|
||||
$this->process = $process;
|
||||
|
||||
if (!$output_callback) {
|
||||
$output_callback = function ($type, $buffer) {
|
||||
$progressWasVisible = $this->hideTaskProgress();
|
||||
$this->writeMessage($buffer);
|
||||
$this->showTaskProgress($progressWasVisible);
|
||||
};
|
||||
}
|
||||
|
||||
$this->detectInteractive();
|
||||
|
||||
if ($this->isMetadataPrinted) {
|
||||
$this->printAction();
|
||||
}
|
||||
$this->process->setTimeout($this->timeout);
|
||||
$this->process->setIdleTimeout($this->idleTimeout);
|
||||
if ($this->workingDirectory) {
|
||||
$this->process->setWorkingDirectory($this->workingDirectory);
|
||||
}
|
||||
if ($this->input) {
|
||||
$this->process->setInput($this->input);
|
||||
}
|
||||
|
||||
if ($this->interactive && $this->isPrinted) {
|
||||
$this->process->setTty(true);
|
||||
}
|
||||
|
||||
if (isset($this->env)) {
|
||||
// Symfony 4 will inherit environment variables by default, but until
|
||||
// then, manually ensure they are inherited.
|
||||
if (method_exists($this->process, 'inheritEnvironmentVariables')) {
|
||||
$this->process->inheritEnvironmentVariables();
|
||||
}
|
||||
$this->process->setEnv($this->env);
|
||||
}
|
||||
|
||||
if (!$this->background && !$this->isPrinted) {
|
||||
$this->startTimer();
|
||||
$this->process->run();
|
||||
$this->stopTimer();
|
||||
$output = rtrim($this->process->getOutput());
|
||||
return new ResultData(
|
||||
$this->process->getExitCode(),
|
||||
$output,
|
||||
$this->getResultData()
|
||||
);
|
||||
}
|
||||
|
||||
if (!$this->background && $this->isPrinted) {
|
||||
$this->startTimer();
|
||||
$this->process->run($output_callback);
|
||||
$this->stopTimer();
|
||||
return new ResultData(
|
||||
$this->process->getExitCode(),
|
||||
$this->process->getOutput(),
|
||||
$this->getResultData()
|
||||
);
|
||||
}
|
||||
|
||||
try {
|
||||
$this->process->start();
|
||||
} catch (\Exception $e) {
|
||||
return new ResultData(
|
||||
$this->process->getExitCode(),
|
||||
$e->getMessage(),
|
||||
$this->getResultData()
|
||||
);
|
||||
}
|
||||
return new ResultData($this->process->getExitCode());
|
||||
}
|
||||
|
||||
/**
|
||||
*
|
||||
*/
|
||||
protected function stop()
|
||||
{
|
||||
if ($this->background && isset($this->process) && $this->process->isRunning()) {
|
||||
$this->process->stop();
|
||||
$this->printTaskInfo(
|
||||
"Stopped {command}",
|
||||
['command' => $this->getCommandDescription()]
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array $context
|
||||
*/
|
||||
protected function printAction($context = [])
|
||||
{
|
||||
$command = $this->getCommandDescription();
|
||||
$formatted_command = $this->formatCommandDisplay($command);
|
||||
|
||||
$dir = $this->workingDirectory ? " in {dir}" : "";
|
||||
$this->printTaskInfo("Running {command}$dir", [
|
||||
'command' => $formatted_command,
|
||||
'dir' => $this->workingDirectory
|
||||
] + $context);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param $command
|
||||
*
|
||||
* @return mixed
|
||||
*/
|
||||
protected function formatCommandDisplay($command)
|
||||
{
|
||||
$formatted_command = str_replace("&&", "&&\n", $command);
|
||||
$formatted_command = str_replace("||", "||\n", $formatted_command);
|
||||
|
||||
return $formatted_command;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the data array to be passed to Result().
|
||||
*
|
||||
* @return array
|
||||
* The data array passed to Result().
|
||||
*/
|
||||
protected function getResultData()
|
||||
{
|
||||
if ($this->isMetadataPrinted) {
|
||||
return ['time' => $this->getExecutionTime()];
|
||||
}
|
||||
|
||||
return [];
|
||||
}
|
||||
}
|
||||
171
vendor/consolidation/robo/src/Common/IO.php
vendored
Normal file
171
vendor/consolidation/robo/src/Common/IO.php
vendored
Normal file
|
|
@ -0,0 +1,171 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
use Symfony\Component\Console\Helper\QuestionHelper;
|
||||
use Symfony\Component\Console\Question\ConfirmationQuestion;
|
||||
use Symfony\Component\Console\Question\Question;
|
||||
use Symfony\Component\Console\Style\SymfonyStyle;
|
||||
|
||||
trait IO
|
||||
{
|
||||
use InputAwareTrait;
|
||||
use OutputAwareTrait;
|
||||
|
||||
/**
|
||||
* @var \Symfony\Component\Console\Style\SymfonyStyle
|
||||
*/
|
||||
protected $io;
|
||||
|
||||
/**
|
||||
* Provide access to SymfonyStyle object.
|
||||
*
|
||||
* @return SymfonyStyle
|
||||
*
|
||||
* @see http://symfony.com/blog/new-in-symfony-2-8-console-style-guide
|
||||
*/
|
||||
protected function io()
|
||||
{
|
||||
if (!$this->io) {
|
||||
$this->io = new SymfonyStyle($this->input(), $this->output());
|
||||
}
|
||||
return $this->io;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $nonDecorated
|
||||
* @param string $decorated
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function decorationCharacter($nonDecorated, $decorated)
|
||||
{
|
||||
if (!$this->output()->isDecorated() || (strncasecmp(PHP_OS, 'WIN', 3) == 0)) {
|
||||
return $nonDecorated;
|
||||
}
|
||||
return $decorated;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $text
|
||||
*/
|
||||
protected function say($text)
|
||||
{
|
||||
$char = $this->decorationCharacter('>', '➜');
|
||||
$this->writeln("$char $text");
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $text
|
||||
* @param int $length
|
||||
* @param string $color
|
||||
*/
|
||||
protected function yell($text, $length = 40, $color = 'green')
|
||||
{
|
||||
$char = $this->decorationCharacter(' ', '➜');
|
||||
$format = "$char <fg=white;bg=$color;options=bold>%s</fg=white;bg=$color;options=bold>";
|
||||
$this->formattedOutput($text, $length, $format);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $text
|
||||
* @param int $length
|
||||
* @param string $format
|
||||
*/
|
||||
protected function formattedOutput($text, $length, $format)
|
||||
{
|
||||
$lines = explode("\n", trim($text, "\n"));
|
||||
$maxLineLength = array_reduce(array_map('strlen', $lines), 'max');
|
||||
$length = max($length, $maxLineLength);
|
||||
$len = $length + 2;
|
||||
$space = str_repeat(' ', $len);
|
||||
$this->writeln(sprintf($format, $space));
|
||||
foreach ($lines as $line) {
|
||||
$line = str_pad($line, $length, ' ', STR_PAD_BOTH);
|
||||
$this->writeln(sprintf($format, " $line "));
|
||||
}
|
||||
$this->writeln(sprintf($format, $space));
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $question
|
||||
* @param bool $hideAnswer
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function ask($question, $hideAnswer = false)
|
||||
{
|
||||
if ($hideAnswer) {
|
||||
return $this->askHidden($question);
|
||||
}
|
||||
return $this->doAsk(new Question($this->formatQuestion($question)));
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $question
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function askHidden($question)
|
||||
{
|
||||
$question = new Question($this->formatQuestion($question));
|
||||
$question->setHidden(true);
|
||||
return $this->doAsk($question);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $question
|
||||
* @param string $default
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function askDefault($question, $default)
|
||||
{
|
||||
return $this->doAsk(new Question($this->formatQuestion("$question [$default]"), $default));
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $question
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function confirm($question)
|
||||
{
|
||||
return $this->doAsk(new ConfirmationQuestion($this->formatQuestion($question . ' (y/n)'), false));
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Symfony\Component\Console\Question\Question $question
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function doAsk(Question $question)
|
||||
{
|
||||
return $this->getDialog()->ask($this->input(), $this->output(), $question);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $message
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function formatQuestion($message)
|
||||
{
|
||||
return "<question>? $message</question> ";
|
||||
}
|
||||
|
||||
/**
|
||||
* @return \Symfony\Component\Console\Helper\QuestionHelper
|
||||
*/
|
||||
protected function getDialog()
|
||||
{
|
||||
return new QuestionHelper();
|
||||
}
|
||||
|
||||
/**
|
||||
* @param $text
|
||||
*/
|
||||
protected function writeln($text)
|
||||
{
|
||||
$this->output()->writeln($text);
|
||||
}
|
||||
}
|
||||
21
vendor/consolidation/robo/src/Common/InflectionTrait.php
vendored
Normal file
21
vendor/consolidation/robo/src/Common/InflectionTrait.php
vendored
Normal file
|
|
@ -0,0 +1,21 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
use Robo\Contract\InflectionInterface;
|
||||
|
||||
trait InflectionTrait
|
||||
{
|
||||
/**
|
||||
* Ask the provided parent class to inject all of the dependencies
|
||||
* that it has and we need.
|
||||
*
|
||||
* @param \Robo\Contract\InflectionInterface $parent
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function inflect(InflectionInterface $parent)
|
||||
{
|
||||
$parent->injectDependencies($this);
|
||||
return $this;
|
||||
}
|
||||
}
|
||||
51
vendor/consolidation/robo/src/Common/InputAwareTrait.php
vendored
Normal file
51
vendor/consolidation/robo/src/Common/InputAwareTrait.php
vendored
Normal file
|
|
@ -0,0 +1,51 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Common;
|
||||
|
||||
use Symfony\Component\Console\Input\ArgvInput;
|
||||
use Symfony\Component\Console\Input\InputInterface;
|
||||
|
||||
trait InputAwareTrait
|
||||
{
|
||||
/**
|
||||
* @var \Symfony\Component\Console\Input\InputInterface
|
||||
*/
|
||||
protected $input;
|
||||
|
||||
/**
|
||||
* @param \Symfony\Component\Console\Input\InputInterface $input
|
||||
*
|
||||
* @return $this
|
||||
*
|
||||
* @see \Symfony\Component\Console\Input\InputAwareInterface::setInput()
|
||||
*/
|
||||
public function setInput(InputInterface $input)
|
||||
{
|
||||
$this->input = $input;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return \Symfony\Component\Console\Input\InputInterface
|
||||
*/
|
||||
protected function input()
|
||||
{
|
||||
if (!isset($this->input)) {
|
||||
$this->setInput(new ArgvInput());
|
||||
}
|
||||
return $this->input;
|
||||
}
|
||||
|
||||
/**
|
||||
* Backwards compatibility.
|
||||
*
|
||||
* @return \Symfony\Component\Console\Input\InputInterface
|
||||
*
|
||||
* @deprecated
|
||||
*/
|
||||
protected function getInput()
|
||||
{
|
||||
return $this->input();
|
||||
}
|
||||
}
|
||||
38
vendor/consolidation/robo/src/Common/OutputAdapter.php
vendored
Normal file
38
vendor/consolidation/robo/src/Common/OutputAdapter.php
vendored
Normal file
|
|
@ -0,0 +1,38 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
use Robo\Contract\OutputAdapterInterface;
|
||||
use Robo\Contract\OutputAwareInterface;
|
||||
use Robo\Contract\VerbosityThresholdInterface;
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
|
||||
/**
|
||||
* Adapt OutputInterface or other output function to the VerbosityThresholdInterface.
|
||||
*/
|
||||
class OutputAdapter implements OutputAdapterInterface, OutputAwareInterface
|
||||
{
|
||||
use OutputAwareTrait;
|
||||
|
||||
protected $verbosityMap = [
|
||||
VerbosityThresholdInterface::VERBOSITY_NORMAL => OutputInterface::VERBOSITY_NORMAL,
|
||||
VerbosityThresholdInterface::VERBOSITY_VERBOSE => OutputInterface::VERBOSITY_VERBOSE,
|
||||
VerbosityThresholdInterface::VERBOSITY_VERY_VERBOSE => OutputInterface::VERBOSITY_VERY_VERBOSE,
|
||||
VerbosityThresholdInterface::VERBOSITY_DEBUG => OutputInterface::VERBOSITY_DEBUG,
|
||||
];
|
||||
|
||||
public function verbosityMeetsThreshold($verbosityThreshold)
|
||||
{
|
||||
if (!isset($this->verbosityMap[$verbosityThreshold])) {
|
||||
return true;
|
||||
}
|
||||
$verbosityThreshold = $this->verbosityMap[$verbosityThreshold];
|
||||
$verbosity = $this->output()->getVerbosity();
|
||||
|
||||
return $verbosity >= $verbosityThreshold;
|
||||
}
|
||||
|
||||
public function writeMessage($message)
|
||||
{
|
||||
$this->output()->write($message);
|
||||
}
|
||||
}
|
||||
51
vendor/consolidation/robo/src/Common/OutputAwareTrait.php
vendored
Normal file
51
vendor/consolidation/robo/src/Common/OutputAwareTrait.php
vendored
Normal file
|
|
@ -0,0 +1,51 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Common;
|
||||
|
||||
use Symfony\Component\Console\Output\NullOutput;
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
|
||||
trait OutputAwareTrait
|
||||
{
|
||||
/**
|
||||
* @var \Symfony\Component\Console\Output\OutputInterface
|
||||
*/
|
||||
protected $output;
|
||||
|
||||
/**
|
||||
* @param \Symfony\Component\Console\Output\OutputInterface $output
|
||||
*
|
||||
* @return $this
|
||||
*
|
||||
* @see \Robo\Contract\OutputAwareInterface::setOutput()
|
||||
*/
|
||||
public function setOutput(OutputInterface $output)
|
||||
{
|
||||
$this->output = $output;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return \Symfony\Component\Console\Output\OutputInterface
|
||||
*/
|
||||
protected function output()
|
||||
{
|
||||
if (!isset($this->output)) {
|
||||
$this->setOutput(new NullOutput());
|
||||
}
|
||||
return $this->output;
|
||||
}
|
||||
|
||||
/**
|
||||
* Backwards compatibility
|
||||
*
|
||||
* @return \Symfony\Component\Console\Output\OutputInterface
|
||||
*
|
||||
* @deprecated
|
||||
*/
|
||||
protected function getOutput()
|
||||
{
|
||||
return $this->output();
|
||||
}
|
||||
}
|
||||
51
vendor/consolidation/robo/src/Common/ProcessExecutor.php
vendored
Normal file
51
vendor/consolidation/robo/src/Common/ProcessExecutor.php
vendored
Normal file
|
|
@ -0,0 +1,51 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Common;
|
||||
|
||||
use Psr\Log\LoggerAwareInterface;
|
||||
use Robo\Contract\ConfigAwareInterface;
|
||||
use Robo\Contract\OutputAwareInterface;
|
||||
use Robo\Contract\VerbosityThresholdInterface;
|
||||
use Symfony\Component\Process\Process;
|
||||
|
||||
class ProcessExecutor implements ConfigAwareInterface, LoggerAwareInterface, OutputAwareInterface, VerbosityThresholdInterface
|
||||
{
|
||||
use ExecTrait;
|
||||
use TaskIO; // uses LoggerAwareTrait and ConfigAwareTrait
|
||||
use ProgressIndicatorAwareTrait;
|
||||
use OutputAwareTrait;
|
||||
|
||||
/**
|
||||
* @param Process $process
|
||||
* @return type
|
||||
*/
|
||||
public function __construct(Process $process)
|
||||
{
|
||||
$this->process = $process;
|
||||
}
|
||||
|
||||
public static function create($container, $process)
|
||||
{
|
||||
$processExecutor = new self($process);
|
||||
|
||||
$processExecutor->setLogger($container->get('logger'));
|
||||
$processExecutor->setProgressIndicator($container->get('progressIndicator'));
|
||||
$processExecutor->setConfig($container->get('config'));
|
||||
$processExecutor->setOutputAdapter($container->get('outputAdapter'));
|
||||
|
||||
return $processExecutor;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return string
|
||||
*/
|
||||
protected function getCommandDescription()
|
||||
{
|
||||
return $this->process->getCommandLine();
|
||||
}
|
||||
|
||||
public function run()
|
||||
{
|
||||
return $this->execute($this->process);
|
||||
}
|
||||
}
|
||||
79
vendor/consolidation/robo/src/Common/ProcessUtils.php
vendored
Normal file
79
vendor/consolidation/robo/src/Common/ProcessUtils.php
vendored
Normal file
|
|
@ -0,0 +1,79 @@
|
|||
<?php
|
||||
|
||||
/*
|
||||
* This file is derived from part of the Symfony package, which is
|
||||
* (c) Fabien Potencier <fabien@symfony.com>
|
||||
*/
|
||||
|
||||
namespace Robo\Common;
|
||||
|
||||
use Symfony\Component\Process\Exception\InvalidArgumentException;
|
||||
|
||||
/**
|
||||
* ProcessUtils is a bunch of utility methods. We want to allow Robo 1.x
|
||||
* to work with Symfony 4.x while remaining backwards compatibility. This
|
||||
* requires us to replace some deprecated functionality removed in Symfony.
|
||||
*/
|
||||
class ProcessUtils
|
||||
{
|
||||
/**
|
||||
* This class should not be instantiated.
|
||||
*/
|
||||
private function __construct()
|
||||
{
|
||||
}
|
||||
|
||||
/**
|
||||
* Escapes a string to be used as a shell argument.
|
||||
*
|
||||
* @param string $argument The argument that will be escaped
|
||||
*
|
||||
* @return string The escaped argument
|
||||
*
|
||||
* @deprecated since version 3.3, to be removed in 4.0. Use a command line array or give env vars to the `Process::start/run()` method instead.
|
||||
*/
|
||||
public static function escapeArgument($argument)
|
||||
{
|
||||
@trigger_error('The '.__METHOD__.'() method is a copy of a method that was deprecated by Symfony 3.3 and removed in Symfony 4; it will be removed in Robo 2.0.', E_USER_DEPRECATED);
|
||||
|
||||
//Fix for PHP bug #43784 escapeshellarg removes % from given string
|
||||
//Fix for PHP bug #49446 escapeshellarg doesn't work on Windows
|
||||
//@see https://bugs.php.net/bug.php?id=43784
|
||||
//@see https://bugs.php.net/bug.php?id=49446
|
||||
if ('\\' === DIRECTORY_SEPARATOR) {
|
||||
if ('' === $argument) {
|
||||
return escapeshellarg($argument);
|
||||
}
|
||||
|
||||
$escapedArgument = '';
|
||||
$quote = false;
|
||||
foreach (preg_split('/(")/', $argument, -1, PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE) as $part) {
|
||||
if ('"' === $part) {
|
||||
$escapedArgument .= '\\"';
|
||||
} elseif (self::isSurroundedBy($part, '%')) {
|
||||
// Avoid environment variable expansion
|
||||
$escapedArgument .= '^%"'.substr($part, 1, -1).'"^%';
|
||||
} else {
|
||||
// escape trailing backslash
|
||||
if ('\\' === substr($part, -1)) {
|
||||
$part .= '\\';
|
||||
}
|
||||
$quote = true;
|
||||
$escapedArgument .= $part;
|
||||
}
|
||||
}
|
||||
if ($quote) {
|
||||
$escapedArgument = '"'.$escapedArgument.'"';
|
||||
}
|
||||
|
||||
return $escapedArgument;
|
||||
}
|
||||
|
||||
return "'".str_replace("'", "'\\''", $argument)."'";
|
||||
}
|
||||
|
||||
private static function isSurroundedBy($arg, $char)
|
||||
{
|
||||
return 2 < strlen($arg) && $char === $arg[0] && $char === $arg[strlen($arg) - 1];
|
||||
}
|
||||
}
|
||||
201
vendor/consolidation/robo/src/Common/ProgressIndicator.php
vendored
Normal file
201
vendor/consolidation/robo/src/Common/ProgressIndicator.php
vendored
Normal file
|
|
@ -0,0 +1,201 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
/**
|
||||
* Wrapper around \Symfony\Component\Console\Helper\ProgressBar
|
||||
*/
|
||||
class ProgressIndicator
|
||||
{
|
||||
use Timer;
|
||||
|
||||
/**
|
||||
* @var \Symfony\Component\Console\Helper\ProgressBar
|
||||
*/
|
||||
protected $progressBar;
|
||||
|
||||
/**
|
||||
* @var \Symfony\Component\Console\Output\OutputInterface
|
||||
*/
|
||||
protected $output;
|
||||
|
||||
/**
|
||||
* @var bool
|
||||
*/
|
||||
protected $progressIndicatorRunning = false;
|
||||
|
||||
/**
|
||||
* @var int
|
||||
*/
|
||||
protected $autoDisplayInterval = 0;
|
||||
|
||||
/**
|
||||
* @var int
|
||||
*/
|
||||
protected $cachedSteps = 0;
|
||||
|
||||
/**
|
||||
* @var int
|
||||
*/
|
||||
protected $totalSteps = 0;
|
||||
|
||||
/**
|
||||
* @var bool
|
||||
*/
|
||||
protected $progressBarDisplayed = false;
|
||||
|
||||
/**
|
||||
* @var \Robo\Contract\TaskInterface
|
||||
*/
|
||||
protected $owner;
|
||||
|
||||
/**
|
||||
* @param \Symfony\Component\Console\Helper\ProgressBar $progressBar
|
||||
* @param \Symfony\Component\Console\Output\OutputInterface $output
|
||||
*/
|
||||
public function __construct($progressBar, \Symfony\Component\Console\Output\OutputInterface $output)
|
||||
{
|
||||
$this->progressBar = $progressBar;
|
||||
$this->output = $output;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int $interval
|
||||
*/
|
||||
public function setProgressBarAutoDisplayInterval($interval)
|
||||
{
|
||||
if ($this->progressIndicatorRunning) {
|
||||
return;
|
||||
}
|
||||
$this->autoDisplayInterval = $interval;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return bool
|
||||
*/
|
||||
public function hideProgressIndicator()
|
||||
{
|
||||
$result = $this->progressBarDisplayed;
|
||||
if ($this->progressIndicatorRunning && $this->progressBarDisplayed) {
|
||||
$this->progressBar->clear();
|
||||
// Hack: progress indicator does not reset cursor to beginning of line on 'clear'
|
||||
$this->output->write("\x0D");
|
||||
$this->progressBarDisplayed = false;
|
||||
}
|
||||
return $result;
|
||||
}
|
||||
|
||||
public function showProgressIndicator()
|
||||
{
|
||||
if ($this->progressIndicatorRunning && !$this->progressBarDisplayed && isset($this->progressBar)) {
|
||||
$this->progressBar->display();
|
||||
$this->progressBarDisplayed = true;
|
||||
$this->advanceProgressIndicatorCachedSteps();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool $visible
|
||||
*/
|
||||
public function restoreProgressIndicator($visible)
|
||||
{
|
||||
if ($visible) {
|
||||
$this->showProgressIndicator();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int $totalSteps
|
||||
* @param \Robo\Contract\TaskInterface $owner
|
||||
*/
|
||||
public function startProgressIndicator($totalSteps, $owner)
|
||||
{
|
||||
if (!isset($this->progressBar)) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->progressIndicatorRunning = true;
|
||||
if (!isset($this->owner)) {
|
||||
$this->owner = $owner;
|
||||
$this->startTimer();
|
||||
$this->totalSteps = $totalSteps;
|
||||
$this->autoShowProgressIndicator();
|
||||
}
|
||||
}
|
||||
|
||||
public function autoShowProgressIndicator()
|
||||
{
|
||||
if (($this->autoDisplayInterval < 0) || !isset($this->progressBar) || !$this->output->isDecorated()) {
|
||||
return;
|
||||
}
|
||||
if ($this->autoDisplayInterval <= $this->getExecutionTime()) {
|
||||
$this->autoDisplayInterval = -1;
|
||||
$this->progressBar->start($this->totalSteps);
|
||||
$this->showProgressIndicator();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @return bool
|
||||
*/
|
||||
public function inProgress()
|
||||
{
|
||||
return $this->progressIndicatorRunning;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Robo\Contract\TaskInterface $owner
|
||||
*/
|
||||
public function stopProgressIndicator($owner)
|
||||
{
|
||||
if ($this->progressIndicatorRunning && ($this->owner === $owner)) {
|
||||
$this->cleanup();
|
||||
}
|
||||
}
|
||||
|
||||
protected function cleanup()
|
||||
{
|
||||
$this->progressIndicatorRunning = false;
|
||||
$this->owner = null;
|
||||
if ($this->progressBarDisplayed) {
|
||||
$this->progressBar->finish();
|
||||
// Hack: progress indicator does not always finish cleanly
|
||||
$this->output->writeln('');
|
||||
$this->progressBarDisplayed = false;
|
||||
}
|
||||
$this->stopTimer();
|
||||
}
|
||||
|
||||
/**
|
||||
* Erase progress indicator and ensure it never returns. Used
|
||||
* only during error handlers or to permanently remove the progress bar.
|
||||
*/
|
||||
public function disableProgressIndicator()
|
||||
{
|
||||
$this->cleanup();
|
||||
// ProgressIndicator is shared, so this permanently removes
|
||||
// the program's ability to display progress bars.
|
||||
$this->progressBar = null;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int $steps
|
||||
*/
|
||||
public function advanceProgressIndicator($steps = 1)
|
||||
{
|
||||
$this->cachedSteps += $steps;
|
||||
if ($this->progressIndicatorRunning) {
|
||||
$this->autoShowProgressIndicator();
|
||||
// We only want to call `advance` if the progress bar is visible,
|
||||
// because it always displays itself when it is advanced.
|
||||
if ($this->progressBarDisplayed) {
|
||||
return $this->advanceProgressIndicatorCachedSteps();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
protected function advanceProgressIndicatorCachedSteps()
|
||||
{
|
||||
$this->progressBar->advance($this->cachedSteps);
|
||||
$this->cachedSteps = 0;
|
||||
}
|
||||
}
|
||||
135
vendor/consolidation/robo/src/Common/ProgressIndicatorAwareTrait.php
vendored
Normal file
135
vendor/consolidation/robo/src/Common/ProgressIndicatorAwareTrait.php
vendored
Normal file
|
|
@ -0,0 +1,135 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
use Robo\Contract\ProgressIndicatorAwareInterface;
|
||||
use Robo\Contract\VerbosityThresholdInterface;
|
||||
|
||||
trait ProgressIndicatorAwareTrait
|
||||
{
|
||||
use Timer;
|
||||
|
||||
/**
|
||||
* @var null|\Robo\Common\ProgressIndicator
|
||||
*/
|
||||
protected $progressIndicator;
|
||||
|
||||
/**
|
||||
* @return int
|
||||
*/
|
||||
public function progressIndicatorSteps()
|
||||
{
|
||||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param null|\Robo\Common\ProgressIndicator $progressIndicator
|
||||
*
|
||||
* @return ProgressIndicatorAwareInterface
|
||||
*/
|
||||
public function setProgressIndicator($progressIndicator)
|
||||
{
|
||||
$this->progressIndicator = $progressIndicator;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return null|bool
|
||||
*/
|
||||
protected function hideProgressIndicator()
|
||||
{
|
||||
if (!$this->progressIndicator) {
|
||||
return;
|
||||
}
|
||||
return $this->progressIndicator->hideProgressIndicator();
|
||||
}
|
||||
|
||||
protected function showProgressIndicator()
|
||||
{
|
||||
if (!$this->progressIndicator) {
|
||||
return;
|
||||
}
|
||||
$this->progressIndicator->showProgressIndicator();
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool $visible
|
||||
*/
|
||||
protected function restoreProgressIndicator($visible)
|
||||
{
|
||||
if (!$this->progressIndicator) {
|
||||
return;
|
||||
}
|
||||
$this->progressIndicator->restoreProgressIndicator($visible);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return int
|
||||
*/
|
||||
protected function getTotalExecutionTime()
|
||||
{
|
||||
if (!$this->progressIndicator) {
|
||||
return 0;
|
||||
}
|
||||
return $this->progressIndicator->getExecutionTime();
|
||||
}
|
||||
|
||||
protected function startProgressIndicator()
|
||||
{
|
||||
$this->startTimer();
|
||||
if ($this instanceof VerbosityThresholdInterface
|
||||
&& !$this->verbosityMeetsThreshold()) {
|
||||
return;
|
||||
}
|
||||
if (!$this->progressIndicator) {
|
||||
return;
|
||||
}
|
||||
$totalSteps = $this->progressIndicatorSteps();
|
||||
$this->progressIndicator->startProgressIndicator($totalSteps, $this);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return bool
|
||||
*/
|
||||
protected function inProgress()
|
||||
{
|
||||
if (!$this->progressIndicator) {
|
||||
return false;
|
||||
}
|
||||
return $this->progressIndicator->inProgress();
|
||||
}
|
||||
|
||||
protected function stopProgressIndicator()
|
||||
{
|
||||
$this->stopTimer();
|
||||
if (!$this->progressIndicator) {
|
||||
return;
|
||||
}
|
||||
$this->progressIndicator->stopProgressIndicator($this);
|
||||
}
|
||||
|
||||
protected function disableProgressIndicator()
|
||||
{
|
||||
$this->stopTimer();
|
||||
if (!$this->progressIndicator) {
|
||||
return;
|
||||
}
|
||||
$this->progressIndicator->disableProgressIndicator();
|
||||
}
|
||||
|
||||
protected function detatchProgressIndicator()
|
||||
{
|
||||
$this->setProgressIndicator(null);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int $steps
|
||||
*/
|
||||
protected function advanceProgressIndicator($steps = 1)
|
||||
{
|
||||
if (!$this->progressIndicator) {
|
||||
return;
|
||||
}
|
||||
$this->progressIndicator->advanceProgressIndicator($steps);
|
||||
}
|
||||
}
|
||||
116
vendor/consolidation/robo/src/Common/ResourceExistenceChecker.php
vendored
Normal file
116
vendor/consolidation/robo/src/Common/ResourceExistenceChecker.php
vendored
Normal file
|
|
@ -0,0 +1,116 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
trait ResourceExistenceChecker
|
||||
{
|
||||
/**
|
||||
* Checks if the given input is a file or folder.
|
||||
*
|
||||
* @param string|string[] $resources
|
||||
* @param string $type "file", "dir", "fileAndDir"
|
||||
*
|
||||
* @return bool True if no errors were encountered otherwise false.
|
||||
*/
|
||||
protected function checkResources($resources, $type = 'fileAndDir')
|
||||
{
|
||||
if (!in_array($type, ['file', 'dir', 'fileAndDir'])) {
|
||||
throw new \InvalidArgumentException(sprintf('Invalid resource check of type "%s" used!', $type));
|
||||
}
|
||||
if (is_string($resources)) {
|
||||
$resources = [$resources];
|
||||
}
|
||||
$success = true;
|
||||
foreach ($resources as $resource) {
|
||||
$glob = glob($resource);
|
||||
if ($glob === false) {
|
||||
$this->printTaskError(sprintf('Invalid glob "%s"!', $resource), $this);
|
||||
$success = false;
|
||||
continue;
|
||||
}
|
||||
foreach ($glob as $resource) {
|
||||
if (!$this->checkResource($resource, $type)) {
|
||||
$success = false;
|
||||
}
|
||||
}
|
||||
}
|
||||
return $success;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks a single resource, file or directory.
|
||||
*
|
||||
* It will print an error as well on the console.
|
||||
*
|
||||
* @param string $resource File or folder.
|
||||
* @param string $type "file", "dir", "fileAndDir"
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
protected function checkResource($resource, $type)
|
||||
{
|
||||
switch ($type) {
|
||||
case 'file':
|
||||
if (!$this->isFile($resource)) {
|
||||
$this->printTaskError(sprintf('File "%s" does not exist!', $resource), $this);
|
||||
return false;
|
||||
}
|
||||
return true;
|
||||
case 'dir':
|
||||
if (!$this->isDir($resource)) {
|
||||
$this->printTaskError(sprintf('Directory "%s" does not exist!', $resource), $this);
|
||||
return false;
|
||||
}
|
||||
return true;
|
||||
case 'fileAndDir':
|
||||
if (!$this->isDir($resource) && !$this->isFile($resource)) {
|
||||
$this->printTaskError(sprintf('File or directory "%s" does not exist!', $resource), $this);
|
||||
return false;
|
||||
}
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Convenience method to check the often uses "source => target" file / folder arrays.
|
||||
*
|
||||
* @param string|array $resources
|
||||
*/
|
||||
protected function checkSourceAndTargetResource($resources)
|
||||
{
|
||||
if (is_string($resources)) {
|
||||
$resources = [$resources];
|
||||
}
|
||||
$sources = [];
|
||||
$targets = [];
|
||||
foreach ($resources as $source => $target) {
|
||||
$sources[] = $source;
|
||||
$target[] = $target;
|
||||
}
|
||||
$this->checkResources($sources);
|
||||
$this->checkResources($targets);
|
||||
}
|
||||
|
||||
/**
|
||||
* Wrapper method around phps is_dir()
|
||||
*
|
||||
* @param string $directory
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
protected function isDir($directory)
|
||||
{
|
||||
return is_dir($directory);
|
||||
}
|
||||
|
||||
/**
|
||||
* Wrapper method around phps file_exists()
|
||||
*
|
||||
* @param string $file
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
protected function isFile($file)
|
||||
{
|
||||
return file_exists($file);
|
||||
}
|
||||
}
|
||||
237
vendor/consolidation/robo/src/Common/TaskIO.php
vendored
Normal file
237
vendor/consolidation/robo/src/Common/TaskIO.php
vendored
Normal file
|
|
@ -0,0 +1,237 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
use Robo\Robo;
|
||||
use Robo\TaskInfo;
|
||||
use Consolidation\Log\ConsoleLogLevel;
|
||||
use Psr\Log\LoggerAwareTrait;
|
||||
use Psr\Log\LogLevel;
|
||||
use Robo\Contract\ProgressIndicatorAwareInterface;
|
||||
|
||||
/**
|
||||
* Task input/output methods. TaskIO is 'used' in BaseTask, so any
|
||||
* task that extends this class has access to all of the methods here.
|
||||
* printTaskInfo, printTaskSuccess, and printTaskError are the three
|
||||
* primary output methods that tasks are encouraged to use. Tasks should
|
||||
* avoid using the IO trait output methods.
|
||||
*/
|
||||
trait TaskIO
|
||||
{
|
||||
use LoggerAwareTrait;
|
||||
use ConfigAwareTrait;
|
||||
use VerbosityThresholdTrait;
|
||||
|
||||
/**
|
||||
* @return mixed|null|\Psr\Log\LoggerInterface
|
||||
*/
|
||||
public function logger()
|
||||
{
|
||||
// $this->logger should always be set in Robo core tasks.
|
||||
if ($this->logger) {
|
||||
return $this->logger;
|
||||
}
|
||||
|
||||
// TODO: Remove call to Robo::logger() once maintaining backwards
|
||||
// compatibility with legacy external Robo tasks is no longer desired.
|
||||
if (!Robo::logger()) {
|
||||
return null;
|
||||
}
|
||||
|
||||
static $gaveDeprecationWarning = false;
|
||||
if (!$gaveDeprecationWarning) {
|
||||
trigger_error('No logger set for ' . get_class($this) . '. Use $this->task(Foo::class) rather than new Foo() in loadTasks to ensure the builder can initialize task the task, or use $this->collectionBuilder()->taskFoo() if creating one task from within another.', E_USER_DEPRECATED);
|
||||
$gaveDeprecationWarning = true;
|
||||
}
|
||||
return Robo::logger();
|
||||
}
|
||||
|
||||
/**
|
||||
* Print information about a task in progress.
|
||||
*
|
||||
* With the Symfony Console logger, NOTICE is displayed at VERBOSITY_VERBOSE
|
||||
* and INFO is displayed at VERBOSITY_VERY_VERBOSE.
|
||||
*
|
||||
* Robo overrides the default such that NOTICE is displayed at
|
||||
* VERBOSITY_NORMAL and INFO is displayed at VERBOSITY_VERBOSE.
|
||||
*
|
||||
* n.b. We should probably have printTaskNotice for our ordinary
|
||||
* output, and use printTaskInfo for less interesting messages.
|
||||
*
|
||||
* @param string $text
|
||||
* @param null|array $context
|
||||
*/
|
||||
protected function printTaskInfo($text, $context = null)
|
||||
{
|
||||
// The 'note' style is used for both 'notice' and 'info' log levels;
|
||||
// However, 'notice' is printed at VERBOSITY_NORMAL, whereas 'info'
|
||||
// is only printed at VERBOSITY_VERBOSE.
|
||||
$this->printTaskOutput(LogLevel::NOTICE, $text, $this->getTaskContext($context));
|
||||
}
|
||||
|
||||
/**
|
||||
* Provide notification that some part of the task succeeded.
|
||||
*
|
||||
* With the Symfony Console logger, success messages are remapped to NOTICE,
|
||||
* and displayed in VERBOSITY_VERBOSE. When used with the Robo logger,
|
||||
* success messages are displayed at VERBOSITY_NORMAL.
|
||||
*
|
||||
* @param string $text
|
||||
* @param null|array $context
|
||||
*/
|
||||
protected function printTaskSuccess($text, $context = null)
|
||||
{
|
||||
// Not all loggers will recognize ConsoleLogLevel::SUCCESS.
|
||||
// We therefore log as LogLevel::NOTICE, and apply a '_level'
|
||||
// override in the context so that this message will be
|
||||
// logged as SUCCESS if that log level is recognized.
|
||||
$context['_level'] = ConsoleLogLevel::SUCCESS;
|
||||
$this->printTaskOutput(LogLevel::NOTICE, $text, $this->getTaskContext($context));
|
||||
}
|
||||
|
||||
/**
|
||||
* Provide notification that there is something wrong, but
|
||||
* execution can continue.
|
||||
*
|
||||
* Warning messages are displayed at VERBOSITY_NORMAL.
|
||||
*
|
||||
* @param string $text
|
||||
* @param null|array $context
|
||||
*/
|
||||
protected function printTaskWarning($text, $context = null)
|
||||
{
|
||||
$this->printTaskOutput(LogLevel::WARNING, $text, $this->getTaskContext($context));
|
||||
}
|
||||
|
||||
/**
|
||||
* Provide notification that some operation in the task failed,
|
||||
* and the task cannot continue.
|
||||
*
|
||||
* Error messages are displayed at VERBOSITY_NORMAL.
|
||||
*
|
||||
* @param string $text
|
||||
* @param null|array $context
|
||||
*/
|
||||
protected function printTaskError($text, $context = null)
|
||||
{
|
||||
$this->printTaskOutput(LogLevel::ERROR, $text, $this->getTaskContext($context));
|
||||
}
|
||||
|
||||
/**
|
||||
* Provide debugging notification. These messages are only
|
||||
* displayed if the log level is VERBOSITY_DEBUG.
|
||||
*
|
||||
* @param string$text
|
||||
* @param null|array $context
|
||||
*/
|
||||
protected function printTaskDebug($text, $context = null)
|
||||
{
|
||||
$this->printTaskOutput(LogLevel::DEBUG, $text, $this->getTaskContext($context));
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $level
|
||||
* One of the \Psr\Log\LogLevel constant
|
||||
* @param string $text
|
||||
* @param null|array $context
|
||||
*/
|
||||
protected function printTaskOutput($level, $text, $context)
|
||||
{
|
||||
if (!$this->verbosityMeetsThreshold()) {
|
||||
return;
|
||||
}
|
||||
$logger = $this->logger();
|
||||
if (!$logger) {
|
||||
return;
|
||||
}
|
||||
// Hide the progress indicator, if it is visible.
|
||||
$inProgress = $this->hideTaskProgress();
|
||||
$logger->log($level, $text, $this->getTaskContext($context));
|
||||
// After we have printed our log message, redraw the progress indicator.
|
||||
$this->showTaskProgress($inProgress);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return bool
|
||||
*/
|
||||
protected function hideTaskProgress()
|
||||
{
|
||||
$inProgress = false;
|
||||
if ($this instanceof ProgressIndicatorAwareInterface) {
|
||||
$inProgress = $this->inProgress();
|
||||
}
|
||||
|
||||
// If a progress indicator is running on this task, then we mush
|
||||
// hide it before we print anything, or its display will be overwritten.
|
||||
if ($inProgress) {
|
||||
$inProgress = $this->hideProgressIndicator();
|
||||
}
|
||||
return $inProgress;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param $inProgress
|
||||
*/
|
||||
protected function showTaskProgress($inProgress)
|
||||
{
|
||||
if ($inProgress) {
|
||||
$this->restoreProgressIndicator($inProgress);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Format a quantity of bytes.
|
||||
*
|
||||
* @param int $size
|
||||
* @param int $precision
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function formatBytes($size, $precision = 2)
|
||||
{
|
||||
if ($size === 0) {
|
||||
return 0;
|
||||
}
|
||||
$base = log($size, 1024);
|
||||
$suffixes = array('', 'k', 'M', 'G', 'T');
|
||||
return round(pow(1024, $base - floor($base)), $precision) . $suffixes[floor($base)];
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the formatted task name for use in task output.
|
||||
* This is placed in the task context under 'name', and
|
||||
* used as the log label by Robo\Common\RoboLogStyle,
|
||||
* which is inserted at the head of log messages by
|
||||
* Robo\Common\CustomLogStyle::formatMessage().
|
||||
*
|
||||
* @param null|object $task
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function getPrintedTaskName($task = null)
|
||||
{
|
||||
if (!$task) {
|
||||
$task = $this;
|
||||
}
|
||||
return TaskInfo::formatTaskName($task);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param null|array $context
|
||||
*
|
||||
* @return array with context information
|
||||
*/
|
||||
protected function getTaskContext($context = null)
|
||||
{
|
||||
if (!$context) {
|
||||
$context = [];
|
||||
}
|
||||
if (!is_array($context)) {
|
||||
$context = ['task' => $context];
|
||||
}
|
||||
if (!array_key_exists('task', $context)) {
|
||||
$context['task'] = $this;
|
||||
}
|
||||
|
||||
return $context + TaskInfo::getTaskContext($context['task']);
|
||||
}
|
||||
}
|
||||
69
vendor/consolidation/robo/src/Common/TimeKeeper.php
vendored
Normal file
69
vendor/consolidation/robo/src/Common/TimeKeeper.php
vendored
Normal file
|
|
@ -0,0 +1,69 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
class TimeKeeper
|
||||
{
|
||||
const MINUTE = 60;
|
||||
const HOUR = 3600;
|
||||
const DAY = 86400;
|
||||
|
||||
/**
|
||||
* @var float
|
||||
*/
|
||||
protected $startedAt;
|
||||
|
||||
/**
|
||||
* @var float
|
||||
*/
|
||||
protected $finishedAt;
|
||||
|
||||
public function start()
|
||||
{
|
||||
if ($this->startedAt) {
|
||||
return;
|
||||
}
|
||||
// Get time in seconds as a float, accurate to the microsecond.
|
||||
$this->startedAt = microtime(true);
|
||||
}
|
||||
|
||||
public function stop()
|
||||
{
|
||||
$this->finishedAt = microtime(true);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return float|null
|
||||
*/
|
||||
public function elapsed()
|
||||
{
|
||||
$finished = $this->finishedAt ? $this->finishedAt : microtime(true);
|
||||
if ($finished - $this->startedAt <= 0) {
|
||||
return null;
|
||||
}
|
||||
return $finished - $this->startedAt;
|
||||
}
|
||||
|
||||
/**
|
||||
* Format a duration into a human-readable time
|
||||
*
|
||||
* @param float $duration Duration in seconds, with fractional component
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function formatDuration($duration)
|
||||
{
|
||||
if ($duration >= self::DAY * 2) {
|
||||
return gmdate('z \d\a\y\s H:i:s', $duration);
|
||||
}
|
||||
if ($duration > self::DAY) {
|
||||
return gmdate('\1 \d\a\y H:i:s', $duration);
|
||||
}
|
||||
if ($duration > self::HOUR) {
|
||||
return gmdate("H:i:s", $duration);
|
||||
}
|
||||
if ($duration > self::MINUTE) {
|
||||
return gmdate("i:s", $duration);
|
||||
}
|
||||
return round($duration, 3).'s';
|
||||
}
|
||||
}
|
||||
37
vendor/consolidation/robo/src/Common/Timer.php
vendored
Normal file
37
vendor/consolidation/robo/src/Common/Timer.php
vendored
Normal file
|
|
@ -0,0 +1,37 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
trait Timer
|
||||
{
|
||||
/**
|
||||
* @var \Robo\Common\TimeKeeper
|
||||
*/
|
||||
protected $timer;
|
||||
|
||||
protected function startTimer()
|
||||
{
|
||||
if (!isset($this->timer)) {
|
||||
$this->timer = new TimeKeeper();
|
||||
}
|
||||
$this->timer->start();
|
||||
}
|
||||
|
||||
protected function stopTimer()
|
||||
{
|
||||
if (!isset($this->timer)) {
|
||||
return;
|
||||
}
|
||||
$this->timer->stop();
|
||||
}
|
||||
|
||||
/**
|
||||
* @return float|null
|
||||
*/
|
||||
protected function getExecutionTime()
|
||||
{
|
||||
if (!isset($this->timer)) {
|
||||
return null;
|
||||
}
|
||||
return $this->timer->elapsed();
|
||||
}
|
||||
}
|
||||
79
vendor/consolidation/robo/src/Common/VerbosityThresholdTrait.php
vendored
Normal file
79
vendor/consolidation/robo/src/Common/VerbosityThresholdTrait.php
vendored
Normal file
|
|
@ -0,0 +1,79 @@
|
|||
<?php
|
||||
namespace Robo\Common;
|
||||
|
||||
use Robo\Robo;
|
||||
use Robo\TaskInfo;
|
||||
use Robo\Contract\OutputAdapterInterface;
|
||||
use Robo\Contract\VerbosityThresholdInterface;
|
||||
use Consolidation\Log\ConsoleLogLevel;
|
||||
use Psr\Log\LoggerAwareTrait;
|
||||
use Psr\Log\LogLevel;
|
||||
use Robo\Contract\ProgressIndicatorAwareInterface;
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
|
||||
/**
|
||||
* Task input/output methods. TaskIO is 'used' in BaseTask, so any
|
||||
* task that extends this class has access to all of the methods here.
|
||||
* printTaskInfo, printTaskSuccess, and printTaskError are the three
|
||||
* primary output methods that tasks are encouraged to use. Tasks should
|
||||
* avoid using the IO trait output methods.
|
||||
*/
|
||||
trait VerbosityThresholdTrait
|
||||
{
|
||||
/** var OutputAdapterInterface */
|
||||
protected $outputAdapter;
|
||||
protected $verbosityThreshold = 0;
|
||||
|
||||
/**
|
||||
* Required verbocity level before any TaskIO output will be produced.
|
||||
* e.g. OutputInterface::VERBOSITY_VERBOSE
|
||||
*/
|
||||
public function setVerbosityThreshold($verbosityThreshold)
|
||||
{
|
||||
$this->verbosityThreshold = $verbosityThreshold;
|
||||
return $this;
|
||||
}
|
||||
|
||||
public function verbosityThreshold()
|
||||
{
|
||||
return $this->verbosityThreshold;
|
||||
}
|
||||
|
||||
public function setOutputAdapter(OutputAdapterInterface $outputAdapter)
|
||||
{
|
||||
$this->outputAdapter = $outputAdapter;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return OutputAdapterInterface
|
||||
*/
|
||||
public function outputAdapter()
|
||||
{
|
||||
return $this->outputAdapter;
|
||||
}
|
||||
|
||||
public function hasOutputAdapter()
|
||||
{
|
||||
return isset($this->outputAdapter);
|
||||
}
|
||||
|
||||
public function verbosityMeetsThreshold()
|
||||
{
|
||||
if ($this->hasOutputAdapter()) {
|
||||
return $this->outputAdapter()->verbosityMeetsThreshold($this->verbosityThreshold());
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Print a message if the selected verbosity level is over this task's
|
||||
* verbosity threshhold.
|
||||
*/
|
||||
public function writeMessage($message)
|
||||
{
|
||||
if (!$this->verbosityMeetsThreshold()) {
|
||||
return;
|
||||
}
|
||||
$this->outputAdapter()->writeMessage($message);
|
||||
}
|
||||
}
|
||||
9
vendor/consolidation/robo/src/Config.php
vendored
Normal file
9
vendor/consolidation/robo/src/Config.php
vendored
Normal file
|
|
@ -0,0 +1,9 @@
|
|||
<?php
|
||||
namespace Robo;
|
||||
|
||||
/**
|
||||
* @deprecated Use \Robo\Config\Config
|
||||
*/
|
||||
class Config extends \Robo\Config\Config
|
||||
{
|
||||
}
|
||||
161
vendor/consolidation/robo/src/Config/Config.php
vendored
Normal file
161
vendor/consolidation/robo/src/Config/Config.php
vendored
Normal file
|
|
@ -0,0 +1,161 @@
|
|||
<?php
|
||||
namespace Robo\Config;
|
||||
|
||||
use Consolidation\Config\Util\ConfigOverlay;
|
||||
use Consolidation\Config\ConfigInterface;
|
||||
|
||||
class Config extends ConfigOverlay implements GlobalOptionDefaultValuesInterface
|
||||
{
|
||||
const PROGRESS_BAR_AUTO_DISPLAY_INTERVAL = 'options.progress-delay';
|
||||
const DEFAULT_PROGRESS_DELAY = 2;
|
||||
const SIMULATE = 'options.simulate';
|
||||
|
||||
// Read-only configuration properties; changing these has no effect.
|
||||
const INTERACTIVE = 'options.interactive';
|
||||
const DECORATED = 'options.decorated';
|
||||
|
||||
/**
|
||||
* Create a new configuration object, and initialize it with
|
||||
* the provided nested array containing configuration data.
|
||||
*/
|
||||
public function __construct(array $data = null)
|
||||
{
|
||||
parent::__construct();
|
||||
|
||||
$this->import($data);
|
||||
$this->defaults = $this->getGlobalOptionDefaultValues();
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function import($data)
|
||||
{
|
||||
return $this->replace($data);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function replace($data)
|
||||
{
|
||||
$this->getContext(ConfigOverlay::DEFAULT_CONTEXT)->replace($data);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function combine($data)
|
||||
{
|
||||
$this->getContext(ConfigOverlay::DEFAULT_CONTEXT)->combine($data);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Return an associative array containing all of the global configuration
|
||||
* options and their default values.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function getGlobalOptionDefaultValues()
|
||||
{
|
||||
$globalOptions =
|
||||
[
|
||||
self::PROGRESS_BAR_AUTO_DISPLAY_INTERVAL => self::DEFAULT_PROGRESS_DELAY,
|
||||
self::SIMULATE => false,
|
||||
];
|
||||
return $this->trimPrefixFromGlobalOptions($globalOptions);
|
||||
}
|
||||
|
||||
/**
|
||||
* Remove the 'options.' prefix from the global options list.
|
||||
*/
|
||||
protected function trimPrefixFromGlobalOptions($globalOptions)
|
||||
{
|
||||
$result = [];
|
||||
foreach ($globalOptions as $option => $value) {
|
||||
$option = str_replace('options.', '', $option);
|
||||
$result[$option] = $value;
|
||||
}
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* @deprecated Use $config->get(Config::SIMULATE)
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function isSimulated()
|
||||
{
|
||||
return $this->get(self::SIMULATE);
|
||||
}
|
||||
|
||||
/**
|
||||
* @deprecated Use $config->set(Config::SIMULATE, true)
|
||||
*
|
||||
* @param bool $simulated
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setSimulated($simulated = true)
|
||||
{
|
||||
return $this->set(self::SIMULATE, $simulated);
|
||||
}
|
||||
|
||||
/**
|
||||
* @deprecated Use $config->get(Config::INTERACTIVE)
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function isInteractive()
|
||||
{
|
||||
return $this->get(self::INTERACTIVE);
|
||||
}
|
||||
|
||||
/**
|
||||
* @deprecated Use $config->set(Config::INTERACTIVE, true)
|
||||
*
|
||||
* @param bool $interactive
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setInteractive($interactive = true)
|
||||
{
|
||||
return $this->set(self::INTERACTIVE, $interactive);
|
||||
}
|
||||
|
||||
/**
|
||||
* @deprecated Use $config->get(Config::DECORATED)
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function isDecorated()
|
||||
{
|
||||
return $this->get(self::DECORATED);
|
||||
}
|
||||
|
||||
/**
|
||||
* @deprecated Use $config->set(Config::DECORATED, true)
|
||||
*
|
||||
* @param bool $decorated
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setDecorated($decorated = true)
|
||||
{
|
||||
return $this->set(self::DECORATED, $decorated);
|
||||
}
|
||||
|
||||
/**
|
||||
* @deprecated Use $config->set(Config::PROGRESS_BAR_AUTO_DISPLAY_INTERVAL, $interval)
|
||||
*
|
||||
* @param int $interval
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setProgressBarAutoDisplayInterval($interval)
|
||||
{
|
||||
return $this->set(self::PROGRESS_BAR_AUTO_DISPLAY_INTERVAL, $interval);
|
||||
}
|
||||
}
|
||||
17
vendor/consolidation/robo/src/Config/GlobalOptionDefaultValuesInterface.php
vendored
Normal file
17
vendor/consolidation/robo/src/Config/GlobalOptionDefaultValuesInterface.php
vendored
Normal file
|
|
@ -0,0 +1,17 @@
|
|||
<?php
|
||||
namespace Robo\Config;
|
||||
|
||||
/**
|
||||
* @deprecated Use robo.yml instead
|
||||
*
|
||||
* robo.yml:
|
||||
*
|
||||
* options:
|
||||
* simulated: false
|
||||
* progress-delay: 2
|
||||
*
|
||||
* etc.
|
||||
*/
|
||||
interface GlobalOptionDefaultValuesInterface extends \Consolidation\Config\GlobalOptionDefaultValuesInterface
|
||||
{
|
||||
}
|
||||
22
vendor/consolidation/robo/src/Contract/BuilderAwareInterface.php
vendored
Normal file
22
vendor/consolidation/robo/src/Contract/BuilderAwareInterface.php
vendored
Normal file
|
|
@ -0,0 +1,22 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Contract;
|
||||
|
||||
use Robo\Collection\CollectionBuilder;
|
||||
|
||||
interface BuilderAwareInterface
|
||||
{
|
||||
/**
|
||||
* Set the builder reference
|
||||
*
|
||||
* @param \Robo\Collection\CollectionBuilder $builder
|
||||
*/
|
||||
public function setBuilder(CollectionBuilder $builder);
|
||||
|
||||
/**
|
||||
* Get the builder reference
|
||||
*
|
||||
* @return \Robo\Collection\CollectionBuilder
|
||||
*/
|
||||
public function getBuilder();
|
||||
}
|
||||
20
vendor/consolidation/robo/src/Contract/CommandInterface.php
vendored
Normal file
20
vendor/consolidation/robo/src/Contract/CommandInterface.php
vendored
Normal file
|
|
@ -0,0 +1,20 @@
|
|||
<?php
|
||||
namespace Robo\Contract;
|
||||
|
||||
/**
|
||||
* Task that implements this interface can be injected as a parameter for other task.
|
||||
* This task can be represented as executable command.
|
||||
*
|
||||
* @package Robo\Contract
|
||||
*/
|
||||
interface CommandInterface
|
||||
{
|
||||
|
||||
/**
|
||||
* Returns command that can be executed.
|
||||
* This method is used to pass generated command from one task to another.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getCommand();
|
||||
}
|
||||
18
vendor/consolidation/robo/src/Contract/CompletionInterface.php
vendored
Normal file
18
vendor/consolidation/robo/src/Contract/CompletionInterface.php
vendored
Normal file
|
|
@ -0,0 +1,18 @@
|
|||
<?php
|
||||
namespace Robo\Contract;
|
||||
|
||||
/**
|
||||
* Any Robo tasks that implements this interface will
|
||||
* be called when the task collection it is added to
|
||||
* completes.
|
||||
*
|
||||
* Interface CompletionInterface
|
||||
* @package Robo\Contract
|
||||
*/
|
||||
interface CompletionInterface extends TaskInterface
|
||||
{
|
||||
/**
|
||||
* Revert an operation that can be rolled back
|
||||
*/
|
||||
public function complete();
|
||||
}
|
||||
24
vendor/consolidation/robo/src/Contract/ConfigAwareInterface.php
vendored
Normal file
24
vendor/consolidation/robo/src/Contract/ConfigAwareInterface.php
vendored
Normal file
|
|
@ -0,0 +1,24 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Contract;
|
||||
|
||||
use Consolidation\Config\ConfigInterface;
|
||||
|
||||
interface ConfigAwareInterface
|
||||
{
|
||||
/**
|
||||
* Set the config reference
|
||||
*
|
||||
* @param ConfigInterface $config
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setConfig(ConfigInterface $config);
|
||||
|
||||
/**
|
||||
* Get the config reference
|
||||
*
|
||||
* @return ConfigInterface
|
||||
*/
|
||||
public function getConfig();
|
||||
}
|
||||
13
vendor/consolidation/robo/src/Contract/IOAwareInterface.php
vendored
Normal file
13
vendor/consolidation/robo/src/Contract/IOAwareInterface.php
vendored
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
<?php
|
||||
|
||||
/**
|
||||
* Marker interface for tasks that use the IO trait
|
||||
*/
|
||||
|
||||
namespace Robo\Contract;
|
||||
|
||||
use \Symfony\Component\Console\Input\InputAwareInterface;
|
||||
|
||||
interface IOAwareInterface extends OutputAwareInterface, InputAwareInterface
|
||||
{
|
||||
}
|
||||
52
vendor/consolidation/robo/src/Contract/InflectionInterface.php
vendored
Normal file
52
vendor/consolidation/robo/src/Contract/InflectionInterface.php
vendored
Normal file
|
|
@ -0,0 +1,52 @@
|
|||
<?php
|
||||
namespace Robo\Contract;
|
||||
|
||||
interface InflectionInterface
|
||||
{
|
||||
/**
|
||||
* Based on league/container inflection: http://container.thephpleague.com/inflectors/
|
||||
*
|
||||
* This allows us to run:
|
||||
*
|
||||
* (new SomeTask($args))
|
||||
* ->inflect($this)
|
||||
* ->initializer()
|
||||
* ->...
|
||||
*
|
||||
* Instead of:
|
||||
*
|
||||
* (new SomeTask($args))
|
||||
* ->setLogger($this->logger)
|
||||
* ->initializer()
|
||||
* ->...
|
||||
*
|
||||
* The reason `inflect` is better than the more explicit alternative is
|
||||
* that subclasses of BaseTask that implement a new FooAwareInterface
|
||||
* can override injectDependencies() as explained below, and add more
|
||||
* dependencies that can be injected as needed.
|
||||
*
|
||||
* @param \Robo\Contract\InflectionInterface $parent
|
||||
*/
|
||||
public function inflect(InflectionInterface $parent);
|
||||
|
||||
/**
|
||||
* Take all dependencies availble to this task and inject any that are
|
||||
* needed into the provided task. The general pattern is that, for every
|
||||
* FooAwareInterface that this class implements, it should test to see
|
||||
* if the child also implements the same interface, and if so, should call
|
||||
* $child->setFoo($this->foo).
|
||||
*
|
||||
* The benefits of this are pretty large. Any time an object that implements
|
||||
* InflectionInterface is created, just call `$child->inflect($this)`, and
|
||||
* any available optional dependencies will be hooked up via setter injection.
|
||||
*
|
||||
* The required dependencies of an object should be provided via constructor
|
||||
* injection, not inflection.
|
||||
*
|
||||
* @param InflectionInterface $child An object created by this class that
|
||||
* should have its dependencies injected.
|
||||
*
|
||||
* @see https://mwop.net/blog/2016-04-26-on-locators.html
|
||||
*/
|
||||
public function injectDependencies(InflectionInterface $child);
|
||||
}
|
||||
11
vendor/consolidation/robo/src/Contract/OutputAdapterInterface.php
vendored
Normal file
11
vendor/consolidation/robo/src/Contract/OutputAdapterInterface.php
vendored
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
<?php
|
||||
namespace Robo\Contract;
|
||||
|
||||
/**
|
||||
* Adapt OutputInterface or other output function to the VerbosityThresholdInterface.
|
||||
*/
|
||||
interface OutputAdapterInterface
|
||||
{
|
||||
public function verbosityMeetsThreshold($verbosityThreshold);
|
||||
public function writeMessage($message);
|
||||
}
|
||||
19
vendor/consolidation/robo/src/Contract/OutputAwareInterface.php
vendored
Normal file
19
vendor/consolidation/robo/src/Contract/OutputAwareInterface.php
vendored
Normal file
|
|
@ -0,0 +1,19 @@
|
|||
<?php
|
||||
|
||||
/**
|
||||
* Provide OutputAwareInterface, not present in Symfony Console
|
||||
*/
|
||||
|
||||
namespace Robo\Contract;
|
||||
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
|
||||
interface OutputAwareInterface
|
||||
{
|
||||
/**
|
||||
* Sets the Console Output.
|
||||
*
|
||||
* @param \Symfony\Component\Console\Output\OutputInterface $output
|
||||
*/
|
||||
public function setOutput(OutputInterface $output);
|
||||
}
|
||||
16
vendor/consolidation/robo/src/Contract/PrintedInterface.php
vendored
Normal file
16
vendor/consolidation/robo/src/Contract/PrintedInterface.php
vendored
Normal file
|
|
@ -0,0 +1,16 @@
|
|||
<?php
|
||||
namespace Robo\Contract;
|
||||
|
||||
/**
|
||||
* If task prints anything to console
|
||||
*
|
||||
* Interface PrintedInterface
|
||||
* @package Robo\Contract
|
||||
*/
|
||||
interface PrintedInterface
|
||||
{
|
||||
/**
|
||||
* @return bool
|
||||
*/
|
||||
public function getPrinted();
|
||||
}
|
||||
24
vendor/consolidation/robo/src/Contract/ProgressIndicatorAwareInterface.php
vendored
Normal file
24
vendor/consolidation/robo/src/Contract/ProgressIndicatorAwareInterface.php
vendored
Normal file
|
|
@ -0,0 +1,24 @@
|
|||
<?php
|
||||
namespace Robo\Contract;
|
||||
|
||||
/**
|
||||
* Any Robo task that uses the Timer trait and
|
||||
* implements ProgressIndicatorAwareInterface will
|
||||
* display a progress bar while the timer is running.
|
||||
* Call advanceProgressIndicator to advance the indicator.
|
||||
*
|
||||
* Interface ProgressIndicatorAwareInterface
|
||||
* @package Robo\Contract
|
||||
*/
|
||||
interface ProgressIndicatorAwareInterface
|
||||
{
|
||||
/**
|
||||
* @return int
|
||||
*/
|
||||
public function progressIndicatorSteps();
|
||||
|
||||
/**
|
||||
* @param \Robo\Common\ProgressIndicator $progressIndicator
|
||||
*/
|
||||
public function setProgressIndicator($progressIndicator);
|
||||
}
|
||||
19
vendor/consolidation/robo/src/Contract/ProgressInterface.php
vendored
Normal file
19
vendor/consolidation/robo/src/Contract/ProgressInterface.php
vendored
Normal file
|
|
@ -0,0 +1,19 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Contract;
|
||||
|
||||
/**
|
||||
* Robo tasks that take multiple steps to complete should
|
||||
* implement this interface.
|
||||
*
|
||||
* Interface ProgressInterface
|
||||
* @package Robo\Contract
|
||||
*/
|
||||
interface ProgressInterface
|
||||
{
|
||||
/**
|
||||
*
|
||||
* @return int
|
||||
*/
|
||||
public function progressSteps();
|
||||
}
|
||||
18
vendor/consolidation/robo/src/Contract/RollbackInterface.php
vendored
Normal file
18
vendor/consolidation/robo/src/Contract/RollbackInterface.php
vendored
Normal file
|
|
@ -0,0 +1,18 @@
|
|||
<?php
|
||||
namespace Robo\Contract;
|
||||
|
||||
/**
|
||||
* Any Robo tasks that implements this interface will
|
||||
* be called when the task collection it is added to
|
||||
* fails, and runs its rollback operation.
|
||||
*
|
||||
* Interface RollbackInterface
|
||||
* @package Robo\Contract
|
||||
*/
|
||||
interface RollbackInterface extends TaskInterface
|
||||
{
|
||||
/**
|
||||
* Revert an operation that can be rolled back
|
||||
*/
|
||||
public function rollback();
|
||||
}
|
||||
18
vendor/consolidation/robo/src/Contract/SimulatedInterface.php
vendored
Normal file
18
vendor/consolidation/robo/src/Contract/SimulatedInterface.php
vendored
Normal file
|
|
@ -0,0 +1,18 @@
|
|||
<?php
|
||||
namespace Robo\Contract;
|
||||
|
||||
/**
|
||||
* Task that implements this interface can be injected as a parameter for other task.
|
||||
* This task can be represented as executable command.
|
||||
*
|
||||
* @package Robo\Contract
|
||||
*/
|
||||
interface SimulatedInterface extends TaskInterface
|
||||
{
|
||||
/**
|
||||
* Called in place of `run()` for simulated tasks.
|
||||
*
|
||||
* @param null|array $context
|
||||
*/
|
||||
public function simulate($context);
|
||||
}
|
||||
17
vendor/consolidation/robo/src/Contract/TaskInterface.php
vendored
Normal file
17
vendor/consolidation/robo/src/Contract/TaskInterface.php
vendored
Normal file
|
|
@ -0,0 +1,17 @@
|
|||
<?php
|
||||
namespace Robo\Contract;
|
||||
|
||||
/**
|
||||
* All Robo tasks should implement this interface.
|
||||
* Task should be configured by chained methods.
|
||||
*
|
||||
* Interface TaskInterface
|
||||
* @package Robo\Contract
|
||||
*/
|
||||
interface TaskInterface
|
||||
{
|
||||
/**
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
public function run();
|
||||
}
|
||||
24
vendor/consolidation/robo/src/Contract/VerbosityThresholdInterface.php
vendored
Normal file
24
vendor/consolidation/robo/src/Contract/VerbosityThresholdInterface.php
vendored
Normal file
|
|
@ -0,0 +1,24 @@
|
|||
<?php
|
||||
namespace Robo\Contract;
|
||||
|
||||
use Robo\Contract\OutputAdapterInterface;
|
||||
|
||||
/**
|
||||
* Record and determine whether the current verbosity level exceeds the
|
||||
* desired threshold level to produce output.
|
||||
*/
|
||||
interface VerbosityThresholdInterface
|
||||
{
|
||||
const VERBOSITY_NORMAL = 1;
|
||||
const VERBOSITY_VERBOSE = 2;
|
||||
const VERBOSITY_VERY_VERBOSE = 3;
|
||||
const VERBOSITY_DEBUG = 4;
|
||||
|
||||
public function setVerbosityThreshold($verbosityThreshold);
|
||||
public function verbosityThreshold();
|
||||
public function setOutputAdapter(OutputAdapterInterface $outputAdapter);
|
||||
public function outputAdapter();
|
||||
public function hasOutputAdapter();
|
||||
public function verbosityMeetsThreshold();
|
||||
public function writeMessage($message);
|
||||
}
|
||||
10
vendor/consolidation/robo/src/Contract/WrappedTaskInterface.php
vendored
Normal file
10
vendor/consolidation/robo/src/Contract/WrappedTaskInterface.php
vendored
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
<?php
|
||||
namespace Robo\Contract;
|
||||
|
||||
interface WrappedTaskInterface extends TaskInterface
|
||||
{
|
||||
/**
|
||||
* @return \Robo\Contract\TaskInterface
|
||||
*/
|
||||
public function original();
|
||||
}
|
||||
13
vendor/consolidation/robo/src/Exception/TaskException.php
vendored
Normal file
13
vendor/consolidation/robo/src/Exception/TaskException.php
vendored
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
<?php
|
||||
namespace Robo\Exception;
|
||||
|
||||
class TaskException extends \Exception
|
||||
{
|
||||
public function __construct($class, $message)
|
||||
{
|
||||
if (is_object($class)) {
|
||||
$class = get_class($class);
|
||||
}
|
||||
parent::__construct(" in task $class \n\n $message");
|
||||
}
|
||||
}
|
||||
13
vendor/consolidation/robo/src/Exception/TaskExitException.php
vendored
Normal file
13
vendor/consolidation/robo/src/Exception/TaskExitException.php
vendored
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
<?php
|
||||
namespace Robo\Exception;
|
||||
|
||||
class TaskExitException extends \Exception
|
||||
{
|
||||
public function __construct($class, $message, $status)
|
||||
{
|
||||
if (is_object($class)) {
|
||||
$class = get_class($class);
|
||||
}
|
||||
parent::__construct(" in task $class \n\n $message", $status);
|
||||
}
|
||||
}
|
||||
146
vendor/consolidation/robo/src/GlobalOptionsEventListener.php
vendored
Normal file
146
vendor/consolidation/robo/src/GlobalOptionsEventListener.php
vendored
Normal file
|
|
@ -0,0 +1,146 @@
|
|||
<?php
|
||||
namespace Robo;
|
||||
|
||||
use Symfony\Component\Console\ConsoleEvents;
|
||||
use Symfony\Component\Console\Event\ConsoleCommandEvent;
|
||||
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
|
||||
use Robo\Contract\ConfigAwareInterface;
|
||||
use Robo\Common\ConfigAwareTrait;
|
||||
use Robo\Config\GlobalOptionDefaultValuesInterface;
|
||||
|
||||
class GlobalOptionsEventListener implements EventSubscriberInterface, ConfigAwareInterface
|
||||
{
|
||||
use ConfigAwareTrait;
|
||||
|
||||
/** @var Application */
|
||||
protected $application;
|
||||
|
||||
/** @var string */
|
||||
protected $prefix;
|
||||
|
||||
/**
|
||||
* GlobalOptionsEventListener listener
|
||||
*/
|
||||
public function __construct()
|
||||
{
|
||||
$this->prefix = 'options';
|
||||
}
|
||||
|
||||
/**
|
||||
* Add a reference to the Symfony Console application object.
|
||||
*/
|
||||
public function setApplication($application)
|
||||
{
|
||||
$this->application = $application;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Stipulate the prefix to use for option injection.
|
||||
* @param string $prefix
|
||||
*/
|
||||
public function setGlobalOptionsPrefix($prefix)
|
||||
{
|
||||
$this->prefix = $prefix;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public static function getSubscribedEvents()
|
||||
{
|
||||
return [ConsoleEvents::COMMAND => 'handleCommandEvent'];
|
||||
}
|
||||
|
||||
/**
|
||||
* Run all of our individual operations when a command event is received.
|
||||
*/
|
||||
public function handleCommandEvent(ConsoleCommandEvent $event)
|
||||
{
|
||||
$this->setGlobalOptions($event);
|
||||
$this->setConfigurationValues($event);
|
||||
}
|
||||
|
||||
/**
|
||||
* Before a Console command runs, examine the global
|
||||
* commandline options from the event Input, and set
|
||||
* configuration values as appropriate.
|
||||
*
|
||||
* @param \Symfony\Component\Console\Event\ConsoleCommandEvent $event
|
||||
*/
|
||||
public function setGlobalOptions(ConsoleCommandEvent $event)
|
||||
{
|
||||
$config = $this->getConfig();
|
||||
$input = $event->getInput();
|
||||
|
||||
$globalOptions = $config->get($this->prefix, []);
|
||||
if ($config instanceof \Consolidation\Config\GlobalOptionDefaultValuesInterface) {
|
||||
$globalOptions += $config->getGlobalOptionDefaultValues();
|
||||
}
|
||||
|
||||
$globalOptions += $this->applicationOptionDefaultValues();
|
||||
|
||||
// Set any config value that has a defined global option (e.g. --simulate)
|
||||
foreach ($globalOptions as $option => $default) {
|
||||
$value = $input->hasOption($option) ? $input->getOption($option) : null;
|
||||
// Unfortunately, the `?:` operator does not differentate between `0` and `null`
|
||||
if (!isset($value)) {
|
||||
$value = $default;
|
||||
}
|
||||
$config->set($this->prefix . '.' . $option, $value);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Examine the commandline --define / -D options, and apply the provided
|
||||
* values to the active configuration.
|
||||
*
|
||||
* @param \Symfony\Component\Console\Event\ConsoleCommandEvent $event
|
||||
*/
|
||||
public function setConfigurationValues(ConsoleCommandEvent $event)
|
||||
{
|
||||
$config = $this->getConfig();
|
||||
$input = $event->getInput();
|
||||
|
||||
// Also set any `-D config.key=value` options from the commandline.
|
||||
if ($input->hasOption('define')) {
|
||||
$configDefinitions = $input->getOption('define');
|
||||
foreach ($configDefinitions as $value) {
|
||||
list($key, $value) = $this->splitConfigKeyValue($value);
|
||||
$config->set($key, $value);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Split up the key=value config setting into its component parts. If
|
||||
* the input string contains no '=' character, then the value will be 'true'.
|
||||
*
|
||||
* @param string $value
|
||||
* @return array
|
||||
*/
|
||||
protected function splitConfigKeyValue($value)
|
||||
{
|
||||
$parts = explode('=', $value, 2);
|
||||
$parts[] = true;
|
||||
return $parts;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get default option values from the Symfony Console application, if
|
||||
* it is available.
|
||||
*/
|
||||
protected function applicationOptionDefaultValues()
|
||||
{
|
||||
if (!$this->application) {
|
||||
return [];
|
||||
}
|
||||
|
||||
$result = [];
|
||||
foreach ($this->application->getDefinition()->getOptions() as $key => $option) {
|
||||
$result[$key] = $option->acceptValue() ? $option->getDefault() : null;
|
||||
}
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
39
vendor/consolidation/robo/src/LoadAllTasks.php
vendored
Normal file
39
vendor/consolidation/robo/src/LoadAllTasks.php
vendored
Normal file
|
|
@ -0,0 +1,39 @@
|
|||
<?php
|
||||
namespace Robo;
|
||||
|
||||
trait LoadAllTasks
|
||||
{
|
||||
use TaskAccessor;
|
||||
|
||||
use Collection\loadTasks;
|
||||
|
||||
// standard tasks
|
||||
use Task\Base\loadTasks;
|
||||
use Task\Development\loadTasks;
|
||||
use Task\Filesystem\loadTasks;
|
||||
use Task\File\loadTasks;
|
||||
use Task\Archive\loadTasks;
|
||||
use Task\Vcs\loadTasks;
|
||||
|
||||
// package managers
|
||||
use Task\Composer\loadTasks;
|
||||
use Task\Bower\loadTasks;
|
||||
use Task\Npm\loadTasks;
|
||||
|
||||
// assets
|
||||
use Task\Assets\loadTasks;
|
||||
|
||||
// 3rd-party tools
|
||||
use Task\Remote\loadTasks;
|
||||
use Task\Testing\loadTasks;
|
||||
use Task\ApiGen\loadTasks;
|
||||
use Task\Docker\loadTasks;
|
||||
|
||||
// task runners
|
||||
use Task\Gulp\loadTasks;
|
||||
|
||||
// shortcuts
|
||||
use Task\Base\loadShortcuts;
|
||||
use Task\Filesystem\loadShortcuts;
|
||||
use Task\Vcs\loadShortcuts;
|
||||
}
|
||||
112
vendor/consolidation/robo/src/Log/ResultPrinter.php
vendored
Normal file
112
vendor/consolidation/robo/src/Log/ResultPrinter.php
vendored
Normal file
|
|
@ -0,0 +1,112 @@
|
|||
<?php
|
||||
namespace Robo\Log;
|
||||
|
||||
use Robo\Result;
|
||||
use Robo\Contract\PrintedInterface;
|
||||
use Robo\Contract\ProgressIndicatorAwareInterface;
|
||||
use Robo\Contract\VerbosityThresholdInterface;
|
||||
use Robo\Common\ProgressIndicatorAwareTrait;
|
||||
|
||||
use Psr\Log\LogLevel;
|
||||
use Psr\Log\LoggerAwareInterface;
|
||||
use Psr\Log\LoggerAwareTrait;
|
||||
use Consolidation\Log\ConsoleLogLevel;
|
||||
|
||||
/**
|
||||
* Log the creation of Result objects.
|
||||
*/
|
||||
class ResultPrinter implements LoggerAwareInterface, ProgressIndicatorAwareInterface
|
||||
{
|
||||
use LoggerAwareTrait;
|
||||
use ProgressIndicatorAwareTrait;
|
||||
|
||||
/**
|
||||
* Log the result of a Robo task.
|
||||
*
|
||||
* Returns 'true' if the message is printed, or false if it isn't.
|
||||
*
|
||||
* @param \Robo\Result $result
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function printResult(Result $result)
|
||||
{
|
||||
$task = $result->getTask();
|
||||
if ($task instanceof VerbosityThresholdInterface && !$task->verbosityMeetsThreshold()) {
|
||||
return;
|
||||
}
|
||||
if (!$result->wasSuccessful()) {
|
||||
return $this->printError($result);
|
||||
} else {
|
||||
return $this->printSuccess($result);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Log that we are about to abort due to an error being encountered
|
||||
* in 'stop on fail' mode.
|
||||
*
|
||||
* @param \Robo\Result $result
|
||||
*/
|
||||
public function printStopOnFail($result)
|
||||
{
|
||||
$this->printMessage(LogLevel::NOTICE, 'Stopping on fail. Exiting....');
|
||||
$this->printMessage(LogLevel::ERROR, 'Exit Code: {code}', ['code' => $result->getExitCode()]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Log the result of a Robo task that returned an error.
|
||||
*
|
||||
* @param \Robo\Result $result
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
protected function printError(Result $result)
|
||||
{
|
||||
$task = $result->getTask();
|
||||
$context = $result->getContext() + ['timer-label' => 'Time', '_style' => []];
|
||||
$context['_style']['message'] = '';
|
||||
|
||||
$printOutput = true;
|
||||
if ($task instanceof PrintedInterface) {
|
||||
$printOutput = !$task->getPrinted();
|
||||
}
|
||||
if ($printOutput) {
|
||||
$this->printMessage(LogLevel::ERROR, "{message}", $context);
|
||||
}
|
||||
$this->printMessage(LogLevel::ERROR, 'Exit code {code}', $context);
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Log the result of a Robo task that was successful.
|
||||
*
|
||||
* @param \Robo\Result $result
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
protected function printSuccess(Result $result)
|
||||
{
|
||||
$task = $result->getTask();
|
||||
$context = $result->getContext() + ['timer-label' => 'in'];
|
||||
$time = $result->getExecutionTime();
|
||||
if ($time) {
|
||||
$this->printMessage(ConsoleLogLevel::SUCCESS, 'Done', $context);
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $level
|
||||
* @param string $message
|
||||
* @param array $context
|
||||
*/
|
||||
protected function printMessage($level, $message, $context = [])
|
||||
{
|
||||
$inProgress = $this->hideProgressIndicator();
|
||||
$this->logger->log($level, $message, $context);
|
||||
if ($inProgress) {
|
||||
$this->restoreProgressIndicator($inProgress);
|
||||
}
|
||||
}
|
||||
}
|
||||
11
vendor/consolidation/robo/src/Log/RoboLogLevel.php
vendored
Normal file
11
vendor/consolidation/robo/src/Log/RoboLogLevel.php
vendored
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
<?php
|
||||
namespace Robo\Log;
|
||||
|
||||
class RoboLogLevel extends \Consolidation\Log\ConsoleLogLevel
|
||||
{
|
||||
/**
|
||||
* Command did something in simulated mode.
|
||||
* Displayed at VERBOSITY_NORMAL.
|
||||
*/
|
||||
const SIMULATED_ACTION = 'simulated';
|
||||
}
|
||||
74
vendor/consolidation/robo/src/Log/RoboLogStyle.php
vendored
Normal file
74
vendor/consolidation/robo/src/Log/RoboLogStyle.php
vendored
Normal file
|
|
@ -0,0 +1,74 @@
|
|||
<?php
|
||||
namespace Robo\Log;
|
||||
|
||||
use Robo\Common\TimeKeeper;
|
||||
use Consolidation\Log\LogOutputStyler;
|
||||
|
||||
/**
|
||||
* Robo Log Styler.
|
||||
*/
|
||||
class RoboLogStyle extends LogOutputStyler
|
||||
{
|
||||
const TASK_STYLE_SIMULATED = 'options=reverse;bold';
|
||||
|
||||
/**
|
||||
* RoboLogStyle constructor.
|
||||
*
|
||||
* @param array $labelStyles
|
||||
* @param array $messageStyles
|
||||
*/
|
||||
public function __construct($labelStyles = [], $messageStyles = [])
|
||||
{
|
||||
parent::__construct($labelStyles, $messageStyles);
|
||||
|
||||
$this->labelStyles += [
|
||||
RoboLogLevel::SIMULATED_ACTION => self::TASK_STYLE_SIMULATED,
|
||||
];
|
||||
$this->messageStyles += [
|
||||
RoboLogLevel::SIMULATED_ACTION => '',
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* Log style customization for Robo: replace the log level with
|
||||
* the task name.
|
||||
*
|
||||
* @param string $level
|
||||
* @param string $message
|
||||
* @param array $context
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function formatMessageByLevel($level, $message, $context)
|
||||
{
|
||||
$label = $level;
|
||||
if (array_key_exists('name', $context)) {
|
||||
$label = $context['name'];
|
||||
}
|
||||
return $this->formatMessage($label, $message, $context, $this->labelStyles[$level], $this->messageStyles[$level]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Log style customization for Robo: add the time indicator to the
|
||||
* end of the log message if it exists in the context.
|
||||
*
|
||||
* @param string $label
|
||||
* @param string $message
|
||||
* @param array $context
|
||||
* @param string $taskNameStyle
|
||||
* @param string $messageStyle
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function formatMessage($label, $message, $context, $taskNameStyle, $messageStyle = '')
|
||||
{
|
||||
$message = parent::formatMessage($label, $message, $context, $taskNameStyle, $messageStyle);
|
||||
|
||||
if (array_key_exists('time', $context) && !empty($context['time']) && array_key_exists('timer-label', $context)) {
|
||||
$duration = TimeKeeper::formatDuration($context['time']);
|
||||
$message .= ' ' . $context['timer-label'] . ' ' . $this->wrapFormatString($duration, 'fg=yellow');
|
||||
}
|
||||
|
||||
return $message;
|
||||
}
|
||||
}
|
||||
29
vendor/consolidation/robo/src/Log/RoboLogger.php
vendored
Normal file
29
vendor/consolidation/robo/src/Log/RoboLogger.php
vendored
Normal file
|
|
@ -0,0 +1,29 @@
|
|||
<?php
|
||||
namespace Robo\Log;
|
||||
|
||||
use Consolidation\Log\Logger;
|
||||
|
||||
use Psr\Log\LogLevel;
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
|
||||
/**
|
||||
* Robo's default logger
|
||||
*/
|
||||
class RoboLogger extends Logger
|
||||
{
|
||||
/**
|
||||
* @param \Symfony\Component\Console\Output\OutputInterface $output
|
||||
*/
|
||||
public function __construct(OutputInterface $output)
|
||||
{
|
||||
// In Robo, we use log level 'notice' for messages that appear all
|
||||
// the time, and 'info' for messages that appear only during verbose
|
||||
// output. We have no 'very verbose' (-vv) level. 'Debug' is -vvv, as usual.
|
||||
$roboVerbosityOverrides = [
|
||||
RoboLogLevel::SIMULATED_ACTION => OutputInterface::VERBOSITY_NORMAL, // Default is "verbose"
|
||||
LogLevel::NOTICE => OutputInterface::VERBOSITY_NORMAL, // Default is "verbose"
|
||||
LogLevel::INFO => OutputInterface::VERBOSITY_VERBOSE, // Default is "very verbose"
|
||||
];
|
||||
parent::__construct($output, $roboVerbosityOverrides);
|
||||
}
|
||||
}
|
||||
258
vendor/consolidation/robo/src/Result.php
vendored
Normal file
258
vendor/consolidation/robo/src/Result.php
vendored
Normal file
|
|
@ -0,0 +1,258 @@
|
|||
<?php
|
||||
namespace Robo;
|
||||
|
||||
use Robo\Contract\TaskInterface;
|
||||
use Robo\Exception\TaskExitException;
|
||||
use Robo\State\Data;
|
||||
|
||||
class Result extends ResultData
|
||||
{
|
||||
/**
|
||||
* @var bool
|
||||
*/
|
||||
public static $stopOnFail = false;
|
||||
|
||||
/**
|
||||
* @var \Robo\Contract\TaskInterface
|
||||
*/
|
||||
protected $task;
|
||||
|
||||
/**
|
||||
* @param \Robo\Contract\TaskInterface $task
|
||||
* @param string $exitCode
|
||||
* @param string $message
|
||||
* @param array $data
|
||||
*/
|
||||
public function __construct(TaskInterface $task, $exitCode, $message = '', $data = [])
|
||||
{
|
||||
parent::__construct($exitCode, $message, $data);
|
||||
$this->task = $task;
|
||||
$this->printResult();
|
||||
|
||||
if (self::$stopOnFail) {
|
||||
$this->stopOnFail();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Tasks should always return a Result. However, they are also
|
||||
* allowed to return NULL or an array to indicate success.
|
||||
*/
|
||||
public static function ensureResult($task, $result)
|
||||
{
|
||||
if ($result instanceof Result) {
|
||||
return $result;
|
||||
}
|
||||
if (!isset($result)) {
|
||||
return static::success($task);
|
||||
}
|
||||
if ($result instanceof Data) {
|
||||
return static::success($task, $result->getMessage(), $result->getData());
|
||||
}
|
||||
if ($result instanceof ResultData) {
|
||||
return new Result($task, $result->getExitCode(), $result->getMessage(), $result->getData());
|
||||
}
|
||||
if (is_array($result)) {
|
||||
return static::success($task, '', $result);
|
||||
}
|
||||
throw new \Exception(sprintf('Task %s returned a %s instead of a \Robo\Result.', get_class($task), get_class($result)));
|
||||
}
|
||||
|
||||
protected function printResult()
|
||||
{
|
||||
// For historic reasons, the Result constructor is responsible
|
||||
// for printing task results.
|
||||
// TODO: Make IO the responsibility of some other class. Maintaining
|
||||
// existing behavior for backwards compatibility. This is undesirable
|
||||
// in the long run, though, as it can result in unwanted repeated input
|
||||
// in task collections et. al.
|
||||
$resultPrinter = Robo::resultPrinter();
|
||||
if ($resultPrinter) {
|
||||
if ($resultPrinter->printResult($this)) {
|
||||
$this->alreadyPrinted();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Robo\Contract\TaskInterface $task
|
||||
* @param string $extension
|
||||
* @param string $service
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
public static function errorMissingExtension(TaskInterface $task, $extension, $service)
|
||||
{
|
||||
$messageTpl = 'PHP extension required for %s. Please enable %s';
|
||||
$message = sprintf($messageTpl, $service, $extension);
|
||||
|
||||
return self::error($task, $message);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Robo\Contract\TaskInterface $task
|
||||
* @param string $class
|
||||
* @param string $package
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
public static function errorMissingPackage(TaskInterface $task, $class, $package)
|
||||
{
|
||||
$messageTpl = 'Class %s not found. Please install %s Composer package';
|
||||
$message = sprintf($messageTpl, $class, $package);
|
||||
|
||||
return self::error($task, $message);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Robo\Contract\TaskInterface $task
|
||||
* @param string $message
|
||||
* @param array $data
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
public static function error(TaskInterface $task, $message, $data = [])
|
||||
{
|
||||
return new self($task, self::EXITCODE_ERROR, $message, $data);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Robo\Contract\TaskInterface $task
|
||||
* @param \Exception $e
|
||||
* @param array $data
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
public static function fromException(TaskInterface $task, \Exception $e, $data = [])
|
||||
{
|
||||
$exitCode = $e->getCode();
|
||||
if (!$exitCode) {
|
||||
$exitCode = self::EXITCODE_ERROR;
|
||||
}
|
||||
return new self($task, $exitCode, $e->getMessage(), $data);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Robo\Contract\TaskInterface $task
|
||||
* @param string $message
|
||||
* @param array $data
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
public static function success(TaskInterface $task, $message = '', $data = [])
|
||||
{
|
||||
return new self($task, self::EXITCODE_OK, $message, $data);
|
||||
}
|
||||
|
||||
/**
|
||||
* Return a context useful for logging messages.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function getContext()
|
||||
{
|
||||
$task = $this->getTask();
|
||||
|
||||
return TaskInfo::getTaskContext($task) + [
|
||||
'code' => $this->getExitCode(),
|
||||
'data' => $this->getArrayCopy(),
|
||||
'time' => $this->getExecutionTime(),
|
||||
'message' => $this->getMessage(),
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* Add the results from the most recent task to the accumulated
|
||||
* results from all tasks that have run so far, merging data
|
||||
* as necessary.
|
||||
*
|
||||
* @param int|string $key
|
||||
* @param \Robo\Result $taskResult
|
||||
*/
|
||||
public function accumulate($key, Result $taskResult)
|
||||
{
|
||||
// If the task is unnamed, then all of its data elements
|
||||
// just get merged in at the top-level of the final Result object.
|
||||
if (static::isUnnamed($key)) {
|
||||
$this->merge($taskResult);
|
||||
} elseif (isset($this[$key])) {
|
||||
// There can only be one task with a given name; however, if
|
||||
// there are tasks added 'before' or 'after' the named task,
|
||||
// then the results from these will be stored under the same
|
||||
// name unless they are given a name of their own when added.
|
||||
$current = $this[$key];
|
||||
$this[$key] = $taskResult->merge($current);
|
||||
} else {
|
||||
$this[$key] = $taskResult;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* We assume that named values (e.g. for associative array keys)
|
||||
* are non-numeric; numeric keys are presumed to simply be the
|
||||
* index of an array, and therefore insignificant.
|
||||
*
|
||||
* @param int|string $key
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public static function isUnnamed($key)
|
||||
{
|
||||
return is_numeric($key);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return \Robo\Contract\TaskInterface
|
||||
*/
|
||||
public function getTask()
|
||||
{
|
||||
return $this->task;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return \Robo\Contract\TaskInterface
|
||||
*/
|
||||
public function cloneTask()
|
||||
{
|
||||
$reflect = new \ReflectionClass(get_class($this->task));
|
||||
return $reflect->newInstanceArgs(func_get_args());
|
||||
}
|
||||
|
||||
/**
|
||||
* @return bool
|
||||
*
|
||||
* @deprecated since 1.0.
|
||||
*
|
||||
* @see wasSuccessful()
|
||||
*/
|
||||
public function __invoke()
|
||||
{
|
||||
trigger_error(__METHOD__ . ' is deprecated: use wasSuccessful() instead.', E_USER_DEPRECATED);
|
||||
return $this->wasSuccessful();
|
||||
}
|
||||
|
||||
/**
|
||||
* @return $this
|
||||
*/
|
||||
public function stopOnFail()
|
||||
{
|
||||
if (!$this->wasSuccessful()) {
|
||||
$resultPrinter = Robo::resultPrinter();
|
||||
if ($resultPrinter) {
|
||||
$resultPrinter->printStopOnFail($this);
|
||||
}
|
||||
$this->exitEarly($this->getExitCode());
|
||||
}
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int $status
|
||||
*
|
||||
* @throws \Robo\Exception\TaskExitException
|
||||
*/
|
||||
private function exitEarly($status)
|
||||
{
|
||||
throw new TaskExitException($this->getTask(), $this->getMessage(), $status);
|
||||
}
|
||||
}
|
||||
110
vendor/consolidation/robo/src/ResultData.php
vendored
Normal file
110
vendor/consolidation/robo/src/ResultData.php
vendored
Normal file
|
|
@ -0,0 +1,110 @@
|
|||
<?php
|
||||
namespace Robo;
|
||||
|
||||
use Consolidation\AnnotatedCommand\ExitCodeInterface;
|
||||
use Consolidation\AnnotatedCommand\OutputDataInterface;
|
||||
use Robo\State\Data;
|
||||
|
||||
class ResultData extends Data implements ExitCodeInterface, OutputDataInterface
|
||||
{
|
||||
/**
|
||||
* @var int
|
||||
*/
|
||||
protected $exitCode;
|
||||
|
||||
const EXITCODE_OK = 0;
|
||||
const EXITCODE_ERROR = 1;
|
||||
/** Symfony Console handles these conditions; Robo returns the status
|
||||
code selected by Symfony. These are here for documentation purposes. */
|
||||
const EXITCODE_MISSING_OPTIONS = 2;
|
||||
const EXITCODE_COMMAND_NOT_FOUND = 127;
|
||||
|
||||
/** The command was aborted because the user chose to cancel it at some prompt.
|
||||
This exit code is arbitrarily the same as EX_TEMPFAIL in sysexits.h, although
|
||||
note that shell error codes are distinct from C exit codes, so this alignment
|
||||
not particularly meaningful. */
|
||||
const EXITCODE_USER_CANCEL = 75;
|
||||
|
||||
/**
|
||||
* @param int $exitCode
|
||||
* @param string $message
|
||||
* @param array $data
|
||||
*/
|
||||
public function __construct($exitCode = self::EXITCODE_OK, $message = '', $data = [])
|
||||
{
|
||||
$this->exitCode = $exitCode;
|
||||
parent::__construct($message, $data);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $message
|
||||
* @param array $data
|
||||
*
|
||||
* @return \Robo\ResultData
|
||||
*/
|
||||
public static function message($message, $data = [])
|
||||
{
|
||||
return new self(self::EXITCODE_OK, $message, $data);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $message
|
||||
* @param array $data
|
||||
*
|
||||
* @return \Robo\ResultData
|
||||
*/
|
||||
public static function cancelled($message = '', $data = [])
|
||||
{
|
||||
return new ResultData(self::EXITCODE_USER_CANCEL, $message, $data);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return int
|
||||
*/
|
||||
public function getExitCode()
|
||||
{
|
||||
return $this->exitCode;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return null|string
|
||||
*/
|
||||
public function getOutputData()
|
||||
{
|
||||
if (!empty($this->message) && !isset($this['already-printed']) && isset($this['provide-outputdata'])) {
|
||||
return $this->message;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Indicate that the message in this data has already been displayed.
|
||||
*/
|
||||
public function alreadyPrinted()
|
||||
{
|
||||
$this['already-printed'] = true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Opt-in to providing the result message as the output data
|
||||
*/
|
||||
public function provideOutputdata()
|
||||
{
|
||||
$this['provide-outputdata'] = true;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return bool
|
||||
*/
|
||||
public function wasSuccessful()
|
||||
{
|
||||
return $this->exitCode === self::EXITCODE_OK;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return bool
|
||||
*/
|
||||
public function wasCancelled()
|
||||
{
|
||||
return $this->exitCode == self::EXITCODE_USER_CANCEL;
|
||||
}
|
||||
}
|
||||
403
vendor/consolidation/robo/src/Robo.php
vendored
Normal file
403
vendor/consolidation/robo/src/Robo.php
vendored
Normal file
|
|
@ -0,0 +1,403 @@
|
|||
<?php
|
||||
namespace Robo;
|
||||
|
||||
use Composer\Autoload\ClassLoader;
|
||||
use League\Container\Container;
|
||||
use League\Container\ContainerInterface;
|
||||
use Robo\Common\ProcessExecutor;
|
||||
use Consolidation\Config\ConfigInterface;
|
||||
use Consolidation\Config\Loader\ConfigProcessor;
|
||||
use Consolidation\Config\Loader\YamlConfigLoader;
|
||||
use Symfony\Component\Console\Input\StringInput;
|
||||
use Symfony\Component\Console\Application as SymfonyApplication;
|
||||
use Symfony\Component\Process\Process;
|
||||
|
||||
/**
|
||||
* Manages the container reference and other static data. Favor
|
||||
* using dependency injection wherever possible. Avoid using
|
||||
* this class directly, unless setting up a custom DI container.
|
||||
*/
|
||||
class Robo
|
||||
{
|
||||
const APPLICATION_NAME = 'Robo';
|
||||
const VERSION = '1.3.2';
|
||||
|
||||
/**
|
||||
* The currently active container object, or NULL if not initialized yet.
|
||||
*
|
||||
* @var ContainerInterface|null
|
||||
*/
|
||||
protected static $container;
|
||||
|
||||
/**
|
||||
* Entrypoint for standalone Robo-based tools. See docs/framework.md.
|
||||
*
|
||||
* @param string[] $argv
|
||||
* @param string $commandClasses
|
||||
* @param null|string $appName
|
||||
* @param null|string $appVersion
|
||||
* @param null|\Symfony\Component\Console\Output\OutputInterface $output
|
||||
*
|
||||
* @return int
|
||||
*/
|
||||
public static function run($argv, $commandClasses, $appName = null, $appVersion = null, $output = null, $repository = null)
|
||||
{
|
||||
$runner = new \Robo\Runner($commandClasses);
|
||||
$runner->setSelfUpdateRepository($repository);
|
||||
$statusCode = $runner->execute($argv, $appName, $appVersion, $output);
|
||||
return $statusCode;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets a new global container.
|
||||
*
|
||||
* @param ContainerInterface $container
|
||||
* A new container instance to replace the current.
|
||||
*/
|
||||
public static function setContainer(ContainerInterface $container)
|
||||
{
|
||||
static::$container = $container;
|
||||
}
|
||||
|
||||
/**
|
||||
* Unsets the global container.
|
||||
*/
|
||||
public static function unsetContainer()
|
||||
{
|
||||
static::$container = null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the currently active global container.
|
||||
*
|
||||
* @return \League\Container\ContainerInterface
|
||||
*
|
||||
* @throws \RuntimeException
|
||||
*/
|
||||
public static function getContainer()
|
||||
{
|
||||
if (static::$container === null) {
|
||||
throw new \RuntimeException('container is not initialized yet. \Robo\Robo::setContainer() must be called with a real container.');
|
||||
}
|
||||
return static::$container;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns TRUE if the container has been initialized, FALSE otherwise.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public static function hasContainer()
|
||||
{
|
||||
return static::$container !== null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a config object and load it from the provided paths.
|
||||
*/
|
||||
public static function createConfiguration($paths)
|
||||
{
|
||||
$config = new \Robo\Config\Config();
|
||||
static::loadConfiguration($paths, $config);
|
||||
return $config;
|
||||
}
|
||||
|
||||
/**
|
||||
* Use a simple config loader to load configuration values from specified paths
|
||||
*/
|
||||
public static function loadConfiguration($paths, $config = null)
|
||||
{
|
||||
if ($config == null) {
|
||||
$config = static::config();
|
||||
}
|
||||
$loader = new YamlConfigLoader();
|
||||
$processor = new ConfigProcessor();
|
||||
$processor->add($config->export());
|
||||
foreach ($paths as $path) {
|
||||
$processor->extend($loader->load($path));
|
||||
}
|
||||
$config->import($processor->export());
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a container and initiailze it. If you wish to *change*
|
||||
* anything defined in the container, then you should call
|
||||
* \Robo::configureContainer() instead of this function.
|
||||
*
|
||||
* @param null|\Symfony\Component\Console\Input\InputInterface $input
|
||||
* @param null|\Symfony\Component\Console\Output\OutputInterface $output
|
||||
* @param null|\Robo\Application $app
|
||||
* @param null|ConfigInterface $config
|
||||
* @param null|\Composer\Autoload\ClassLoader $classLoader
|
||||
*
|
||||
* @return \League\Container\Container|\League\Container\ContainerInterface
|
||||
*/
|
||||
public static function createDefaultContainer($input = null, $output = null, $app = null, $config = null, $classLoader = null)
|
||||
{
|
||||
// Do not allow this function to be called more than once.
|
||||
if (static::hasContainer()) {
|
||||
return static::getContainer();
|
||||
}
|
||||
|
||||
if (!$app) {
|
||||
$app = static::createDefaultApplication();
|
||||
}
|
||||
|
||||
if (!$config) {
|
||||
$config = new \Robo\Config\Config();
|
||||
}
|
||||
|
||||
// Set up our dependency injection container.
|
||||
$container = new Container();
|
||||
static::configureContainer($container, $app, $config, $input, $output, $classLoader);
|
||||
|
||||
// Set the application dispatcher
|
||||
$app->setDispatcher($container->get('eventDispatcher'));
|
||||
|
||||
return $container;
|
||||
}
|
||||
|
||||
/**
|
||||
* Initialize a container with all of the default Robo services.
|
||||
* IMPORTANT: after calling this method, clients MUST call:
|
||||
*
|
||||
* $dispatcher = $container->get('eventDispatcher');
|
||||
* $app->setDispatcher($dispatcher);
|
||||
*
|
||||
* Any modification to the container should be done prior to fetching
|
||||
* objects from it.
|
||||
*
|
||||
* It is recommended to use \Robo::createDefaultContainer()
|
||||
* instead, which does all required setup for the caller, but has
|
||||
* the limitation that the container it creates can only be
|
||||
* extended, not modified.
|
||||
*
|
||||
* @param \League\Container\ContainerInterface $container
|
||||
* @param \Symfony\Component\Console\Application $app
|
||||
* @param ConfigInterface $config
|
||||
* @param null|\Symfony\Component\Console\Input\InputInterface $input
|
||||
* @param null|\Symfony\Component\Console\Output\OutputInterface $output
|
||||
* @param null|\Composer\Autoload\ClassLoader $classLoader
|
||||
*/
|
||||
public static function configureContainer(ContainerInterface $container, SymfonyApplication $app, ConfigInterface $config, $input = null, $output = null, $classLoader = null)
|
||||
{
|
||||
// Self-referential container refernce for the inflector
|
||||
$container->add('container', $container);
|
||||
static::setContainer($container);
|
||||
|
||||
// Create default input and output objects if they were not provided
|
||||
if (!$input) {
|
||||
$input = new StringInput('');
|
||||
}
|
||||
if (!$output) {
|
||||
$output = new \Symfony\Component\Console\Output\ConsoleOutput();
|
||||
}
|
||||
if (!$classLoader) {
|
||||
$classLoader = new ClassLoader();
|
||||
}
|
||||
$config->set(Config::DECORATED, $output->isDecorated());
|
||||
$config->set(Config::INTERACTIVE, $input->isInteractive());
|
||||
|
||||
$container->share('application', $app);
|
||||
$container->share('config', $config);
|
||||
$container->share('input', $input);
|
||||
$container->share('output', $output);
|
||||
$container->share('outputAdapter', \Robo\Common\OutputAdapter::class);
|
||||
$container->share('classLoader', $classLoader);
|
||||
|
||||
// Register logging and related services.
|
||||
$container->share('logStyler', \Robo\Log\RoboLogStyle::class);
|
||||
$container->share('logger', \Robo\Log\RoboLogger::class)
|
||||
->withArgument('output')
|
||||
->withMethodCall('setLogOutputStyler', ['logStyler']);
|
||||
$container->add('progressBar', \Symfony\Component\Console\Helper\ProgressBar::class)
|
||||
->withArgument('output');
|
||||
$container->share('progressIndicator', \Robo\Common\ProgressIndicator::class)
|
||||
->withArgument('progressBar')
|
||||
->withArgument('output');
|
||||
$container->share('resultPrinter', \Robo\Log\ResultPrinter::class);
|
||||
$container->add('simulator', \Robo\Task\Simulator::class);
|
||||
$container->share('globalOptionsEventListener', \Robo\GlobalOptionsEventListener::class)
|
||||
->withMethodCall('setApplication', ['application']);
|
||||
$container->share('injectConfigEventListener', \Consolidation\Config\Inject\ConfigForCommand::class)
|
||||
->withArgument('config')
|
||||
->withMethodCall('setApplication', ['application']);
|
||||
$container->share('collectionProcessHook', \Robo\Collection\CollectionProcessHook::class);
|
||||
$container->share('alterOptionsCommandEvent', \Consolidation\AnnotatedCommand\Options\AlterOptionsCommandEvent::class)
|
||||
->withArgument('application');
|
||||
$container->share('hookManager', \Consolidation\AnnotatedCommand\Hooks\HookManager::class)
|
||||
->withMethodCall('addCommandEvent', ['alterOptionsCommandEvent'])
|
||||
->withMethodCall('addCommandEvent', ['injectConfigEventListener'])
|
||||
->withMethodCall('addCommandEvent', ['globalOptionsEventListener'])
|
||||
->withMethodCall('addResultProcessor', ['collectionProcessHook', '*']);
|
||||
$container->share('eventDispatcher', \Symfony\Component\EventDispatcher\EventDispatcher::class)
|
||||
->withMethodCall('addSubscriber', ['hookManager']);
|
||||
$container->share('formatterManager', \Consolidation\OutputFormatters\FormatterManager::class)
|
||||
->withMethodCall('addDefaultFormatters', [])
|
||||
->withMethodCall('addDefaultSimplifiers', []);
|
||||
$container->share('prepareTerminalWidthOption', \Consolidation\AnnotatedCommand\Options\PrepareTerminalWidthOption::class)
|
||||
->withMethodCall('setApplication', ['application']);
|
||||
$container->share('commandProcessor', \Consolidation\AnnotatedCommand\CommandProcessor::class)
|
||||
->withArgument('hookManager')
|
||||
->withMethodCall('setFormatterManager', ['formatterManager'])
|
||||
->withMethodCall('addPrepareFormatter', ['prepareTerminalWidthOption'])
|
||||
->withMethodCall(
|
||||
'setDisplayErrorFunction',
|
||||
[
|
||||
function ($output, $message) use ($container) {
|
||||
$logger = $container->get('logger');
|
||||
$logger->error($message);
|
||||
}
|
||||
]
|
||||
);
|
||||
$container->share('commandFactory', \Consolidation\AnnotatedCommand\AnnotatedCommandFactory::class)
|
||||
->withMethodCall('setCommandProcessor', ['commandProcessor']);
|
||||
$container->share('relativeNamespaceDiscovery', \Robo\ClassDiscovery\RelativeNamespaceDiscovery::class)
|
||||
->withArgument('classLoader');
|
||||
|
||||
// Deprecated: favor using collection builders to direct use of collections.
|
||||
$container->add('collection', \Robo\Collection\Collection::class);
|
||||
// Deprecated: use CollectionBuilder::create() instead -- or, better
|
||||
// yet, BuilderAwareInterface::collectionBuilder() if available.
|
||||
$container->add('collectionBuilder', \Robo\Collection\CollectionBuilder::class);
|
||||
|
||||
static::addInflectors($container);
|
||||
|
||||
// Make sure the application is appropriately initialized.
|
||||
$app->setAutoExit(false);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param null|string $appName
|
||||
* @param null|string $appVersion
|
||||
*
|
||||
* @return \Robo\Application
|
||||
*/
|
||||
public static function createDefaultApplication($appName = null, $appVersion = null)
|
||||
{
|
||||
$appName = $appName ?: self::APPLICATION_NAME;
|
||||
$appVersion = $appVersion ?: self::VERSION;
|
||||
|
||||
$app = new \Robo\Application($appName, $appVersion);
|
||||
$app->setAutoExit(false);
|
||||
return $app;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add the Robo League\Container inflectors to the container
|
||||
*
|
||||
* @param \League\Container\ContainerInterface $container
|
||||
*/
|
||||
public static function addInflectors($container)
|
||||
{
|
||||
// Register our various inflectors.
|
||||
$container->inflector(\Robo\Contract\ConfigAwareInterface::class)
|
||||
->invokeMethod('setConfig', ['config']);
|
||||
$container->inflector(\Psr\Log\LoggerAwareInterface::class)
|
||||
->invokeMethod('setLogger', ['logger']);
|
||||
$container->inflector(\League\Container\ContainerAwareInterface::class)
|
||||
->invokeMethod('setContainer', ['container']);
|
||||
$container->inflector(\Symfony\Component\Console\Input\InputAwareInterface::class)
|
||||
->invokeMethod('setInput', ['input']);
|
||||
$container->inflector(\Robo\Contract\OutputAwareInterface::class)
|
||||
->invokeMethod('setOutput', ['output']);
|
||||
$container->inflector(\Robo\Contract\ProgressIndicatorAwareInterface::class)
|
||||
->invokeMethod('setProgressIndicator', ['progressIndicator']);
|
||||
$container->inflector(\Consolidation\AnnotatedCommand\Events\CustomEventAwareInterface::class)
|
||||
->invokeMethod('setHookManager', ['hookManager']);
|
||||
$container->inflector(\Robo\Contract\VerbosityThresholdInterface::class)
|
||||
->invokeMethod('setOutputAdapter', ['outputAdapter']);
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieves a service from the container.
|
||||
*
|
||||
* Use this method if the desired service is not one of those with a dedicated
|
||||
* accessor method below. If it is listed below, those methods are preferred
|
||||
* as they can return useful type hints.
|
||||
*
|
||||
* @param string $id
|
||||
* The ID of the service to retrieve.
|
||||
*
|
||||
* @return mixed
|
||||
* The specified service.
|
||||
*/
|
||||
public static function service($id)
|
||||
{
|
||||
return static::getContainer()->get($id);
|
||||
}
|
||||
|
||||
/**
|
||||
* Indicates if a service is defined in the container.
|
||||
*
|
||||
* @param string $id
|
||||
* The ID of the service to check.
|
||||
*
|
||||
* @return bool
|
||||
* TRUE if the specified service exists, FALSE otherwise.
|
||||
*/
|
||||
public static function hasService($id)
|
||||
{
|
||||
// Check hasContainer() first in order to always return a Boolean.
|
||||
return static::hasContainer() && static::getContainer()->has($id);
|
||||
}
|
||||
|
||||
/**
|
||||
* Return the result printer object.
|
||||
*
|
||||
* @return \Robo\Log\ResultPrinter
|
||||
*/
|
||||
public static function resultPrinter()
|
||||
{
|
||||
return static::service('resultPrinter');
|
||||
}
|
||||
|
||||
/**
|
||||
* @return ConfigInterface
|
||||
*/
|
||||
public static function config()
|
||||
{
|
||||
return static::service('config');
|
||||
}
|
||||
|
||||
/**
|
||||
* @return \Consolidation\Log\Logger
|
||||
*/
|
||||
public static function logger()
|
||||
{
|
||||
return static::service('logger');
|
||||
}
|
||||
|
||||
/**
|
||||
* @return \Robo\Application
|
||||
*/
|
||||
public static function application()
|
||||
{
|
||||
return static::service('application');
|
||||
}
|
||||
|
||||
/**
|
||||
* Return the output object.
|
||||
*
|
||||
* @return \Symfony\Component\Console\Output\OutputInterface
|
||||
*/
|
||||
public static function output()
|
||||
{
|
||||
return static::service('output');
|
||||
}
|
||||
|
||||
/**
|
||||
* Return the input object.
|
||||
*
|
||||
* @return \Symfony\Component\Console\Input\InputInterface
|
||||
*/
|
||||
public static function input()
|
||||
{
|
||||
return static::service('input');
|
||||
}
|
||||
|
||||
public static function process(Process $process)
|
||||
{
|
||||
return ProcessExecutor::create(static::getContainer(), $process);
|
||||
}
|
||||
}
|
||||
575
vendor/consolidation/robo/src/Runner.php
vendored
Normal file
575
vendor/consolidation/robo/src/Runner.php
vendored
Normal file
|
|
@ -0,0 +1,575 @@
|
|||
<?php
|
||||
namespace Robo;
|
||||
|
||||
use Composer\Autoload\ClassLoader;
|
||||
use Symfony\Component\Console\Input\ArgvInput;
|
||||
use Symfony\Component\Console\Input\StringInput;
|
||||
use Robo\Contract\BuilderAwareInterface;
|
||||
use Robo\Collection\CollectionBuilder;
|
||||
use Robo\Common\IO;
|
||||
use Robo\Exception\TaskExitException;
|
||||
use League\Container\ContainerAwareInterface;
|
||||
use League\Container\ContainerAwareTrait;
|
||||
use Consolidation\Config\Util\EnvConfig;
|
||||
|
||||
class Runner implements ContainerAwareInterface
|
||||
{
|
||||
const ROBOCLASS = 'RoboFile';
|
||||
const ROBOFILE = 'RoboFile.php';
|
||||
|
||||
use IO;
|
||||
use ContainerAwareTrait;
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
protected $roboClass;
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
protected $roboFile;
|
||||
|
||||
/**
|
||||
* @var string working dir of Robo
|
||||
*/
|
||||
protected $dir;
|
||||
|
||||
/**
|
||||
* @var string[]
|
||||
*/
|
||||
protected $errorConditions = [];
|
||||
|
||||
/**
|
||||
* @var string GitHub Repo for SelfUpdate
|
||||
*/
|
||||
protected $selfUpdateRepository = null;
|
||||
|
||||
/**
|
||||
* @var string filename to load configuration from (set to 'robo.yml' for RoboFiles)
|
||||
*/
|
||||
protected $configFilename = 'conf.yml';
|
||||
|
||||
/**
|
||||
* @var string prefix for environment variable configuration overrides
|
||||
*/
|
||||
protected $envConfigPrefix = false;
|
||||
|
||||
/**
|
||||
* @var \Composer\Autoload\ClassLoader
|
||||
*/
|
||||
protected $classLoader = null;
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
protected $relativePluginNamespace;
|
||||
|
||||
/**
|
||||
* Class Constructor
|
||||
*
|
||||
* @param null|string $roboClass
|
||||
* @param null|string $roboFile
|
||||
*/
|
||||
public function __construct($roboClass = null, $roboFile = null)
|
||||
{
|
||||
// set the const as class properties to allow overwriting in child classes
|
||||
$this->roboClass = $roboClass ? $roboClass : self::ROBOCLASS ;
|
||||
$this->roboFile = $roboFile ? $roboFile : self::ROBOFILE;
|
||||
$this->dir = getcwd();
|
||||
}
|
||||
|
||||
protected function errorCondition($msg, $errorType)
|
||||
{
|
||||
$this->errorConditions[$msg] = $errorType;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Symfony\Component\Console\Output\OutputInterface $output
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
protected function loadRoboFile($output)
|
||||
{
|
||||
// If we have not been provided an output object, make a temporary one.
|
||||
if (!$output) {
|
||||
$output = new \Symfony\Component\Console\Output\ConsoleOutput();
|
||||
}
|
||||
|
||||
// If $this->roboClass is a single class that has not already
|
||||
// been loaded, then we will try to obtain it from $this->roboFile.
|
||||
// If $this->roboClass is an array, we presume all classes requested
|
||||
// are available via the autoloader.
|
||||
if (is_array($this->roboClass) || class_exists($this->roboClass)) {
|
||||
return true;
|
||||
}
|
||||
if (!file_exists($this->dir)) {
|
||||
$this->errorCondition("Path `{$this->dir}` is invalid; please provide a valid absolute path to the Robofile to load.", 'red');
|
||||
return false;
|
||||
}
|
||||
|
||||
$realDir = realpath($this->dir);
|
||||
|
||||
$roboFilePath = $realDir . DIRECTORY_SEPARATOR . $this->roboFile;
|
||||
if (!file_exists($roboFilePath)) {
|
||||
$requestedRoboFilePath = $this->dir . DIRECTORY_SEPARATOR . $this->roboFile;
|
||||
$this->errorCondition("Requested RoboFile `$requestedRoboFilePath` is invalid, please provide valid absolute path to load Robofile.", 'red');
|
||||
return false;
|
||||
}
|
||||
require_once $roboFilePath;
|
||||
|
||||
if (!class_exists($this->roboClass)) {
|
||||
$this->errorCondition("Class {$this->roboClass} was not loaded.", 'red');
|
||||
return false;
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array $argv
|
||||
* @param null|string $appName
|
||||
* @param null|string $appVersion
|
||||
* @param null|\Symfony\Component\Console\Output\OutputInterface $output
|
||||
*
|
||||
* @return int
|
||||
*/
|
||||
public function execute($argv, $appName = null, $appVersion = null, $output = null)
|
||||
{
|
||||
$argv = $this->shebang($argv);
|
||||
$argv = $this->processRoboOptions($argv);
|
||||
$app = null;
|
||||
if ($appName && $appVersion) {
|
||||
$app = Robo::createDefaultApplication($appName, $appVersion);
|
||||
}
|
||||
$commandFiles = $this->getRoboFileCommands($output);
|
||||
return $this->run($argv, $output, $app, $commandFiles, $this->classLoader);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get a list of locations where config files may be loaded
|
||||
* @return string[]
|
||||
*/
|
||||
protected function getConfigFilePaths($userConfig)
|
||||
{
|
||||
$roboAppConfig = dirname(__DIR__) . '/' . basename($userConfig);
|
||||
$configFiles = [$userConfig, $roboAppConfig];
|
||||
if (dirname($userConfig) != '.') {
|
||||
array_unshift($configFiles, basename($userConfig));
|
||||
}
|
||||
return $configFiles;
|
||||
}
|
||||
/**
|
||||
* @param null|\Symfony\Component\Console\Input\InputInterface $input
|
||||
* @param null|\Symfony\Component\Console\Output\OutputInterface $output
|
||||
* @param null|\Robo\Application $app
|
||||
* @param array[] $commandFiles
|
||||
* @param null|ClassLoader $classLoader
|
||||
*
|
||||
* @return int
|
||||
*/
|
||||
public function run($input = null, $output = null, $app = null, $commandFiles = [], $classLoader = null)
|
||||
{
|
||||
// Create default input and output objects if they were not provided
|
||||
if (!$input) {
|
||||
$input = new StringInput('');
|
||||
}
|
||||
if (is_array($input)) {
|
||||
$input = new ArgvInput($input);
|
||||
}
|
||||
if (!$output) {
|
||||
$output = new \Symfony\Component\Console\Output\ConsoleOutput();
|
||||
}
|
||||
$this->setInput($input);
|
||||
$this->setOutput($output);
|
||||
|
||||
// If we were not provided a container, then create one
|
||||
if (!$this->getContainer()) {
|
||||
$configFiles = $this->getConfigFilePaths($this->configFilename);
|
||||
$config = Robo::createConfiguration($configFiles);
|
||||
if ($this->envConfigPrefix) {
|
||||
$envConfig = new EnvConfig($this->envConfigPrefix);
|
||||
$config->addContext('env', $envConfig);
|
||||
}
|
||||
$container = Robo::createDefaultContainer($input, $output, $app, $config, $classLoader);
|
||||
$this->setContainer($container);
|
||||
// Automatically register a shutdown function and
|
||||
// an error handler when we provide the container.
|
||||
$this->installRoboHandlers();
|
||||
}
|
||||
|
||||
if (!$app) {
|
||||
$app = Robo::application();
|
||||
}
|
||||
if ($app instanceof \Robo\Application) {
|
||||
$app->addSelfUpdateCommand($this->getSelfUpdateRepository());
|
||||
if (!isset($commandFiles)) {
|
||||
$this->errorCondition("Robo is not initialized here. Please run `robo init` to create a new RoboFile.", 'yellow');
|
||||
$app->addInitRoboFileCommand($this->roboFile, $this->roboClass);
|
||||
$commandFiles = [];
|
||||
}
|
||||
}
|
||||
|
||||
if (!empty($this->relativePluginNamespace)) {
|
||||
$commandClasses = $this->discoverCommandClasses($this->relativePluginNamespace);
|
||||
$commandFiles = array_merge((array)$commandFiles, $commandClasses);
|
||||
}
|
||||
|
||||
$this->registerCommandClasses($app, $commandFiles);
|
||||
|
||||
try {
|
||||
$statusCode = $app->run($input, $output);
|
||||
} catch (TaskExitException $e) {
|
||||
$statusCode = $e->getCode() ?: 1;
|
||||
}
|
||||
|
||||
// If there were any error conditions in bootstrapping Robo,
|
||||
// print them only if the requested command did not complete
|
||||
// successfully.
|
||||
if ($statusCode) {
|
||||
foreach ($this->errorConditions as $msg => $color) {
|
||||
$this->yell($msg, 40, $color);
|
||||
}
|
||||
}
|
||||
return $statusCode;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Symfony\Component\Console\Output\OutputInterface $output
|
||||
*
|
||||
* @return null|string
|
||||
*/
|
||||
protected function getRoboFileCommands($output)
|
||||
{
|
||||
if (!$this->loadRoboFile($output)) {
|
||||
return;
|
||||
}
|
||||
return $this->roboClass;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Robo\Application $app
|
||||
* @param array $commandClasses
|
||||
*/
|
||||
public function registerCommandClasses($app, $commandClasses)
|
||||
{
|
||||
foreach ((array)$commandClasses as $commandClass) {
|
||||
$this->registerCommandClass($app, $commandClass);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @param $relativeNamespace
|
||||
*
|
||||
* @return array|string[]
|
||||
*/
|
||||
protected function discoverCommandClasses($relativeNamespace)
|
||||
{
|
||||
/** @var \Robo\ClassDiscovery\RelativeNamespaceDiscovery $discovery */
|
||||
$discovery = Robo::service('relativeNamespaceDiscovery');
|
||||
$discovery->setRelativeNamespace($relativeNamespace.'\Commands')
|
||||
->setSearchPattern('*Commands.php');
|
||||
return $discovery->getClasses();
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Robo\Application $app
|
||||
* @param string|BuilderAwareInterface|ContainerAwareInterface $commandClass
|
||||
*
|
||||
* @return mixed|void
|
||||
*/
|
||||
public function registerCommandClass($app, $commandClass)
|
||||
{
|
||||
$container = Robo::getContainer();
|
||||
$roboCommandFileInstance = $this->instantiateCommandClass($commandClass);
|
||||
if (!$roboCommandFileInstance) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Register commands for all of the public methods in the RoboFile.
|
||||
$commandFactory = $container->get('commandFactory');
|
||||
$commandList = $commandFactory->createCommandsFromClass($roboCommandFileInstance);
|
||||
foreach ($commandList as $command) {
|
||||
$app->add($command);
|
||||
}
|
||||
return $roboCommandFileInstance;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string|BuilderAwareInterface|ContainerAwareInterface $commandClass
|
||||
*
|
||||
* @return null|object
|
||||
*/
|
||||
protected function instantiateCommandClass($commandClass)
|
||||
{
|
||||
$container = Robo::getContainer();
|
||||
|
||||
// Register the RoboFile with the container and then immediately
|
||||
// fetch it; this ensures that all of the inflectors will run.
|
||||
// If the command class is already an instantiated object, then
|
||||
// just use it exactly as it was provided to us.
|
||||
if (is_string($commandClass)) {
|
||||
if (!class_exists($commandClass)) {
|
||||
return;
|
||||
}
|
||||
$reflectionClass = new \ReflectionClass($commandClass);
|
||||
if ($reflectionClass->isAbstract()) {
|
||||
return;
|
||||
}
|
||||
|
||||
$commandFileName = "{$commandClass}Commands";
|
||||
$container->share($commandFileName, $commandClass);
|
||||
$commandClass = $container->get($commandFileName);
|
||||
}
|
||||
// If the command class is a Builder Aware Interface, then
|
||||
// ensure that it has a builder. Every command class needs
|
||||
// its own collection builder, as they have references to each other.
|
||||
if ($commandClass instanceof BuilderAwareInterface) {
|
||||
$builder = CollectionBuilder::create($container, $commandClass);
|
||||
$commandClass->setBuilder($builder);
|
||||
}
|
||||
if ($commandClass instanceof ContainerAwareInterface) {
|
||||
$commandClass->setContainer($container);
|
||||
}
|
||||
return $commandClass;
|
||||
}
|
||||
|
||||
public function installRoboHandlers()
|
||||
{
|
||||
register_shutdown_function(array($this, 'shutdown'));
|
||||
set_error_handler(array($this, 'handleError'));
|
||||
}
|
||||
|
||||
/**
|
||||
* Process a shebang script, if one was used to launch this Runner.
|
||||
*
|
||||
* @param array $args
|
||||
*
|
||||
* @return array $args with shebang script removed
|
||||
*/
|
||||
protected function shebang($args)
|
||||
{
|
||||
// Option 1: Shebang line names Robo, but includes no parameters.
|
||||
// #!/bin/env robo
|
||||
// The robo class may contain multiple commands; the user may
|
||||
// select which one to run, or even get a list of commands or
|
||||
// run 'help' on any of the available commands as usual.
|
||||
if ((count($args) > 1) && $this->isShebangFile($args[1])) {
|
||||
return array_merge([$args[0]], array_slice($args, 2));
|
||||
}
|
||||
// Option 2: Shebang line stipulates which command to run.
|
||||
// #!/bin/env robo mycommand
|
||||
// The robo class must contain a public method named 'mycommand'.
|
||||
// This command will be executed every time. Arguments and options
|
||||
// may be provided on the commandline as usual.
|
||||
if ((count($args) > 2) && $this->isShebangFile($args[2])) {
|
||||
return array_merge([$args[0]], explode(' ', $args[1]), array_slice($args, 3));
|
||||
}
|
||||
return $args;
|
||||
}
|
||||
|
||||
/**
|
||||
* Determine if the specified argument is a path to a shebang script.
|
||||
* If so, load it.
|
||||
*
|
||||
* @param string $filepath file to check
|
||||
*
|
||||
* @return bool Returns TRUE if shebang script was processed
|
||||
*/
|
||||
protected function isShebangFile($filepath)
|
||||
{
|
||||
// Avoid trying to call $filepath on remote URLs
|
||||
if ((strpos($filepath, '://') !== false) && (substr($filepath, 0, 7) != 'file://')) {
|
||||
return false;
|
||||
}
|
||||
if (!is_file($filepath)) {
|
||||
return false;
|
||||
}
|
||||
$fp = fopen($filepath, "r");
|
||||
if ($fp === false) {
|
||||
return false;
|
||||
}
|
||||
$line = fgets($fp);
|
||||
$result = $this->isShebangLine($line);
|
||||
if ($result) {
|
||||
while ($line = fgets($fp)) {
|
||||
$line = trim($line);
|
||||
if ($line == '<?php') {
|
||||
$script = stream_get_contents($fp);
|
||||
if (preg_match('#^class *([^ ]+)#m', $script, $matches)) {
|
||||
$this->roboClass = $matches[1];
|
||||
eval($script);
|
||||
$result = true;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
fclose($fp);
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Test to see if the provided line is a robo 'shebang' line.
|
||||
*
|
||||
* @param string $line
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
protected function isShebangLine($line)
|
||||
{
|
||||
return ((substr($line, 0, 2) == '#!') && (strstr($line, 'robo') !== false));
|
||||
}
|
||||
|
||||
/**
|
||||
* Check for Robo-specific arguments such as --load-from, process them,
|
||||
* and remove them from the array. We have to process --load-from before
|
||||
* we set up Symfony Console.
|
||||
*
|
||||
* @param array $argv
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
protected function processRoboOptions($argv)
|
||||
{
|
||||
// loading from other directory
|
||||
$pos = $this->arraySearchBeginsWith('--load-from', $argv) ?: array_search('-f', $argv);
|
||||
if ($pos === false) {
|
||||
return $argv;
|
||||
}
|
||||
|
||||
$passThru = array_search('--', $argv);
|
||||
if (($passThru !== false) && ($passThru < $pos)) {
|
||||
return $argv;
|
||||
}
|
||||
|
||||
if (substr($argv[$pos], 0, 12) == '--load-from=') {
|
||||
$this->dir = substr($argv[$pos], 12);
|
||||
} elseif (isset($argv[$pos +1])) {
|
||||
$this->dir = $argv[$pos +1];
|
||||
unset($argv[$pos +1]);
|
||||
}
|
||||
unset($argv[$pos]);
|
||||
// Make adjustments if '--load-from' points at a file.
|
||||
if (is_file($this->dir) || (substr($this->dir, -4) == '.php')) {
|
||||
$this->roboFile = basename($this->dir);
|
||||
$this->dir = dirname($this->dir);
|
||||
$className = basename($this->roboFile, '.php');
|
||||
if ($className != $this->roboFile) {
|
||||
$this->roboClass = $className;
|
||||
}
|
||||
}
|
||||
// Convert directory to a real path, but only if the
|
||||
// path exists. We do not want to lose the original
|
||||
// directory if the user supplied a bad value.
|
||||
$realDir = realpath($this->dir);
|
||||
if ($realDir) {
|
||||
chdir($realDir);
|
||||
$this->dir = $realDir;
|
||||
}
|
||||
|
||||
return $argv;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $needle
|
||||
* @param string[] $haystack
|
||||
*
|
||||
* @return bool|int
|
||||
*/
|
||||
protected function arraySearchBeginsWith($needle, $haystack)
|
||||
{
|
||||
for ($i = 0; $i < count($haystack); ++$i) {
|
||||
if (substr($haystack[$i], 0, strlen($needle)) == $needle) {
|
||||
return $i;
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
public function shutdown()
|
||||
{
|
||||
$error = error_get_last();
|
||||
if (!is_array($error)) {
|
||||
return;
|
||||
}
|
||||
$this->writeln(sprintf("<error>ERROR: %s \nin %s:%d\n</error>", $error['message'], $error['file'], $error['line']));
|
||||
}
|
||||
|
||||
/**
|
||||
* This is just a proxy error handler that checks the current error_reporting level.
|
||||
* In case error_reporting is disabled the error is marked as handled, otherwise
|
||||
* the normal internal error handling resumes.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function handleError()
|
||||
{
|
||||
if (error_reporting() === 0) {
|
||||
return true;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return string
|
||||
*/
|
||||
public function getSelfUpdateRepository()
|
||||
{
|
||||
return $this->selfUpdateRepository;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param $selfUpdateRepository
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setSelfUpdateRepository($selfUpdateRepository)
|
||||
{
|
||||
$this->selfUpdateRepository = $selfUpdateRepository;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $configFilename
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setConfigurationFilename($configFilename)
|
||||
{
|
||||
$this->configFilename = $configFilename;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $envConfigPrefix
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setEnvConfigPrefix($envConfigPrefix)
|
||||
{
|
||||
$this->envConfigPrefix = $envConfigPrefix;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \Composer\Autoload\ClassLoader $classLoader
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setClassLoader(ClassLoader $classLoader)
|
||||
{
|
||||
$this->classLoader = $classLoader;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $relativeNamespace
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setRelativePluginNamespace($relativeNamespace)
|
||||
{
|
||||
$this->relativePluginNamespace = $relativeNamespace;
|
||||
return $this;
|
||||
}
|
||||
}
|
||||
12
vendor/consolidation/robo/src/State/Consumer.php
vendored
Normal file
12
vendor/consolidation/robo/src/State/Consumer.php
vendored
Normal file
|
|
@ -0,0 +1,12 @@
|
|||
<?php
|
||||
namespace Robo\State;
|
||||
|
||||
use Robo\State\Data;
|
||||
|
||||
interface Consumer
|
||||
{
|
||||
/**
|
||||
* @return Data
|
||||
*/
|
||||
public function receiveState(Data $state);
|
||||
}
|
||||
148
vendor/consolidation/robo/src/State/Data.php
vendored
Normal file
148
vendor/consolidation/robo/src/State/Data.php
vendored
Normal file
|
|
@ -0,0 +1,148 @@
|
|||
<?php
|
||||
namespace Robo\State;
|
||||
|
||||
/**
|
||||
* A State\Data object contains a "message" (the primary result) and a
|
||||
* data array (the persistent state). The message is transient, and does
|
||||
* not move into the persistent state unless explicitly copied there.
|
||||
*/
|
||||
class Data extends \ArrayObject
|
||||
{
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
protected $message;
|
||||
|
||||
/**
|
||||
* @param string $message
|
||||
* @param array $data
|
||||
*/
|
||||
public function __construct($message = '', $data = [])
|
||||
{
|
||||
$this->message = $message;
|
||||
parent::__construct($data);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array
|
||||
*/
|
||||
public function getData()
|
||||
{
|
||||
return $this->getArrayCopy();
|
||||
}
|
||||
|
||||
/**
|
||||
* @return string
|
||||
*/
|
||||
public function getMessage()
|
||||
{
|
||||
return $this->message;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string message
|
||||
*/
|
||||
public function setMessage($message)
|
||||
{
|
||||
$this->message = $message;
|
||||
}
|
||||
|
||||
/**
|
||||
* Merge another result into this result. Data already
|
||||
* existing in this result takes precedence over the
|
||||
* data in the Result being merged.
|
||||
*
|
||||
* @param \Robo\ResultData $result
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function merge(Data $result)
|
||||
{
|
||||
$mergedData = $this->getArrayCopy() + $result->getArrayCopy();
|
||||
$this->exchangeArray($mergedData);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Update the current data with the data provided in the parameter.
|
||||
* Provided data takes precedence.
|
||||
*
|
||||
* @param \ArrayObject $update
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function update(\ArrayObject $update)
|
||||
{
|
||||
$iterator = $update->getIterator();
|
||||
|
||||
while ($iterator->valid()) {
|
||||
$this[$iterator->key()] = $iterator->current();
|
||||
$iterator->next();
|
||||
}
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Merge another result into this result. Data already
|
||||
* existing in this result takes precedence over the
|
||||
* data in the Result being merged.
|
||||
*
|
||||
* $data['message'] is handled specially, and is appended
|
||||
* to $this->message if set.
|
||||
*
|
||||
* @param array $data
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function mergeData(array $data)
|
||||
{
|
||||
$mergedData = $this->getArrayCopy() + $data;
|
||||
$this->exchangeArray($mergedData);
|
||||
return $mergedData;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return bool
|
||||
*/
|
||||
public function hasExecutionTime()
|
||||
{
|
||||
return isset($this['time']);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return null|float
|
||||
*/
|
||||
public function getExecutionTime()
|
||||
{
|
||||
if (!$this->hasExecutionTime()) {
|
||||
return null;
|
||||
}
|
||||
return $this['time'];
|
||||
}
|
||||
|
||||
/**
|
||||
* Accumulate execution time
|
||||
*/
|
||||
public function accumulateExecutionTime($duration)
|
||||
{
|
||||
// Convert data arrays to scalar
|
||||
if (is_array($duration)) {
|
||||
$duration = isset($duration['time']) ? $duration['time'] : 0;
|
||||
}
|
||||
$this['time'] = $this->getExecutionTime() + $duration;
|
||||
return $this->getExecutionTime();
|
||||
}
|
||||
|
||||
/**
|
||||
* Accumulate the message.
|
||||
*/
|
||||
public function accumulateMessage($message)
|
||||
{
|
||||
if (!empty($this->message)) {
|
||||
$this->message .= "\n";
|
||||
}
|
||||
$this->message .= $message;
|
||||
return $this->getMessage();
|
||||
}
|
||||
}
|
||||
30
vendor/consolidation/robo/src/State/StateAwareInterface.php
vendored
Normal file
30
vendor/consolidation/robo/src/State/StateAwareInterface.php
vendored
Normal file
|
|
@ -0,0 +1,30 @@
|
|||
<?php
|
||||
namespace Robo\State;
|
||||
|
||||
use Robo\State\Data;
|
||||
|
||||
interface StateAwareInterface
|
||||
{
|
||||
/**
|
||||
* @return Data
|
||||
*/
|
||||
public function getState();
|
||||
|
||||
/**
|
||||
* @param Data state
|
||||
*/
|
||||
public function setState(Data $state);
|
||||
|
||||
/**
|
||||
* @param $key
|
||||
* @param value
|
||||
*/
|
||||
public function setStateValue($key, $value);
|
||||
|
||||
/**
|
||||
* @param Data update state takes precedence over current state.
|
||||
*/
|
||||
public function updateState(Data $update);
|
||||
|
||||
public function resetState();
|
||||
}
|
||||
49
vendor/consolidation/robo/src/State/StateAwareTrait.php
vendored
Normal file
49
vendor/consolidation/robo/src/State/StateAwareTrait.php
vendored
Normal file
|
|
@ -0,0 +1,49 @@
|
|||
<?php
|
||||
namespace Robo\State;
|
||||
|
||||
use Robo\State\Data;
|
||||
|
||||
trait StateAwareTrait
|
||||
{
|
||||
protected $state;
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function getState()
|
||||
{
|
||||
return $this->state;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function setState(Data $state)
|
||||
{
|
||||
$this->state = $state;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function setStateValue($key, $value)
|
||||
{
|
||||
$this->state[$key] = $value;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function updateState(Data $update)
|
||||
{
|
||||
$this->state->update($update);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function resetState()
|
||||
{
|
||||
$this->state = new Data();
|
||||
}
|
||||
}
|
||||
518
vendor/consolidation/robo/src/Task/ApiGen/ApiGen.php
vendored
Normal file
518
vendor/consolidation/robo/src/Task/ApiGen/ApiGen.php
vendored
Normal file
|
|
@ -0,0 +1,518 @@
|
|||
<?php
|
||||
namespace Robo\Task\ApiGen;
|
||||
|
||||
use Robo\Contract\CommandInterface;
|
||||
use Robo\Exception\TaskException;
|
||||
use Robo\Task\BaseTask;
|
||||
use Traversable;
|
||||
|
||||
/**
|
||||
* Executes ApiGen command to generate documentation
|
||||
*
|
||||
* ``` php
|
||||
* <?php
|
||||
* // ApiGen Command
|
||||
* $this->taskApiGen('./vendor/apigen/apigen.phar')
|
||||
* ->config('./apigen.neon')
|
||||
* ->templateConfig('vendor/apigen/apigen/templates/bootstrap/config.neon')
|
||||
* ->wipeout(true)
|
||||
* ->run();
|
||||
* ?>
|
||||
* ```
|
||||
*/
|
||||
class ApiGen extends BaseTask implements CommandInterface
|
||||
{
|
||||
use \Robo\Common\ExecOneCommand;
|
||||
|
||||
const BOOL_NO = 'no';
|
||||
const BOOL_YES = 'yes';
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
protected $command;
|
||||
protected $operation = 'generate';
|
||||
|
||||
/**
|
||||
* @param null|string $pathToApiGen
|
||||
*
|
||||
* @throws \Robo\Exception\TaskException
|
||||
*/
|
||||
public function __construct($pathToApiGen = null)
|
||||
{
|
||||
$this->command = $pathToApiGen;
|
||||
$command_parts = [];
|
||||
preg_match('/((?:.+)?apigen(?:\.phar)?) ?( \w+)? ?(.+)?/', $this->command, $command_parts);
|
||||
if (count($command_parts) === 3) {
|
||||
list(, $this->command, $this->operation) = $command_parts;
|
||||
}
|
||||
if (count($command_parts) === 4) {
|
||||
list(, $this->command, $this->operation, $arg) = $command_parts;
|
||||
$this->arg($arg);
|
||||
}
|
||||
if (!$this->command) {
|
||||
$this->command = $this->findExecutablePhar('apigen');
|
||||
}
|
||||
if (!$this->command) {
|
||||
throw new TaskException(__CLASS__, "No apigen installation found");
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Pass methods parameters as arguments to executable. Argument values
|
||||
* are automatically escaped.
|
||||
*
|
||||
* @param string|string[] $args
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function args($args)
|
||||
{
|
||||
if (!is_array($args)) {
|
||||
$args = func_get_args();
|
||||
}
|
||||
$args = array_map(function ($arg) {
|
||||
if (preg_match('/^\w+$/', trim($arg)) === 1) {
|
||||
$this->operation = $arg;
|
||||
return null;
|
||||
}
|
||||
return $arg;
|
||||
}, $args);
|
||||
$args = array_filter($args);
|
||||
$this->arguments .= ' ' . implode(' ', array_map('static::escape', $args));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array|Traversable|string $arg a single object or something traversable
|
||||
*
|
||||
* @return array|Traversable the provided argument if it was already traversable, or the given
|
||||
* argument returned as a one-element array
|
||||
*/
|
||||
protected static function forceTraversable($arg)
|
||||
{
|
||||
$traversable = $arg;
|
||||
if (!is_array($traversable) && !($traversable instanceof \Traversable)) {
|
||||
$traversable = array($traversable);
|
||||
}
|
||||
return $traversable;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array|string $arg a single argument or an array of multiple string values
|
||||
*
|
||||
* @return string a comma-separated string of all of the provided arguments, suitable
|
||||
* as a command-line "list" type argument for ApiGen
|
||||
*/
|
||||
protected static function asList($arg)
|
||||
{
|
||||
$normalized = is_array($arg) ? $arg : array($arg);
|
||||
return implode(',', $normalized);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool|string $val an argument to be normalized
|
||||
* @param string $default one of self::BOOL_YES or self::BOOK_NO if the provided
|
||||
* value could not deterministically be converted to a
|
||||
* yes or no value
|
||||
*
|
||||
* @return string the given value as a command-line "yes|no" type of argument for ApiGen,
|
||||
* or the default value if none could be determined
|
||||
*/
|
||||
protected static function asTextBool($val, $default)
|
||||
{
|
||||
if ($val === self::BOOL_YES || $val === self::BOOL_NO) {
|
||||
return $val;
|
||||
}
|
||||
if (!$val) {
|
||||
return self::BOOL_NO;
|
||||
}
|
||||
if ($val === true) {
|
||||
return self::BOOL_YES;
|
||||
}
|
||||
if (is_numeric($val) && $val != 0) {
|
||||
return self::BOOL_YES;
|
||||
}
|
||||
if (strcasecmp($val[0], 'y') === 0) {
|
||||
return self::BOOL_YES;
|
||||
}
|
||||
if (strcasecmp($val[0], 'n') === 0) {
|
||||
return self::BOOL_NO;
|
||||
}
|
||||
// meh, good enough, let apigen sort it out
|
||||
return $default;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $config
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function config($config)
|
||||
{
|
||||
$this->option('config', $config);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array|string|Traversable $src one or more source values
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function source($src)
|
||||
{
|
||||
foreach (self::forceTraversable($src) as $source) {
|
||||
$this->option('source', $source);
|
||||
}
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $dest
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function destination($dest)
|
||||
{
|
||||
$this->option('destination', $dest);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array|string $exts one or more extensions
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function extensions($exts)
|
||||
{
|
||||
$this->option('extensions', self::asList($exts));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array|string $exclude one or more exclusions
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function exclude($exclude)
|
||||
{
|
||||
foreach (self::forceTraversable($exclude) as $excl) {
|
||||
$this->option('exclude', $excl);
|
||||
}
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array|string|Traversable $path one or more skip-doc-path values
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function skipDocPath($path)
|
||||
{
|
||||
foreach (self::forceTraversable($path) as $skip) {
|
||||
$this->option('skip-doc-path', $skip);
|
||||
}
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array|string|Traversable $prefix one or more skip-doc-prefix values
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function skipDocPrefix($prefix)
|
||||
{
|
||||
foreach (self::forceTraversable($prefix) as $skip) {
|
||||
$this->option('skip-doc-prefix', $skip);
|
||||
}
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array|string $charset one or more charsets
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function charset($charset)
|
||||
{
|
||||
$this->option('charset', self::asList($charset));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $name
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function mainProjectNamePrefix($name)
|
||||
{
|
||||
$this->option('main', $name);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $title
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function title($title)
|
||||
{
|
||||
$this->option('title', $title);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $baseUrl
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function baseUrl($baseUrl)
|
||||
{
|
||||
$this->option('base-url', $baseUrl);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $id
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function googleCseId($id)
|
||||
{
|
||||
$this->option('google-cse-id', $id);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $trackingCode
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function googleAnalytics($trackingCode)
|
||||
{
|
||||
$this->option('google-analytics', $trackingCode);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param mixed $templateConfig
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function templateConfig($templateConfig)
|
||||
{
|
||||
$this->option('template-config', $templateConfig);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array|string $tags one or more supported html tags
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function allowedHtml($tags)
|
||||
{
|
||||
$this->option('allowed-html', self::asList($tags));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $groups
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function groups($groups)
|
||||
{
|
||||
$this->option('groups', $groups);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array|string $types or more supported autocomplete types
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function autocomplete($types)
|
||||
{
|
||||
$this->option('autocomplete', self::asList($types));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array|string $levels one or more access levels
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function accessLevels($levels)
|
||||
{
|
||||
$this->option('access-levels', self::asList($levels));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param boolean|string $internal 'yes' or true if internal, 'no' or false if not
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function internal($internal)
|
||||
{
|
||||
$this->option('internal', self::asTextBool($internal, self::BOOL_NO));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param boolean|string $php 'yes' or true to generate documentation for internal php classes,
|
||||
* 'no' or false otherwise
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function php($php)
|
||||
{
|
||||
$this->option('php', self::asTextBool($php, self::BOOL_YES));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool|string $tree 'yes' or true to generate a tree view of classes, 'no' or false otherwise
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function tree($tree)
|
||||
{
|
||||
$this->option('tree', self::asTextBool($tree, self::BOOL_YES));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool|string $dep 'yes' or true to generate documentation for deprecated classes, 'no' or false otherwise
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function deprecated($dep)
|
||||
{
|
||||
$this->option('deprecated', self::asTextBool($dep, self::BOOL_NO));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool|string $todo 'yes' or true to document tasks, 'no' or false otherwise
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function todo($todo)
|
||||
{
|
||||
$this->option('todo', self::asTextBool($todo, self::BOOL_NO));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool|string $src 'yes' or true to generate highlighted source code, 'no' or false otherwise
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function sourceCode($src)
|
||||
{
|
||||
$this->option('source-code', self::asTextBool($src, self::BOOL_YES));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool|string $zipped 'yes' or true to generate downloadable documentation, 'no' or false otherwise
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function download($zipped)
|
||||
{
|
||||
$this->option('download', self::asTextBool($zipped, self::BOOL_NO));
|
||||
return $this;
|
||||
}
|
||||
|
||||
public function report($path)
|
||||
{
|
||||
$this->option('report', $path);
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool|string $wipeout 'yes' or true to clear out the destination directory, 'no' or false otherwise
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function wipeout($wipeout)
|
||||
{
|
||||
$this->option('wipeout', self::asTextBool($wipeout, self::BOOL_YES));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool|string $quiet 'yes' or true for quiet, 'no' or false otherwise
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function quiet($quiet)
|
||||
{
|
||||
$this->option('quiet', self::asTextBool($quiet, self::BOOL_NO));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool|string $bar 'yes' or true to display a progress bar, 'no' or false otherwise
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function progressbar($bar)
|
||||
{
|
||||
$this->option('progressbar', self::asTextBool($bar, self::BOOL_YES));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool|string $colors 'yes' or true colorize the output, 'no' or false otherwise
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function colors($colors)
|
||||
{
|
||||
$this->option('colors', self::asTextBool($colors, self::BOOL_YES));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool|string $check 'yes' or true to check for updates, 'no' or false otherwise
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function updateCheck($check)
|
||||
{
|
||||
$this->option('update-check', self::asTextBool($check, self::BOOL_YES));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool|string $debug 'yes' or true to enable debug mode, 'no' or false otherwise
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function debug($debug)
|
||||
{
|
||||
$this->option('debug', self::asTextBool($debug, self::BOOL_NO));
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function getCommand()
|
||||
{
|
||||
return "$this->command $this->operation$this->arguments";
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function run()
|
||||
{
|
||||
$this->printTaskInfo('Running ApiGen {args}', ['args' => $this->arguments]);
|
||||
return $this->executeCommand($this->getCommand());
|
||||
}
|
||||
}
|
||||
15
vendor/consolidation/robo/src/Task/ApiGen/loadTasks.php
vendored
Normal file
15
vendor/consolidation/robo/src/Task/ApiGen/loadTasks.php
vendored
Normal file
|
|
@ -0,0 +1,15 @@
|
|||
<?php
|
||||
namespace Robo\Task\ApiGen;
|
||||
|
||||
trait loadTasks
|
||||
{
|
||||
/**
|
||||
* @param null|string $pathToApiGen
|
||||
*
|
||||
* @return \Robo\Task\ApiGen\ApiGen
|
||||
*/
|
||||
protected function taskApiGen($pathToApiGen = null)
|
||||
{
|
||||
return $this->task(ApiGen::class, $pathToApiGen);
|
||||
}
|
||||
}
|
||||
279
vendor/consolidation/robo/src/Task/Archive/Extract.php
vendored
Normal file
279
vendor/consolidation/robo/src/Task/Archive/Extract.php
vendored
Normal file
|
|
@ -0,0 +1,279 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Task\Archive;
|
||||
|
||||
use Robo\Result;
|
||||
use Robo\Task\BaseTask;
|
||||
use Robo\Task\Filesystem\FilesystemStack;
|
||||
use Robo\Task\Filesystem\DeleteDir;
|
||||
use Robo\Contract\BuilderAwareInterface;
|
||||
use Robo\Common\BuilderAwareTrait;
|
||||
|
||||
/**
|
||||
* Extracts an archive.
|
||||
*
|
||||
* Note that often, distributions are packaged in tar or zip archives
|
||||
* where the topmost folder may contain variable information, such as
|
||||
* the release date, or the version of the package. This information
|
||||
* is very useful when unpacking by hand, but arbitrarily-named directories
|
||||
* are much less useful to scripts. Therefore, by default, Extract will
|
||||
* remove the top-level directory, and instead store all extracted files
|
||||
* into the directory specified by $archivePath.
|
||||
*
|
||||
* To keep the top-level directory when extracting, use
|
||||
* `preserveTopDirectory(true)`.
|
||||
*
|
||||
* ``` php
|
||||
* <?php
|
||||
* $this->taskExtract($archivePath)
|
||||
* ->to($destination)
|
||||
* ->preserveTopDirectory(false) // the default
|
||||
* ->run();
|
||||
* ?>
|
||||
* ```
|
||||
*/
|
||||
class Extract extends BaseTask implements BuilderAwareInterface
|
||||
{
|
||||
use BuilderAwareTrait;
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
protected $filename;
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
protected $to;
|
||||
|
||||
/**
|
||||
* @var bool
|
||||
*/
|
||||
private $preserveTopDirectory = false;
|
||||
|
||||
/**
|
||||
* @param string $filename
|
||||
*/
|
||||
public function __construct($filename)
|
||||
{
|
||||
$this->filename = $filename;
|
||||
}
|
||||
|
||||
/**
|
||||
* Location to store extracted files.
|
||||
*
|
||||
* @param string $to
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function to($to)
|
||||
{
|
||||
$this->to = $to;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param bool $preserve
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function preserveTopDirectory($preserve = true)
|
||||
{
|
||||
$this->preserveTopDirectory = $preserve;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function run()
|
||||
{
|
||||
if (!file_exists($this->filename)) {
|
||||
$this->printTaskError("File {filename} does not exist", ['filename' => $this->filename]);
|
||||
|
||||
return false;
|
||||
}
|
||||
if (!($mimetype = static::archiveType($this->filename))) {
|
||||
$this->printTaskError("Could not determine type of archive for {filename}", ['filename' => $this->filename]);
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
// We will first extract to $extractLocation and then move to $this->to
|
||||
$extractLocation = static::getTmpDir();
|
||||
@mkdir($extractLocation);
|
||||
@mkdir(dirname($this->to));
|
||||
|
||||
$this->startTimer();
|
||||
|
||||
$this->printTaskInfo("Extracting {filename}", ['filename' => $this->filename]);
|
||||
|
||||
$result = $this->extractAppropriateType($mimetype, $extractLocation);
|
||||
if ($result->wasSuccessful()) {
|
||||
$this->printTaskInfo("{filename} extracted", ['filename' => $this->filename]);
|
||||
// Now, we want to move the extracted files to $this->to. There
|
||||
// are two possibilities that we must consider:
|
||||
//
|
||||
// (1) Archived files were encapsulated in a folder with an arbitrary name
|
||||
// (2) There was no encapsulating folder, and all the files in the archive
|
||||
// were extracted into $extractLocation
|
||||
//
|
||||
// In the case of (1), we want to move and rename the encapsulating folder
|
||||
// to $this->to.
|
||||
//
|
||||
// In the case of (2), we will just move and rename $extractLocation.
|
||||
$filesInExtractLocation = glob("$extractLocation/*");
|
||||
$hasEncapsulatingFolder = ((count($filesInExtractLocation) == 1) && is_dir($filesInExtractLocation[0]));
|
||||
if ($hasEncapsulatingFolder && !$this->preserveTopDirectory) {
|
||||
$result = (new FilesystemStack())
|
||||
->inflect($this)
|
||||
->rename($filesInExtractLocation[0], $this->to)
|
||||
->run();
|
||||
(new DeleteDir($extractLocation))
|
||||
->inflect($this)
|
||||
->run();
|
||||
} else {
|
||||
$result = (new FilesystemStack())
|
||||
->inflect($this)
|
||||
->rename($extractLocation, $this->to)
|
||||
->run();
|
||||
}
|
||||
}
|
||||
$this->stopTimer();
|
||||
$result['time'] = $this->getExecutionTime();
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $mimetype
|
||||
* @param string $extractLocation
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
protected function extractAppropriateType($mimetype, $extractLocation)
|
||||
{
|
||||
// Perform the extraction of a zip file.
|
||||
if (($mimetype == 'application/zip') || ($mimetype == 'application/x-zip')) {
|
||||
return $this->extractZip($extractLocation);
|
||||
}
|
||||
return $this->extractTar($extractLocation);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $extractLocation
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
protected function extractZip($extractLocation)
|
||||
{
|
||||
if (!extension_loaded('zlib')) {
|
||||
return Result::errorMissingExtension($this, 'zlib', 'zip extracting');
|
||||
}
|
||||
|
||||
$zip = new \ZipArchive();
|
||||
if (($status = $zip->open($this->filename)) !== true) {
|
||||
return Result::error($this, "Could not open zip archive {$this->filename}");
|
||||
}
|
||||
if (!$zip->extractTo($extractLocation)) {
|
||||
return Result::error($this, "Could not extract zip archive {$this->filename}");
|
||||
}
|
||||
$zip->close();
|
||||
|
||||
return Result::success($this);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $extractLocation
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
protected function extractTar($extractLocation)
|
||||
{
|
||||
if (!class_exists('Archive_Tar')) {
|
||||
return Result::errorMissingPackage($this, 'Archive_Tar', 'pear/archive_tar');
|
||||
}
|
||||
$tar_object = new \Archive_Tar($this->filename);
|
||||
if (!$tar_object->extract($extractLocation)) {
|
||||
return Result::error($this, "Could not extract tar archive {$this->filename}");
|
||||
}
|
||||
|
||||
return Result::success($this);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $filename
|
||||
*
|
||||
* @return bool|string
|
||||
*/
|
||||
protected static function archiveType($filename)
|
||||
{
|
||||
$content_type = false;
|
||||
if (class_exists('finfo')) {
|
||||
$finfo = new \finfo(FILEINFO_MIME_TYPE);
|
||||
$content_type = $finfo->file($filename);
|
||||
// If finfo cannot determine the content type, then we will try other methods
|
||||
if ($content_type == 'application/octet-stream') {
|
||||
$content_type = false;
|
||||
}
|
||||
}
|
||||
// Examing the file's magic header bytes.
|
||||
if (!$content_type) {
|
||||
if ($file = fopen($filename, 'rb')) {
|
||||
$first = fread($file, 2);
|
||||
fclose($file);
|
||||
if ($first !== false) {
|
||||
// Interpret the two bytes as a little endian 16-bit unsigned int.
|
||||
$data = unpack('v', $first);
|
||||
switch ($data[1]) {
|
||||
case 0x8b1f:
|
||||
// First two bytes of gzip files are 0x1f, 0x8b (little-endian).
|
||||
// See http://www.gzip.org/zlib/rfc-gzip.html#header-trailer
|
||||
$content_type = 'application/x-gzip';
|
||||
break;
|
||||
|
||||
case 0x4b50:
|
||||
// First two bytes of zip files are 0x50, 0x4b ('PK') (little-endian).
|
||||
// See http://en.wikipedia.org/wiki/Zip_(file_format)#File_headers
|
||||
$content_type = 'application/zip';
|
||||
break;
|
||||
|
||||
case 0x5a42:
|
||||
// First two bytes of bzip2 files are 0x5a, 0x42 ('BZ') (big-endian).
|
||||
// See http://en.wikipedia.org/wiki/Bzip2#File_format
|
||||
$content_type = 'application/x-bzip2';
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
// 3. Lastly if above methods didn't work, try to guess the mime type from
|
||||
// the file extension. This is useful if the file has no identificable magic
|
||||
// header bytes (for example tarballs).
|
||||
if (!$content_type) {
|
||||
// Remove querystring from the filename, if present.
|
||||
$filename = basename(current(explode('?', $filename, 2)));
|
||||
$extension_mimetype = array(
|
||||
'.tar.gz' => 'application/x-gzip',
|
||||
'.tgz' => 'application/x-gzip',
|
||||
'.tar' => 'application/x-tar',
|
||||
);
|
||||
foreach ($extension_mimetype as $extension => $ct) {
|
||||
if (substr($filename, -strlen($extension)) === $extension) {
|
||||
$content_type = $ct;
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return $content_type;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return string
|
||||
*/
|
||||
protected static function getTmpDir()
|
||||
{
|
||||
return getcwd().'/tmp'.rand().time();
|
||||
}
|
||||
}
|
||||
257
vendor/consolidation/robo/src/Task/Archive/Pack.php
vendored
Normal file
257
vendor/consolidation/robo/src/Task/Archive/Pack.php
vendored
Normal file
|
|
@ -0,0 +1,257 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Task\Archive;
|
||||
|
||||
use Robo\Contract\PrintedInterface;
|
||||
use Robo\Result;
|
||||
use Robo\Task\BaseTask;
|
||||
use Symfony\Component\Finder\Finder;
|
||||
|
||||
/**
|
||||
* Creates a zip or tar archive.
|
||||
*
|
||||
* ``` php
|
||||
* <?php
|
||||
* $this->taskPack(
|
||||
* <archiveFile>)
|
||||
* ->add('README') // Puts file 'README' in archive at the root
|
||||
* ->add('project') // Puts entire contents of directory 'project' in archinve inside 'project'
|
||||
* ->addFile('dir/file.txt', 'file.txt') // Takes 'file.txt' from cwd and puts it in archive inside 'dir'.
|
||||
* ->run();
|
||||
* ?>
|
||||
* ```
|
||||
*/
|
||||
class Pack extends BaseTask implements PrintedInterface
|
||||
{
|
||||
/**
|
||||
* The list of items to be packed into the archive.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $items = [];
|
||||
|
||||
/**
|
||||
* The full path to the archive to be created.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $archiveFile;
|
||||
|
||||
/**
|
||||
* Construct the class.
|
||||
*
|
||||
* @param string $archiveFile The full path and name of the archive file to create.
|
||||
*
|
||||
* @since 1.0
|
||||
*/
|
||||
public function __construct($archiveFile)
|
||||
{
|
||||
$this->archiveFile = $archiveFile;
|
||||
}
|
||||
|
||||
/**
|
||||
* Satisfy the parent requirement.
|
||||
*
|
||||
* @return bool Always returns true.
|
||||
*
|
||||
* @since 1.0
|
||||
*/
|
||||
public function getPrinted()
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $archiveFile
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function archiveFile($archiveFile)
|
||||
{
|
||||
$this->archiveFile = $archiveFile;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add an item to the archive. Like file_exists(), the parameter
|
||||
* may be a file or a directory.
|
||||
*
|
||||
* @var string
|
||||
* Relative path and name of item to store in archive
|
||||
* @var string
|
||||
* Absolute or relative path to file or directory's location in filesystem
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function addFile($placementLocation, $filesystemLocation)
|
||||
{
|
||||
$this->items[$placementLocation] = $filesystemLocation;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Alias for addFile, in case anyone has angst about using
|
||||
* addFile with a directory.
|
||||
*
|
||||
* @var string
|
||||
* Relative path and name of directory to store in archive
|
||||
* @var string
|
||||
* Absolute or relative path to directory or directory's location in filesystem
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function addDir($placementLocation, $filesystemLocation)
|
||||
{
|
||||
$this->addFile($placementLocation, $filesystemLocation);
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add a file or directory, or list of same to the archive.
|
||||
*
|
||||
* @var string|array
|
||||
* If given a string, should contain the relative filesystem path to the
|
||||
* the item to store in archive; this will also be used as the item's
|
||||
* path in the archive, so absolute paths should not be used here.
|
||||
* If given an array, the key of each item should be the path to store
|
||||
* in the archive, and the value should be the filesystem path to the
|
||||
* item to store.
|
||||
* @return $this
|
||||
*/
|
||||
public function add($item)
|
||||
{
|
||||
if (is_array($item)) {
|
||||
$this->items = array_merge($this->items, $item);
|
||||
} else {
|
||||
$this->addFile($item, $item);
|
||||
}
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a zip archive for distribution.
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*
|
||||
* @since 1.0
|
||||
*/
|
||||
public function run()
|
||||
{
|
||||
$this->startTimer();
|
||||
|
||||
// Use the file extension to determine what kind of archive to create.
|
||||
$fileInfo = new \SplFileInfo($this->archiveFile);
|
||||
$extension = strtolower($fileInfo->getExtension());
|
||||
if (empty($extension)) {
|
||||
return Result::error($this, "Archive filename must use an extension (e.g. '.zip') to specify the kind of archive to create.");
|
||||
}
|
||||
|
||||
try {
|
||||
// Inform the user which archive we are creating
|
||||
$this->printTaskInfo("Creating archive {filename}", ['filename' => $this->archiveFile]);
|
||||
if ($extension == 'zip') {
|
||||
$result = $this->archiveZip($this->archiveFile, $this->items);
|
||||
} else {
|
||||
$result = $this->archiveTar($this->archiveFile, $this->items);
|
||||
}
|
||||
$this->printTaskSuccess("{filename} created.", ['filename' => $this->archiveFile]);
|
||||
} catch (\Exception $e) {
|
||||
$this->printTaskError("Could not create {filename}. {exception}", ['filename' => $this->archiveFile, 'exception' => $e->getMessage(), '_style' => ['exception' => '']]);
|
||||
$result = Result::error($this, sprintf('Could not create %s. %s', $this->archiveFile, $e->getMessage()));
|
||||
}
|
||||
$this->stopTimer();
|
||||
$result['time'] = $this->getExecutionTime();
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $archiveFile
|
||||
* @param array $items
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
protected function archiveTar($archiveFile, $items)
|
||||
{
|
||||
if (!class_exists('Archive_Tar')) {
|
||||
return Result::errorMissingPackage($this, 'Archive_Tar', 'pear/archive_tar');
|
||||
}
|
||||
|
||||
$tar_object = new \Archive_Tar($archiveFile);
|
||||
foreach ($items as $placementLocation => $filesystemLocation) {
|
||||
$p_remove_dir = $filesystemLocation;
|
||||
$p_add_dir = $placementLocation;
|
||||
if (is_file($filesystemLocation)) {
|
||||
$p_remove_dir = dirname($filesystemLocation);
|
||||
$p_add_dir = dirname($placementLocation);
|
||||
if (basename($filesystemLocation) != basename($placementLocation)) {
|
||||
return Result::error($this, "Tar archiver does not support renaming files during extraction; could not add $filesystemLocation as $placementLocation.");
|
||||
}
|
||||
}
|
||||
|
||||
if (!$tar_object->addModify([$filesystemLocation], $p_add_dir, $p_remove_dir)) {
|
||||
return Result::error($this, "Could not add $filesystemLocation to the archive.");
|
||||
}
|
||||
}
|
||||
|
||||
return Result::success($this);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $archiveFile
|
||||
* @param array $items
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
protected function archiveZip($archiveFile, $items)
|
||||
{
|
||||
if (!extension_loaded('zlib')) {
|
||||
return Result::errorMissingExtension($this, 'zlib', 'zip packing');
|
||||
}
|
||||
|
||||
$zip = new \ZipArchive($archiveFile, \ZipArchive::CREATE);
|
||||
if (!$zip->open($archiveFile, \ZipArchive::CREATE)) {
|
||||
return Result::error($this, "Could not create zip archive {$archiveFile}");
|
||||
}
|
||||
$result = $this->addItemsToZip($zip, $items);
|
||||
$zip->close();
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param \ZipArchive $zip
|
||||
* @param array $items
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
protected function addItemsToZip($zip, $items)
|
||||
{
|
||||
foreach ($items as $placementLocation => $filesystemLocation) {
|
||||
if (is_dir($filesystemLocation)) {
|
||||
$finder = new Finder();
|
||||
$finder->files()->in($filesystemLocation)->ignoreDotFiles(false);
|
||||
|
||||
foreach ($finder as $file) {
|
||||
// Replace Windows slashes or resulting zip will have issues on *nixes.
|
||||
$relativePathname = str_replace('\\', '/', $file->getRelativePathname());
|
||||
|
||||
if (!$zip->addFile($file->getRealpath(), "{$placementLocation}/{$relativePathname}")) {
|
||||
return Result::error($this, "Could not add directory $filesystemLocation to the archive; error adding {$file->getRealpath()}.");
|
||||
}
|
||||
}
|
||||
} elseif (is_file($filesystemLocation)) {
|
||||
if (!$zip->addFile($filesystemLocation, $placementLocation)) {
|
||||
return Result::error($this, "Could not add file $filesystemLocation to the archive.");
|
||||
}
|
||||
} else {
|
||||
return Result::error($this, "Could not find $filesystemLocation for the archive.");
|
||||
}
|
||||
}
|
||||
|
||||
return Result::success($this);
|
||||
}
|
||||
}
|
||||
25
vendor/consolidation/robo/src/Task/Archive/loadTasks.php
vendored
Normal file
25
vendor/consolidation/robo/src/Task/Archive/loadTasks.php
vendored
Normal file
|
|
@ -0,0 +1,25 @@
|
|||
<?php
|
||||
namespace Robo\Task\Archive;
|
||||
|
||||
trait loadTasks
|
||||
{
|
||||
/**
|
||||
* @param $filename
|
||||
*
|
||||
* @return Pack
|
||||
*/
|
||||
protected function taskPack($filename)
|
||||
{
|
||||
return $this->task(Pack::class, $filename);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param $filename
|
||||
*
|
||||
* @return Extract
|
||||
*/
|
||||
protected function taskExtract($filename)
|
||||
{
|
||||
return $this->task(Extract::class, $filename);
|
||||
}
|
||||
}
|
||||
214
vendor/consolidation/robo/src/Task/Assets/CssPreprocessor.php
vendored
Normal file
214
vendor/consolidation/robo/src/Task/Assets/CssPreprocessor.php
vendored
Normal file
|
|
@ -0,0 +1,214 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Task\Assets;
|
||||
|
||||
use Robo\Result;
|
||||
use Robo\Task\BaseTask;
|
||||
|
||||
abstract class CssPreprocessor extends BaseTask
|
||||
{
|
||||
const FORMAT_NAME = '';
|
||||
|
||||
/**
|
||||
* Default compiler to use.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
protected $compiler;
|
||||
|
||||
/**
|
||||
* Available compilers list
|
||||
*
|
||||
* @var string[]
|
||||
*/
|
||||
protected $compilers = [];
|
||||
|
||||
/**
|
||||
* Compiler options.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $compilerOptions = [];
|
||||
|
||||
/**
|
||||
* @var array
|
||||
*/
|
||||
protected $files = [];
|
||||
|
||||
/**
|
||||
* Constructor. Accepts array of file paths.
|
||||
*
|
||||
* @param array $input
|
||||
*/
|
||||
public function __construct(array $input)
|
||||
{
|
||||
$this->files = $input;
|
||||
|
||||
$this->setDefaultCompiler();
|
||||
}
|
||||
|
||||
protected function setDefaultCompiler()
|
||||
{
|
||||
if (isset($this->compilers[0])) {
|
||||
//set first compiler as default
|
||||
$this->compiler = $this->compilers[0];
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets import directories
|
||||
* Alias for setImportPaths
|
||||
* @see CssPreprocessor::setImportPaths
|
||||
*
|
||||
* @param array|string $dirs
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function importDir($dirs)
|
||||
{
|
||||
return $this->setImportPaths($dirs);
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds import directory
|
||||
*
|
||||
* @param string $dir
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function addImportPath($dir)
|
||||
{
|
||||
if (!isset($this->compilerOptions['importDirs'])) {
|
||||
$this->compilerOptions['importDirs'] = [];
|
||||
}
|
||||
|
||||
if (!in_array($dir, $this->compilerOptions['importDirs'], true)) {
|
||||
$this->compilerOptions['importDirs'][] = $dir;
|
||||
}
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets import directories
|
||||
*
|
||||
* @param array|string $dirs
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setImportPaths($dirs)
|
||||
{
|
||||
if (!is_array($dirs)) {
|
||||
$dirs = [$dirs];
|
||||
}
|
||||
|
||||
$this->compilerOptions['importDirs'] = $dirs;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $formatterName
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function setFormatter($formatterName)
|
||||
{
|
||||
$this->compilerOptions['formatter'] = $formatterName;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the compiler.
|
||||
*
|
||||
* @param string $compiler
|
||||
* @param array $options
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function compiler($compiler, array $options = [])
|
||||
{
|
||||
$this->compiler = $compiler;
|
||||
$this->compilerOptions = array_merge($this->compilerOptions, $options);
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Compiles file
|
||||
*
|
||||
* @param $file
|
||||
*
|
||||
* @return bool|mixed
|
||||
*/
|
||||
protected function compile($file)
|
||||
{
|
||||
if (is_callable($this->compiler)) {
|
||||
return call_user_func($this->compiler, $file, $this->compilerOptions);
|
||||
}
|
||||
|
||||
if (method_exists($this, $this->compiler)) {
|
||||
return $this->{$this->compiler}($file);
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function run()
|
||||
{
|
||||
if (!in_array($this->compiler, $this->compilers, true)
|
||||
&& !is_callable($this->compiler)
|
||||
) {
|
||||
$message = sprintf('Invalid ' . static::FORMAT_NAME . ' compiler %s!', $this->compiler);
|
||||
|
||||
return Result::error($this, $message);
|
||||
}
|
||||
|
||||
foreach ($this->files as $in => $out) {
|
||||
if (!file_exists($in)) {
|
||||
$message = sprintf('File %s not found.', $in);
|
||||
|
||||
return Result::error($this, $message);
|
||||
}
|
||||
if (file_exists($out) && !is_writable($out)) {
|
||||
return Result::error($this, 'Destination already exists and cannot be overwritten.');
|
||||
}
|
||||
}
|
||||
|
||||
foreach ($this->files as $in => $out) {
|
||||
$css = $this->compile($in);
|
||||
|
||||
if ($css instanceof Result) {
|
||||
return $css;
|
||||
} elseif (false === $css) {
|
||||
$message = sprintf(
|
||||
ucfirst(static::FORMAT_NAME) . ' compilation failed for %s.',
|
||||
$in
|
||||
);
|
||||
|
||||
return Result::error($this, $message);
|
||||
}
|
||||
|
||||
$dst = $out . '.part';
|
||||
$write_result = file_put_contents($dst, $css);
|
||||
|
||||
if (false === $write_result) {
|
||||
$message = sprintf('File write failed: %s', $out);
|
||||
|
||||
@unlink($dst);
|
||||
return Result::error($this, $message);
|
||||
}
|
||||
|
||||
// Cannot be cross-volume: should always succeed
|
||||
@rename($dst, $out);
|
||||
|
||||
$this->printTaskSuccess('Wrote CSS to {filename}', ['filename' => $out]);
|
||||
}
|
||||
|
||||
return Result::success($this, 'All ' . static::FORMAT_NAME . ' files compiled.');
|
||||
}
|
||||
}
|
||||
716
vendor/consolidation/robo/src/Task/Assets/ImageMinify.php
vendored
Normal file
716
vendor/consolidation/robo/src/Task/Assets/ImageMinify.php
vendored
Normal file
|
|
@ -0,0 +1,716 @@
|
|||
<?php
|
||||
|
||||
namespace Robo\Task\Assets;
|
||||
|
||||
use Robo\Result;
|
||||
use Robo\Exception\TaskException;
|
||||
use Robo\Task\BaseTask;
|
||||
use Robo\Task\Base\Exec;
|
||||
use Symfony\Component\Finder\Finder;
|
||||
use Symfony\Component\Filesystem\Filesystem as sfFilesystem;
|
||||
|
||||
/**
|
||||
* Minifies images. When the required minifier is not installed on the system
|
||||
* the task will try to download it from the [imagemin](https://github.com/imagemin) repository.
|
||||
*
|
||||
* When the task is run without any specified minifier it will compress the images
|
||||
* based on the extension.
|
||||
*
|
||||
* ```php
|
||||
* $this->taskImageMinify('assets/images/*')
|
||||
* ->to('dist/images/')
|
||||
* ->run();
|
||||
* ```
|
||||
*
|
||||
* This will use the following minifiers:
|
||||
*
|
||||
* - PNG: optipng
|
||||
* - GIF: gifsicle
|
||||
* - JPG, JPEG: jpegtran
|
||||
* - SVG: svgo
|
||||
*
|
||||
* When the minifier is specified the task will use that for all the input files. In that case
|
||||
* it is useful to filter the files with the extension:
|
||||
*
|
||||
* ```php
|
||||
* $this->taskImageMinify('assets/images/*.png')
|
||||
* ->to('dist/images/')
|
||||
* ->minifier('pngcrush');
|
||||
* ->run();
|
||||
* ```
|
||||
*
|
||||
* The task supports the following minifiers:
|
||||
*
|
||||
* - optipng
|
||||
* - pngquant
|
||||
* - advpng
|
||||
* - pngout
|
||||
* - zopflipng
|
||||
* - pngcrush
|
||||
* - gifsicle
|
||||
* - jpegoptim
|
||||
* - jpeg-recompress
|
||||
* - jpegtran
|
||||
* - svgo (only minification, no downloading)
|
||||
*
|
||||
* You can also specifiy extra options for the minifiers:
|
||||
*
|
||||
* ```php
|
||||
* $this->taskImageMinify('assets/images/*.jpg')
|
||||
* ->to('dist/images/')
|
||||
* ->minifier('jpegtran', ['-progressive' => null, '-copy' => 'none'])
|
||||
* ->run();
|
||||
* ```
|
||||
*
|
||||
* This will execute as:
|
||||
* `jpegtran -copy none -progressive -optimize -outfile "dist/images/test.jpg" "/var/www/test/assets/images/test.jpg"`
|
||||
*/
|
||||
class ImageMinify extends BaseTask
|
||||
{
|
||||
/**
|
||||
* Destination directory for the minified images.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
protected $to;
|
||||
|
||||
/**
|
||||
* Array of the source files.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $dirs = [];
|
||||
|
||||
/**
|
||||
* Symfony 2 filesystem.
|
||||
*
|
||||
* @var sfFilesystem
|
||||
*/
|
||||
protected $fs;
|
||||
|
||||
/**
|
||||
* Target directory for the downloaded binary executables.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
protected $executableTargetDir;
|
||||
|
||||
/**
|
||||
* Array for the downloaded binary executables.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $executablePaths = [];
|
||||
|
||||
/**
|
||||
* Array for the individual results of all the files.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $results = [];
|
||||
|
||||
/**
|
||||
* Default minifier to use.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
protected $minifier;
|
||||
|
||||
/**
|
||||
* Array for minifier options.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $minifierOptions = [];
|
||||
|
||||
/**
|
||||
* Supported minifiers.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $minifiers = [
|
||||
// Default 4
|
||||
'optipng',
|
||||
'gifsicle',
|
||||
'jpegtran',
|
||||
'svgo',
|
||||
// PNG
|
||||
'pngquant',
|
||||
'advpng',
|
||||
'pngout',
|
||||
'zopflipng',
|
||||
'pngcrush',
|
||||
// JPG
|
||||
'jpegoptim',
|
||||
'jpeg-recompress',
|
||||
];
|
||||
|
||||
/**
|
||||
* Binary repositories of Imagemin.
|
||||
*
|
||||
* @link https://github.com/imagemin
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $imageminRepos = [
|
||||
// PNG
|
||||
'optipng' => 'https://github.com/imagemin/optipng-bin',
|
||||
'pngquant' => 'https://github.com/imagemin/pngquant-bin',
|
||||
'advpng' => 'https://github.com/imagemin/advpng-bin',
|
||||
'pngout' => 'https://github.com/imagemin/pngout-bin',
|
||||
'zopflipng' => 'https://github.com/imagemin/zopflipng-bin',
|
||||
'pngcrush' => 'https://github.com/imagemin/pngcrush-bin',
|
||||
// Gif
|
||||
'gifsicle' => 'https://github.com/imagemin/gifsicle-bin',
|
||||
// JPG
|
||||
'jpegtran' => 'https://github.com/imagemin/jpegtran-bin',
|
||||
'jpegoptim' => 'https://github.com/imagemin/jpegoptim-bin',
|
||||
'cjpeg' => 'https://github.com/imagemin/mozjpeg-bin', // note: we do not support this minifier because it creates JPG from non-JPG files
|
||||
'jpeg-recompress' => 'https://github.com/imagemin/jpeg-recompress-bin',
|
||||
// WebP
|
||||
'cwebp' => 'https://github.com/imagemin/cwebp-bin', // note: we do not support this minifier because it creates WebP from non-WebP files
|
||||
];
|
||||
|
||||
public function __construct($dirs)
|
||||
{
|
||||
is_array($dirs)
|
||||
? $this->dirs = $dirs
|
||||
: $this->dirs[] = $dirs;
|
||||
|
||||
$this->fs = new sfFilesystem();
|
||||
|
||||
// guess the best path for the executables based on __DIR__
|
||||
if (($pos = strpos(__DIR__, 'consolidation/robo')) !== false) {
|
||||
// the executables should be stored in vendor/bin
|
||||
$this->executableTargetDir = substr(__DIR__, 0, $pos).'bin';
|
||||
}
|
||||
|
||||
// check if the executables are already available
|
||||
foreach ($this->imageminRepos as $exec => $url) {
|
||||
$path = $this->executableTargetDir.'/'.$exec;
|
||||
// if this is Windows add a .exe extension
|
||||
if (substr($this->getOS(), 0, 3) == 'win') {
|
||||
$path .= '.exe';
|
||||
}
|
||||
if (is_file($path)) {
|
||||
$this->executablePaths[$exec] = $path;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function run()
|
||||
{
|
||||
// find the files
|
||||
$files = $this->findFiles($this->dirs);
|
||||
|
||||
// minify the files
|
||||
$result = $this->minify($files);
|
||||
// check if there was an error
|
||||
if ($result instanceof Result) {
|
||||
return $result;
|
||||
}
|
||||
|
||||
$amount = (count($files) == 1 ? 'image' : 'images');
|
||||
$message = "Minified {filecount} out of {filetotal} $amount into {destination}";
|
||||
$context = ['filecount' => count($this->results['success']), 'filetotal' => count($files), 'destination' => $this->to];
|
||||
|
||||
if (count($this->results['success']) == count($files)) {
|
||||
$this->printTaskSuccess($message, $context);
|
||||
|
||||
return Result::success($this, $message, $context);
|
||||
} else {
|
||||
return Result::error($this, $message, $context);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the target directory where the files will be copied to.
|
||||
*
|
||||
* @param string $target
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function to($target)
|
||||
{
|
||||
$this->to = rtrim($target, '/');
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the minifier.
|
||||
*
|
||||
* @param string $minifier
|
||||
* @param array $options
|
||||
*
|
||||
* @return $this
|
||||
*/
|
||||
public function minifier($minifier, array $options = [])
|
||||
{
|
||||
$this->minifier = $minifier;
|
||||
$this->minifierOptions = array_merge($this->minifierOptions, $options);
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array $dirs
|
||||
*
|
||||
* @return array|\Robo\Result
|
||||
*
|
||||
* @throws \Robo\Exception\TaskException
|
||||
*/
|
||||
protected function findFiles($dirs)
|
||||
{
|
||||
$files = array();
|
||||
|
||||
// find the files
|
||||
foreach ($dirs as $k => $v) {
|
||||
// reset finder
|
||||
$finder = new Finder();
|
||||
|
||||
$dir = $k;
|
||||
$to = $v;
|
||||
// check if target was given with the to() method instead of key/value pairs
|
||||
if (is_int($k)) {
|
||||
$dir = $v;
|
||||
if (isset($this->to)) {
|
||||
$to = $this->to;
|
||||
} else {
|
||||
throw new TaskException($this, 'target directory is not defined');
|
||||
}
|
||||
}
|
||||
|
||||
try {
|
||||
$finder->files()->in($dir);
|
||||
} catch (\InvalidArgumentException $e) {
|
||||
// if finder cannot handle it, try with in()->name()
|
||||
if (strpos($dir, '/') === false) {
|
||||
$dir = './'.$dir;
|
||||
}
|
||||
$parts = explode('/', $dir);
|
||||
$new_dir = implode('/', array_slice($parts, 0, -1));
|
||||
try {
|
||||
$finder->files()->in($new_dir)->name(array_pop($parts));
|
||||
} catch (\InvalidArgumentException $e) {
|
||||
return Result::fromException($this, $e);
|
||||
}
|
||||
}
|
||||
|
||||
foreach ($finder as $file) {
|
||||
// store the absolute path as key and target as value in the files array
|
||||
$files[$file->getRealpath()] = $this->getTarget($file->getRealPath(), $to);
|
||||
}
|
||||
$fileNoun = count($finder) == 1 ? ' file' : ' files';
|
||||
$this->printTaskInfo("Found {filecount} $fileNoun in {dir}", ['filecount' => count($finder), 'dir' => $dir]);
|
||||
}
|
||||
|
||||
return $files;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $file
|
||||
* @param string $to
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function getTarget($file, $to)
|
||||
{
|
||||
$target = $to.'/'.basename($file);
|
||||
|
||||
return $target;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array $files
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
protected function minify($files)
|
||||
{
|
||||
// store the individual results into the results array
|
||||
$this->results = [
|
||||
'success' => [],
|
||||
'error' => [],
|
||||
];
|
||||
|
||||
// loop through the files
|
||||
foreach ($files as $from => $to) {
|
||||
if (!isset($this->minifier)) {
|
||||
// check filetype based on the extension
|
||||
$extension = strtolower(pathinfo($from, PATHINFO_EXTENSION));
|
||||
|
||||
// set the default minifiers based on the extension
|
||||
switch ($extension) {
|
||||
case 'png':
|
||||
$minifier = 'optipng';
|
||||
break;
|
||||
case 'jpg':
|
||||
case 'jpeg':
|
||||
$minifier = 'jpegtran';
|
||||
break;
|
||||
case 'gif':
|
||||
$minifier = 'gifsicle';
|
||||
break;
|
||||
case 'svg':
|
||||
$minifier = 'svgo';
|
||||
break;
|
||||
}
|
||||
} else {
|
||||
if (!in_array($this->minifier, $this->minifiers, true)
|
||||
&& !is_callable(strtr($this->minifier, '-', '_'))
|
||||
) {
|
||||
$message = sprintf('Invalid minifier %s!', $this->minifier);
|
||||
|
||||
return Result::error($this, $message);
|
||||
}
|
||||
$minifier = $this->minifier;
|
||||
}
|
||||
|
||||
// Convert minifier name to camelCase (e.g. jpeg-recompress)
|
||||
$funcMinifier = $this->camelCase($minifier);
|
||||
|
||||
// call the minifier method which prepares the command
|
||||
if (is_callable($funcMinifier)) {
|
||||
$command = call_user_func($funcMinifier, $from, $to, $this->minifierOptions);
|
||||
} elseif (method_exists($this, $funcMinifier)) {
|
||||
$command = $this->{$funcMinifier}($from, $to);
|
||||
} else {
|
||||
$message = sprintf('Minifier method <info>%s</info> cannot be found!', $funcMinifier);
|
||||
|
||||
return Result::error($this, $message);
|
||||
}
|
||||
|
||||
// launch the command
|
||||
$this->printTaskInfo('Minifying {filepath} with {minifier}', ['filepath' => $from, 'minifier' => $minifier]);
|
||||
$result = $this->executeCommand($command);
|
||||
|
||||
// check the return code
|
||||
if ($result->getExitCode() == 127) {
|
||||
$this->printTaskError('The {minifier} executable cannot be found', ['minifier' => $minifier]);
|
||||
// try to install from imagemin repository
|
||||
if (array_key_exists($minifier, $this->imageminRepos)) {
|
||||
$result = $this->installFromImagemin($minifier);
|
||||
if ($result instanceof Result) {
|
||||
if ($result->wasSuccessful()) {
|
||||
$this->printTaskSuccess($result->getMessage());
|
||||
// retry the conversion with the downloaded executable
|
||||
if (is_callable($minifier)) {
|
||||
$command = call_user_func($minifier, $from, $to, $minifierOptions);
|
||||
} elseif (method_exists($this, $minifier)) {
|
||||
$command = $this->{$minifier}($from, $to);
|
||||
}
|
||||
// launch the command
|
||||
$this->printTaskInfo('Minifying {filepath} with {minifier}', ['filepath' => $from, 'minifier' => $minifier]);
|
||||
$result = $this->executeCommand($command);
|
||||
} else {
|
||||
$this->printTaskError($result->getMessage());
|
||||
// the download was not successful
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
} else {
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
|
||||
// check the success of the conversion
|
||||
if ($result->getExitCode() !== 0) {
|
||||
$this->results['error'][] = $from;
|
||||
} else {
|
||||
$this->results['success'][] = $from;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @return string
|
||||
*/
|
||||
protected function getOS()
|
||||
{
|
||||
$os = php_uname('s');
|
||||
$os .= '/'.php_uname('m');
|
||||
// replace x86_64 to x64, because the imagemin repo uses that
|
||||
$os = str_replace('x86_64', 'x64', $os);
|
||||
// replace i386, i686, etc to x86, because of imagemin
|
||||
$os = preg_replace('/i[0-9]86/', 'x86', $os);
|
||||
// turn info to lowercase, because of imagemin
|
||||
$os = strtolower($os);
|
||||
|
||||
return $os;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $command
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
protected function executeCommand($command)
|
||||
{
|
||||
// insert the options into the command
|
||||
$a = explode(' ', $command);
|
||||
$executable = array_shift($a);
|
||||
foreach ($this->minifierOptions as $key => $value) {
|
||||
// first prepend the value
|
||||
if (!empty($value)) {
|
||||
array_unshift($a, $value);
|
||||
}
|
||||
// then add the key
|
||||
if (!is_numeric($key)) {
|
||||
array_unshift($a, $key);
|
||||
}
|
||||
}
|
||||
// check if the executable can be replaced with the downloaded one
|
||||
if (array_key_exists($executable, $this->executablePaths)) {
|
||||
$executable = $this->executablePaths[$executable];
|
||||
}
|
||||
array_unshift($a, $executable);
|
||||
$command = implode(' ', $a);
|
||||
|
||||
// execute the command
|
||||
$exec = new Exec($command);
|
||||
|
||||
return $exec->inflect($this)->printed(false)->run();
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $executable
|
||||
*
|
||||
* @return \Robo\Result
|
||||
*/
|
||||
protected function installFromImagemin($executable)
|
||||
{
|
||||
// check if there is an url defined for the executable
|
||||
if (!array_key_exists($executable, $this->imageminRepos)) {
|
||||
$message = sprintf('The executable %s cannot be found in the defined imagemin repositories', $executable);
|
||||
|
||||
return Result::error($this, $message);
|
||||
}
|
||||
$this->printTaskInfo('Downloading the {executable} executable from the imagemin repository', ['executable' => $executable]);
|
||||
|
||||
$os = $this->getOS();
|
||||
$url = $this->imageminRepos[$executable].'/blob/master/vendor/'.$os.'/'.$executable.'?raw=true';
|
||||
if (substr($os, 0, 3) == 'win') {
|
||||
// if it is win, add a .exe extension
|
||||
$url = $this->imageminRepos[$executable].'/blob/master/vendor/'.$os.'/'.$executable.'.exe?raw=true';
|
||||
}
|
||||
$data = @file_get_contents($url, false, null);
|
||||
if ($data === false) {
|
||||
// there is something wrong with the url, try it without the version info
|
||||
$url = preg_replace('/x[68][64]\//', '', $url);
|
||||
$data = @file_get_contents($url, false, null);
|
||||
if ($data === false) {
|
||||
// there is still something wrong with the url if it is win, try with win32
|
||||
if (substr($os, 0, 3) == 'win') {
|
||||
$url = preg_replace('win/', 'win32/', $url);
|
||||
$data = @file_get_contents($url, false, null);
|
||||
if ($data === false) {
|
||||
// there is nothing more we can do
|
||||
$message = sprintf('Could not download the executable <info>%s</info>', $executable);
|
||||
|
||||
return Result::error($this, $message);
|
||||
}
|
||||
}
|
||||
// if it is not windows there is nothing we can do
|
||||
$message = sprintf('Could not download the executable <info>%s</info>', $executable);
|
||||
|
||||
return Result::error($this, $message);
|
||||
}
|
||||
}
|
||||
// check if target directory exists
|
||||
if (!is_dir($this->executableTargetDir)) {
|
||||
mkdir($this->executableTargetDir);
|
||||
}
|
||||
// save the executable into the target dir
|
||||
$path = $this->executableTargetDir.'/'.$executable;
|
||||
if (substr($os, 0, 3) == 'win') {
|
||||
// if it is win, add a .exe extension
|
||||
$path = $this->executableTargetDir.'/'.$executable.'.exe';
|
||||
}
|
||||
$result = file_put_contents($path, $data);
|
||||
if ($result === false) {
|
||||
$message = sprintf('Could not copy the executable <info>%s</info> to %s', $executable, $target_dir);
|
||||
|
||||
return Result::error($this, $message);
|
||||
}
|
||||
// set the binary to executable
|
||||
chmod($path, 0755);
|
||||
|
||||
// if everything successful, store the executable path
|
||||
$this->executablePaths[$executable] = $this->executableTargetDir.'/'.$executable;
|
||||
// if it is win, add a .exe extension
|
||||
if (substr($os, 0, 3) == 'win') {
|
||||
$this->executablePaths[$executable] .= '.exe';
|
||||
}
|
||||
|
||||
$message = sprintf('Executable <info>%s</info> successfully downloaded', $executable);
|
||||
|
||||
return Result::success($this, $message);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $from
|
||||
* @param string $to
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function optipng($from, $to)
|
||||
{
|
||||
$command = sprintf('optipng -quiet -out "%s" -- "%s"', $to, $from);
|
||||
if ($from != $to && is_file($to)) {
|
||||
// earlier versions of optipng do not overwrite the target without a backup
|
||||
// http://sourceforge.net/p/optipng/bugs/37/
|
||||
unlink($to);
|
||||
}
|
||||
|
||||
return $command;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $from
|
||||
* @param string $to
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function jpegtran($from, $to)
|
||||
{
|
||||
$command = sprintf('jpegtran -optimize -outfile "%s" "%s"', $to, $from);
|
||||
|
||||
return $command;
|
||||
}
|
||||
|
||||
protected function gifsicle($from, $to)
|
||||
{
|
||||
$command = sprintf('gifsicle -o "%s" "%s"', $to, $from);
|
||||
|
||||
return $command;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $from
|
||||
* @param string $to
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function svgo($from, $to)
|
||||
{
|
||||
$command = sprintf('svgo "%s" "%s"', $from, $to);
|
||||
|
||||
return $command;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $from
|
||||
* @param string $to
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function pngquant($from, $to)
|
||||
{
|
||||
$command = sprintf('pngquant --force --output "%s" "%s"', $to, $from);
|
||||
|
||||
return $command;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $from
|
||||
* @param string $to
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function advpng($from, $to)
|
||||
{
|
||||
// advpng does not have any output parameters, copy the file and then compress the copy
|
||||
$command = sprintf('advpng --recompress --quiet "%s"', $to);
|
||||
$this->fs->copy($from, $to, true);
|
||||
|
||||
return $command;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $from
|
||||
* @param string $to
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function pngout($from, $to)
|
||||
{
|
||||
$command = sprintf('pngout -y -q "%s" "%s"', $from, $to);
|
||||
|
||||
return $command;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $from
|
||||
* @param string $to
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function zopflipng($from, $to)
|
||||
{
|
||||
$command = sprintf('zopflipng -y "%s" "%s"', $from, $to);
|
||||
|
||||
return $command;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $from
|
||||
* @param string $to
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function pngcrush($from, $to)
|
||||
{
|
||||
$command = sprintf('pngcrush -q -ow "%s" "%s"', $from, $to);
|
||||
|
||||
return $command;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $from
|
||||
* @param string $to
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function jpegoptim($from, $to)
|
||||
{
|
||||
// jpegoptim only takes the destination directory as an argument
|
||||
$command = sprintf('jpegoptim --quiet -o --dest "%s" "%s"', dirname($to), $from);
|
||||
|
||||
return $command;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $from
|
||||
* @param string $to
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function jpegRecompress($from, $to)
|
||||
{
|
||||
$command = sprintf('jpeg-recompress --quiet "%s" "%s"', $from, $to);
|
||||
|
||||
return $command;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $text
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function camelCase($text)
|
||||
{
|
||||
// non-alpha and non-numeric characters become spaces
|
||||
$text = preg_replace('/[^a-z0-9]+/i', ' ', $text);
|
||||
$text = trim($text);
|
||||
// uppercase the first character of each word
|
||||
$text = ucwords($text);
|
||||
$text = str_replace(" ", "", $text);
|
||||
$text = lcfirst($text);
|
||||
|
||||
return $text;
|
||||
}
|
||||
}
|
||||
Some files were not shown because too many files have changed in this diff Show more
Reference in a new issue