wouterj / fred
A very simple iteration based task runner
Requires
- php: >=5.3.3
- symfony/console: 2.*
- symfony/process: 2.*
Requires (Dev)
- behat/behat: ~3.0
- phpspec/phpspec: ~2.1
- phpunit/phpunit: 4.*
- symfony/finder: 2.*
- webmozart/glob: 1.0.*@dev
This package is auto-updated.
Last update: 2024-10-25 01:49:10 UTC
README
Welcome to Fred. Fred will execute tasks that you have described in a fred file.
Fred is not a grown up man at the moment. The steps used in this docs are not yet implemented. Do you help me teach him how to do developer tasks?
Why should I use Fred?
- You don't have to spent time installing NodeJS, NPM on your server just to run tasks;
- You can work with a syntax you're familiar with;
- Fred's codebase is very small (just 9 classes) and as flexible as task runners can be.
Installation
The best way to install Fred is using Composer:
$ composer global require wouterj/fred:0.*
If you set-up composer's global binary directory correctly, this will give you a new command:
fred
Usage
You start by creating a fred.php
file (the fred file). In this file, you specify the
tasks. You do this by calling the task()
method of the $fred
variable that's available
in the file:
$fred->task('build', function () use ($fred) { // ... specify the tasks });
All tasks begin by opening a file or multiple files and passing a Traversable of these files
to load()
. The best way to do this is by using the
Symfony Finder Component:
use Symfony\Component\Finder\Finder; $fred->task('build', function () use ($fred) { $fred->load(Finder::create()->files()->name('*.js')->in('/web/assets/raw')); });
You've now opened a Fred step sequence for all files with a .js
extension in /web/assets/raw
.
Now you can assign as many steps to this sequence as you want:
use Symfony\Component\Finder\Finder; use WouterJ\Fred\Extension as Ext; $fred->task('build', function () use ($fred) { $fred->load(Finder::create()->files()->name('*.js')->in('/web/assets/raw')) ->then(new Ext\JsHint()) // Lint the JS code using JsHint... ->then(new Ext\Uglify()) // ...minify the JS files using UglifyJS... ->then(new Ext\Compact()) // ...and combine all JS files into one file ; });
At last, you have to output the generated code somewhere. This is done with the dist()
function:
$fred->load(Finder::create()->files()->name('*.js')->in('/web/assets/raw')) ->then(new Ext\JsHint()) ->then(new Ext\Uglify()) ->then(new Ext\Compact()) ->dist('/web/assets/script.min.js') ;
Now, the generated code is dumped in the /web/assets/script.min.js
file.
You can run this task by using fred build
(where build
is the name of the task).
License
The project is released under the BSD license. See the LICENSE file included in this package for more information.
Roadmap
Of course, all kind of changes are welcome (as long as it doesn't make the Fred more complex), but Fred should have learn the following things before reaching a stable version:
- Have more tests (that actually test the console app)
- Have a complete documentation
- Have more extensions and steps