dream2nix/README.md
DavHau ea3d1a2ac1 simplify example flake.nix
fixes a bug where a source tree input was interpreted as a laoded dream-lock
2022-02-09 15:13:49 +07:00

2.5 KiB

[WIP] dream2nix - A generic framework for 2nix tools

For an example of dream2nix being used in practice, see dreampkgs.


dream2nix is a generic framework for 2nix converters (converting from other build systems to nix). It focuses on the following aspects:

  • Modularity
  • Customizability
  • Maintainability
  • Nixpkgs Compatibility (not enforcing IFD)
  • Code de-duplication across 2nix converters
  • Code de-duplication in nixpkgs
  • Risk free opt-in FOD fetching (no reproducibility issues)
  • Common UI across 2nix converters
  • Reduce effort to develop new 2nix solutions
  • Exploration and adoption of new nix features
  • Simplified updating of packages

The goal of this project is to create a standardized, generic, modular framework for 2nix solutions, aiming for better flexibility, maintainability and usability.

The intention is to integrate many existing 2nix converters into this framework, thereby improving many of the previously named aspects and providing a unified UI for all 2nix solutions.

Test the experimental version of dream2nix

There are different ways how dream2nix can be invoked (CLI, flake, In-tree, IFD). A simple way to try out dream2nix is to check out the repository of the software to package and drop this flake.nix inside it:

{
  inputs.dream2nix.url = "github:nix-community/dream2nix";
  outputs = { self, dream2nix }@inputs:
    let
      dream2nix = inputs.dream2nix.lib.init {
        # either just specify systems
        systems = [ "x86_64-linux" ];
        # ...or alternatively specify your own nixpkgs
        # pkgs = ...;
      };
    in dream2nix.riseAndShine {
      source = ./.;
    };
}

After adding the flake.nix, execute the following commands to list the packages which can be built:

git add ./flake.nix
nix flake show

Watch the recent presentation

dream2nix - A generic framework for 2nix tools

Further Reading