No description
Find a file Use this template
2024-01-20 13:42:35 +05:30
.github/workflows ci: don't use latest nix 2024-01-20 13:39:53 +05:30
.vscode use direnv 2024-01-20 13:39:43 +05:30
src Fix typo: green -> greet 2024-01-05 13:47:27 -05:00
.envrc Add .envrc (for direnv) 2022-05-04 11:45:44 -04:00
.gitattributes git: Mark flake.lock as generated 2022-05-08 17:04:18 -04:00
.gitignore Add .envrc (for direnv) 2022-05-04 11:45:44 -04:00
Cargo.lock Bump rustix from 0.38.4 to 0.38.20 2023-10-25 14:48:39 -04:00
Cargo.toml Switch to clap, to demonstrate non-rust deps 2023-07-23 10:07:10 -04:00
flake.lock nix: Update nixpkgs, matching haskell-template 2024-01-20 13:42:35 +05:30
flake.nix feat: merge rust pkgs into rust-toolchain (#28) 2023-11-09 17:49:00 -05:00
Jenkinsfile Add Jenkinsfile 2023-07-23 10:00:06 -04:00
justfile mission-control -> just 2023-07-23 10:10:10 -04:00
LICENSE Add license; resolves #12 2023-06-26 15:27:21 -04:00
README.md use direnv 2024-01-20 13:39:43 +05:30

A template Rust project with fully functional and no-frills Nix support, as well as builtin VSCode configuration to get IDE experience without any manual setup (just install direnv, open in VSCode and accept the suggestions).

Note

If you are looking for the original template based on this blog post's use of crate2nix, browse from this tag. The evolution of this template can be gleaned from releases.

Adapting this template

  • Run nix develop to have a working shell ready before name change.
  • Change name in Cargo.toml.
  • Run cargo generate-lockfile in the nix shell
  • There are two CI workflows, and one of them uses Nix which is slower (unless you configure a cache) than the other that is based on rustup. Pick one or the other depending on your trade-offs.

Development (Flakes)

This repo uses Flakes from the get-go.

# Dev shell
nix develop

# or run via cargo
nix develop -c cargo run

# build
nix build

We also provide a justfile for Makefile'esque commands.

See Also