⚠️ WARNING: FlockRunner is currently in active development and not yet ready for production use. Expect frequent changes and potential instability. ⚠️
FlockRunner is a powerful and highly customizable command executor designed to streamline your project workflows. It operates based on a simple YAML configuration file, giving you complete control over how your commands are organized and executed.
Currently only nix is supported:
nix profile install github:Linbreux/FlockRunner
or (running it directly)
nix run github:Linbreux/FlockRunner
I wanted a straightforward method for managing and running tools tailored to individual projects. Despite the probable existence of numerous solutions, I decided to develop my own as a practical way to learn Rust.
You can place your flockrunner.yaml file right in your project's main folder. No matter where you're running FlockRunner from within your project's hierarchy, it'll automatically look for that configuration file by searching parent directories. The first one it finds on its way up is the one it'll use, ensuring you're always using the correct project configuration.
A project file should look like the example.
project: "FlockRunner"
variables:
greeting: "Hello from FlockRunner!"
user: "Flock user"
shells:
# A shell definition to run commands inside a Docker container
docker-shell: docker run {{os}} sh -c
# An alternative shell using zsh
zsh: zsh -c
commands:
hello:
cmd: echo hello {{user}}
alias: "h"
help: "Greets the current user."
time:
cmd: date
help: "Shows the current system date and time."
create:
help: "Creates a 'flock' directory and a 'test.txt' file within it."
cmd:
- echo "Creating folder..."
- mkdir flock
- "echo new textfile > flock/test.txt && echo Created textfile: flock/test.txt"
- echo "Done creating files, bye {{user}}!"
clean:
help: "Removes the 'flock' directory and its contents."
keep_going: true # Continues execution even if `rm` fails (e.g., directory doesn't exist)
cmd:
- rm -rf flock && echo "Removed 'flock' directory!" || echo "'flock' directory not found or could not be removed."
greet_date:
help: "Displays a greeting, the current date, and then exits with an error."
cmd: echo {{greeting}} && date && exit 1 # cmd will file because of exit code.
run_on_os:
help: "Runs a command inside a specified Docker container (defaulting to fedora)."
# Uses the 'docker-shell' defined above (shells)
shell: docker-shell
variables:
os: fedora # Overrides the project's 'os' variable for this command only
cmd:
- echo Running 'cat /etc/os-release' inside {{os}} container...
- cat /etc/os-release
- echo == Command executed within the {{os}} container ==
sequence:
.png)
4 months ago
12
