nix-cargo-integration
A flake-parts module that integrates Cargo projects with Nix using dream2nix for building and development shells.
What is nix-cargo-integration?
nix-cargo-integration is a Nix library that simplifies integrating Cargo-based Rust projects with the Nix package manager and build system. It uses dream2nix to handle building Rust packages and setting up development shells, solving the problem of managing Rust dependencies and environments reproducibly within Nix.
Rust developers and Nix users who want to integrate Cargo projects into Nix workflows for reproducible builds, dependency management, and development environments.
Developers choose nix-cargo-integration because it provides a streamlined, opinionated setup with sensible defaults, reducing the complexity of combining Cargo and Nix while leveraging dream2nix for reliable builds and shells.
Overview
Library to easily and effortlessly integrate Cargo projects with Nix.
Use Cases
Best For
- Integrating existing Cargo projects into Nix flake-based workflows
- Setting up reproducible development shells for Rust workspaces
- Managing Rust dependencies with Nix for consistent builds
- Automating Cargo.lock handling in Nix evaluations
- Using dream2nix to build Rust packages in Nix
- Adding Rust projects to flake-parts configurations
Not Ideal For
- Projects not using or planning to adopt Nix flakes, as it's tightly integrated with flake-parts
- Simple, single-crate Rust applications where the overhead of Nix integration isn't justified
- Teams that rely heavily on Cargo's native tooling and prefer minimal ecosystem changes
- Environments where Cargo.lock is intentionally git-ignored and manual handling is preferred
Pros & Cons
Pros
Leverages dream2nix to reliably build Rust packages and set up development shells, ensuring reproducible builds within Nix without manual configuration.
Integrates seamlessly as a flake-parts module, allowing easy addition to existing Nix configurations that use flake-parts, as shown in the installation examples.
Comes with pre-configured settings aimed at compatibility with standard Cargo workflows, reducing the need for extensive manual setup.
Provides tools to generate and handle Cargo.lock files, addressing common evaluation issues in Nix, as detailed in the tips section for git-ignored lockfiles.
Cons
Requires adoption of Nix flakes and flake-parts, which may be a barrier for teams using traditional Nix or other build systems.
The CHANGELOG.md documents important, mostly breaking changes, indicating potential instability and migration efforts for users.
For basic Rust projects, the integration adds layers of Nix configuration that might outweigh the benefits of using Cargo alone.
Frequently Asked Questions
Related Projects
rust-overlayPure and reproducible nix overlay of binary distributed rust toolchains
craneA Nix library for building cargo projects. Never build twice thanks to incremental artifact caching.
fenixRust toolchains and rust-analyzer nightly for Nix [maintainers=@figsoda, @eureka-cpu]
naerskBuild Rust projects in Nix - no configuration, no code generation, no IFD, sandbox friendly.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.