Dart workflows, automated.
Grinder consists of a library to define project tasks (e.g. test, build,
doc) and a command-line tool to run them.
To start using grinder, add it to your
dev_dependencies.
Tasks are defined entirely by Dart code allowing you to take advantage of
the whole Dart ecosystem to write and debug them. Task definitions reside
in a tool/grind.dart script. To create a simple grinder script, run:
pub run grinder:init
In general, grinder scripts look something like this:
import 'package:grinder/grinder.dart';
main(args) => grind(args);
@DefaultTask('Build the project.')
build() {
log("Building...");
}
@Task('Test stuff.')
@Depends(build)
test() {
new PubApp.local('test').run([]);
}
@Task('Generate docs.')
doc() {
log("Generating docs...");
}
@Task('Deploy built app.')
@Depends(build, test, doc)
deploy() {
...
}Any task dependencies (see @Depends above), are run before the dependent task.
Grinder contains a variety of convenience APIs for common task definitions, such
as PubApp referenced above. See the
API Documentation for
full details.
First install the grind executable:
pub global activate grinder
then use it to run desired tasks:
grind test
grind build doc
or to run a default task (see @DefaultTask above):
grind
or to display a list of available tasks and their dependencies:
grind -h
You can also bypass installing grind and instead use pub run grinder.
In order to pass parameters to tasks from the command-line, you query the
TaskArgs instance for your task invocation. For example:
grind build --release --mode=topaz
and:
@Task()
build() {
TaskArgs args = context.invocation.arguments;
bool isRelease = args.getFlag('release'); // will be set to true
String mode = args.getOption('mode'); // will be set to topaz
...
}would pass the flag release and the option mode to the build task.
You can pass flags and options to multiple tasks. The following command-line would pass separate flags and options to two different tasks:
grind build --release generate-docs --header=small
This is not an official Google product.
For information about our publishing automation and release process, see https://github.com/dart-lang/ecosystem/wiki/Publishing-automation.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent