Merge pull request #31 from tj/compose

doc: add compose example
tj · Aug 31, 2019 · cf8e644 · cf8e644
2 parents 308b6bb + 3df16c9
commit cf8e644
Show file tree

Hide file tree

Showing 2 changed files with 41 additions and 0 deletions.
diff --git a/Readme.md b/Readme.md
@@ -349,6 +349,33 @@ stage:
   ...
 ```
 
+## Composition
+
+  You can compose multiple commands into a single command
+  by utilizing robo's built-in `robo.file` variable:
+
+```yml
+one:
+  summary: echo one
+  command: echo one
+
+two:
+  summary: echo two
+  command: echo two
+
+all:
+  summary: echo one two
+  command: |
+    robo -c {{ .robo.file }} one
+    robo -c {{ .robo.file }} two
+```
+
+```
+$ robo all
+one
+two
+```
+
 ## Why?
 
  We generally use Makefiles for project specific tasks, however

diff --git a/_examples/compose/compose.yml b/_examples/compose/compose.yml
@@ -0,0 +1,14 @@
+
+one:
+  summary: echo one
+  command: echo one
+
+two:
+  summary: echo two
+  command: echo two
+
+all:
+  summary: echo one two
+  command: |
+    robo -c {{ .robo.file }} one
+    robo -c {{ .robo.file }} two