nix.dev/default.nix

{
  inputs ? import ./nix/sources.nix,
  system ? builtins.currentSystem,
}:
let
  pkgs = import inputs.nixpkgs {
    config = { };
    overlays = [ (import ./overlay.nix) ];
    inherit system;
  };

  nix-dev = pkgs.stdenv.mkDerivation {
    name = "nix-dev";
    src = ./.;
    nativeBuildInputs = with pkgs.python310.pkgs; [
      linkify-it-py
      myst-parser
      sphinx
      sphinx-book-theme
      sphinx-copybutton
      sphinx-design
      sphinx-notfound-page
      sphinx-sitemap
    ];
    buildPhase = ''
      make html
    '';
    installPhase =
      let
        # Various versions of the Nix manuals, grep for (nix-manual)=
        # FIXME: This requires human interaction to update!
        # See ./CONTRIBUTING.md for details.
        releases = [
          "2.19"
          "2.18"
          "2.13"
        ];
        inputName = version: pkgs.lib.strings.replaceStrings [ "." ] [ "-" ] version;
        src = version: (import inputs."nix_${inputName version}").default.doc;
        copy = version: ''
          cp -R ${src version}/share/doc/nix/manual/* $out/manual/nix/${version}
        '';
      in
      with pkgs.lib.strings;
      ''
        mkdir -p $out/manual/nix/{${concatStringsSep "," releases}}
        ${concatStringsSep "\n" (map copy releases)}
        cp -R build/html/* $out/
      '';
  };

  devmode =
    let
      pythonEnvironment = pkgs.python310.withPackages (ps: with ps; [
        livereload
      ]);
      script = ''
        from livereload import Server, shell

        server = Server()

        build_docs = shell("make html")

        print("Doing an initial build of the docs...")
        build_docs()

        server.watch("source/*", build_docs)
        server.watch("source/**/*", build_docs)
        server.watch("_templates/*.html", build_docs)
        server.serve(root="build/html")
      '';
    in
    pkgs.writeShellApplication {
      name = "devmode";
      runtimeInputs = [ pythonEnvironment ];
      text = ''
        python ${pkgs.writeText "live.py" script}
      '';
    };
in
{
  # build with `nix-build -A build`
  build = nix-dev;

  shell = pkgs.mkShell {
    inputsFrom = [ nix-dev ];
    packages = [
      devmode
      pkgs.niv
      pkgs.python310.pkgs.black
      pkgs.vale
    ];
  };
}