Dog is a command line application that executes automated tasks. It works in a similar way as GNU Make but it is a more generic task runner, not a build tool. Dog's default script syntax is sh but most interpreted languages like BASH, Python, Ruby or Perl can also be used.
List all tasks in current project
dog
Execute a task
dog taskname
Execute a task, printing elapsed time and status code
dog -i taskname
Execute a task providing environment variables
dog taskname -e VAR_NAME_1=value -e VAR_NAME_2=value
Dogfile is a specification that uses YAML to describe the tasks related to a project. We think that the Spec will be finished (no further breaking changes) by the v1.0.0 version of Dog.
- Read Dog's own Dogfile.yml
- Read the Dogfile Spec
Tools that use Dogfiles are called dogtools. Dog is the first dogtool but there are other things that can implemented in the future: web and desktop UIs, chat bot interfaces, plugins for text editors and IDEs, tools to export Dogfiles to other formats, HTTP API interfaces, even implementations of the cli in other languages! To simplify the process of creating dogtools we are implementing parts of Dog as Go packages so they can be used in other projects (see parser, types and execute). Let us know if you have any uncovered need on any of these packages.
If you want to help, take a look at:
- Open bugs
- Lacking features for v0.2.0
- Lacking features for v0.3.0
- Our Code of Conduct
In case you are not interested in improving Dog but on building your own tool on top of the Dogfile Spec, please help us discussing it:
- Dogfile Spec open discussion