n25/pages/plugins-slide.md

48 lines
No EOL
857 B
Markdown

---
level: 2
---
# RunCommand plugins
Plugins are any script or executable that print output and exit with a system code of 0 (OK) or greater (error).
````md magic-move {lines: true}
```bash
#!/usr/bin/env bash
echo "HI THERE..."
exit 0
```
```bash
#!/usr/bin/env bash
# do some work...
sleep 10
echo "call the president..."
exit 1
```
````
<!--
RunCommand plugins are scripts or executables that do two things
1. print some output that can be seen and logged
2. exit with a system code
The example is of a bash script but it could be any scripting language that can do the same.
It could be a compiled program, so long as it also outputs logging information to the terminal and exits with a system code of [0|1 or greater]
Long running scripts or commands are expected
exiting with 1 or greater will signify a failure of some kind
-->