flake/dev: add a convenient devshell

flake-modules/default.nix

@@ -1,6 +1,6 @@
 {inputs, ...}: {
   imports = [
-    ./dev.nix
+    ./dev
     ./helpers.nix
     ./lib.nix
     ./legacy-packages.nix

flake-modules/dev.nix → flake-modules/dev/default.nix

@@ -1,17 +1,10 @@
 {inputs, ...}: {
   imports = [
     inputs.pre-commit-hooks.flakeModule
+    ./devshell.nix
   ];
 
-  perSystem = {
-    pkgs,
-    config,
-    ...
-  }: {
-    devShells.default = pkgs.mkShellNoCC {
-      shellHook = config.pre-commit.installationScript;
-    };
-
+  perSystem = {pkgs, ...}: {
     formatter = pkgs.alejandra;
 
     pre-commit = {

flake-modules/dev/devshell.nix

@@ -0,0 +1,66 @@
+{inputs, ...}: {
+  imports = [
+    inputs.devshell.flakeModule
+  ];
+
+  perSystem = {
+    pkgs,
+    config,
+    system,
+    ...
+  }: {
+    devshells.default = {
+      devshell.startup.pre-commit.text = config.pre-commit.installationScript;
+
+      commands = let
+        # Thanks to this, the user can choose to use `nix-output-monitor` (`nom`) instead of plain `nix`
+        nix = "$([ '$\{NIXVIM_NOM:-0}' = '1' ] && echo ${pkgs.lib.getExe pkgs.nom} || echo nix)";
+      in [
+        {
+          name = "checks";
+          help = "Run all nixvim checks";
+          command = "nix flake check";
+        }
+        {
+          name = "tests";
+          help = "Run nixvim tests";
+          command = ''
+            echo "=> Running nixvim tests for the '${system}' architecture..."
+
+            ${nix} build .#checks.${system}.tests
+          '';
+        }
+        {
+          name = "format";
+          help = "Format the entire codebase";
+          command = "nix fmt";
+        }
+        {
+          name = "docs";
+          help = "Build nixvim documentation";
+          command = ''
+            echo "=> Building nixvim documentation..."
+
+            ${nix} build .#docs
+          '';
+        }
+        {
+          name = "serve-docs";
+          help = "Build and serve documentation locally";
+          command = ''
+            echo -e "=> Building nixvim documentation...\n"
+
+            doc_derivation=$(${nix} build .#docs --no-link --print-out-paths)
+
+            echo -e "\n=> Documentation succesfully built ('$doc_derivation')"
+
+            port=8000
+            echo -e "\n=> Now open your browser and navigate to 'localhost:$port'\n"
+
+            ${pkgs.lib.getExe pkgs.python3} -m http.server -d "$doc_derivation"/share/doc
+          '';
+        }
+      ];
+    };
+  };
+}

flake.nix

@@ -16,6 +16,10 @@
       url = "github:hercules-ci/flake-parts";
       inputs.nixpkgs-lib.follows = "nixpkgs";
     };
+    devshell = {
+      url = "github:numtide/devshell";
+      inputs.nixpkgs.follows = "nixpkgs";
+    };
 
     flake-compat.url = "https://flakehub.com/f/edolstra/flake-compat/1.tar.gz";