Skip to content

Latest commit

 

History

History
44 lines (28 loc) · 1.74 KB

README.md

File metadata and controls

44 lines (28 loc) · 1.74 KB
Raw

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). It uses crane, via rust-flake.

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.

Usage

You can use omnix1 to initialize this template:

nix --accept-flake-config run github:juspay/omnix -- init github:srid/rust-nix-template -o ~/my-rust-project

Adapting this template

  • There are two CI workflows, and one of them uses Nix which is slower (unless you configure a cache) than the other one 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 to be run inside of the devShell.

Discussion

See Also

Footnotes

  1. If initializing manually, make sure to:

    • Change name in Cargo.toml.
    • Run cargo generate-lockfile in the nix shelld
    ↩