Skip to content

Latest commit

 

History

History
47 lines (26 loc) · 2.01 KB

README.md

File metadata and controls

47 lines (26 loc) · 2.01 KB
Raw

mission-control

A flake-parts module for your Nix devshell scripts

Usage

To try out mission-control using the example template, start from one of the following ways:

  • Run nix flake init -t github:Platonic-Systems/mission-control to create a template flake.nix file. Run nix develop on it.
  • Or, clone this repo and checkout the example. On this directory, run nix develop --override-input mission-control path:../.1 (or simply direnv allow if you already use direnv) to drop into the Nix shell

The example configures the scripts in Nix as follows:

https://github.com/Platonic-Systems/mission-control/blob/7beb3a8d1acf63e9e1cfb0fb07104d3b57eeb2b4/example/flake.nix#L14-L27

Which produces a banner in the devshell like below:

### ️🔨 Welcome to the Nix devshell ###

Available commands:

## Commands

  , hello    : Say Hello
  , ponysay  : Cowsay reimplemention for ponies

## Tools

  , fmt  : Format the Nix files

(Run ',' to display this menu again)

Once you are in the dev shell, you can run any of these scripts prefixed with the wrapper name ,. For example, , fmt to format the Nix files.

The scripts will be run always from the project root directory2 regardless of the current working directory.

Examples

These repositories use mission-control to provide development shell workflow scripts:

Footnotes

  1. The --override-input option is to be used when running from this repository to make sure that we are using the local version of mission-control. If you are copying this flake.nix to your project (without also copying the outdated flake.lock), you can simply run nix develop. ↩

  2. "Project root directory" is determined by traversing the directory up until we find the unique file that exists only at the root. This unique file is flake.nix by default, which can be overridden using the flake-root module; i.e.; flake-root.projectRootFile = "stack.yaml"; ↩