Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/district09/robo-digipolis-general
General Digipolis tasks for Robo Task Runner: read properties files, determine project and web root.
https://github.com/district09/robo-digipolis-general
d09check22 robo robo-digipolis-general robo-tasks web
Last synced: 13 days ago
JSON representation
General Digipolis tasks for Robo Task Runner: read properties files, determine project and web root.
- Host: GitHub
- URL: https://github.com/district09/robo-digipolis-general
- Owner: district09
- License: mit
- Created: 2017-01-03T09:25:29.000Z (almost 8 years ago)
- Default Branch: develop
- Last Pushed: 2023-10-10T12:45:24.000Z (about 1 year ago)
- Last Synced: 2024-10-13T01:13:15.219Z (about 1 month ago)
- Topics: d09check22, robo, robo-digipolis-general, robo-tasks, web
- Language: PHP
- Homepage:
- Size: 57.6 KB
- Stars: 0
- Watchers: 5
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Robo Digipolis General
General Digipolis tasks for Robo Task Runner
[](https://packagist.org/packages/digipolisgent/robo-digipolis-general)
[](https://packagist.org/packages/digipolisgent/robo-digipolis-general)
[](https://packagist.org/packages/digipolisgent/robo-digipolis-general)
[](https://packagist.org/packages/digipolisgent/robo-digipolis-general)
[](https://travis-ci.org/digipolisgent/robo-digipolis-general)
[](https://codeclimate.com/github/digipolisgent/robo-digipolis-general/maintainability)
[](https://codeclimate.com/github/digipolisgent/robo-digipolis-general/test_coverage)
[](https://travis-ci.org/digipolisgent/robo-digipolis-general)
## Tasks in this package
### DetermineProjectRoot
Determines the root folder of the project by looking for certain files in the
given folder. By default it looks for a `properties.yml` or a `composer.json`
file. Usually this task is ran before running an other task in the same command
so the config value can be passed to that task.
```php
// Recursively search for a project root folder in the current directory with a
// maximum depth of 2.
$result = $this->taskDetermineProjectRoot(getcwd(), 2)
// Do not search in the tests and vendor folders.
->exclude(['tests', 'vendor'])
// A folder containing a composer.json is considered a project root.
->searchFiles(['composer.json'])
->run();
// The project root is stored in the digipolis.root.project config.
$root = $this->getConfig()->get('digipolis.root.project');
```
### DetermineWebRoot
Determines the web root folder of the project by looking for certain files in
the given folder. By default it looks for a `index.php`, `index.html`,
`index.htm`, `home.php`, `home.html` or a `home.htm` file. Usually this task is
ran before running an other task in the same command so the config value can be
passed to that task.
```php
// Recursively search for a web root folder in the current directory with a
// maximum depth of 2.
$result = $this->taskDetermineWebRoot(getcwd(), 2)
// Do not search in the tests and vendor folders.
->exclude(['tests', 'vendor'])
// A folder containing an index.php is considered a project root.
->searchFiles(['index.php'])
->run();
// The project root is stored in the digipolis.root.web config.
$root = $this->getConfig()->get('digipolis.root.web');
```
### ReadProperties
Reads values from yaml files (`default.properties.yml` and `properties.yml`) and
stores them in config. Values from `default.properties.yml` will be overridden
if they exist in a `properties.yml`. If a valid path is set for
`digipolis.root.web` in config, and a `properties.yml` file exists in that path,
those values will have top priority. Property files (both
`default.properties.yml` and `properties.yml`) can define a `_priority` key at
the root of the yaml. Higher priorities (lower number) take precedence over
lower priorities (higher number).
```php
// Search for default.properties.yml and properties.yml files in the current
// directory.
$result = $this->taskReadProperties([getcwd()])
->run();
// Values are stored in config.
$root = $this->getConfig()->get('my.config.value');
```
## Using these tasks in a command
If you want to use these tasks in a command, you can use the
`\DigipolisGent\Robo\Task\General\Common\DigipolisPropertiesAware` trait and
implement the
`\DigipolisGent\Robo\Task\General\Common\DigipolisPropertiesAwareInterface`
interface. This will expose a readProperties method to which you can pass the
paths to the project root, the web root and the vendor folder. If the tasks to
determine the project and web root are available on the class using the trait,
and no project or web root are given as a parameter to the `readProperties`
method, these tasks will be used to determine the paths. They both default to
the current working directory. The vendor folder defaults to the vendor folder
in the web root. Your `RoboFile.php` might look something like this:
```php
class RoboFile extends \Robo\Tasks implements \DigipolisGent\Robo\Task\General\Common\DigipolisPropertiesAwareInterface
{
use \DigipolisGent\Robo\Task\General\Common\DigipolisPropertiesAware;
use \DigipolisGent\Robo\Task\General\loadTasks;
public function myCommand(
$arg1,
$arg2,
$opts = [
'root|r' => null,
'webroot|wr' => null,
'vendor-folder|vf' => null,
]
)
{
$this->readProperties(
$opts['root'],
$opts['webroot'],
$opts['vendor-folder']
);
// All properties are stored in config now, so execute the command.
$this->doCommand();
}
}