tools/nix: move nix flakes to tools/

This commit moves the flake.lock and flake.nix files from root and Documentation/ to the tools/ directory, according to @anchao's suggestion in PR #16763. Updates documentation to reflect this change. Signed-off-by: Côme VINCENT <44554692+comejv@users.noreply.github.com>
2026-05-28 03:45:50 +08:00 · 2025-08-27 11:52:07 -04:00
parent 585c25bac0
commit c36d067603
5 changed files with 9 additions and 6 deletions
@@ -0,0 +1,27 @@
+{
+  "nodes": {
+    "nixpkgs": {
+      "locked": {
+        "lastModified": 1754725699,
+        "narHash": "sha256-iAcj9T/Y+3DBy2J0N+yF9XQQQ8IEb5swLFzs23CdP88=",
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "85dbfc7aaf52ecb755f87e577ddbe6dbbdbc1054",
+        "type": "github"
+      },
+      "original": {
+        "owner": "NixOS",
+        "ref": "nixos-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "root": {
+      "inputs": {
+        "nixpkgs": "nixpkgs"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}
@@ -0,0 +1,80 @@
+{
+  description = "Sphinx documentation environment with sphinx-tags";
+
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+  };
+
+  outputs =
+    { self, nixpkgs }:
+    let
+      system = "x86_64-linux";
+      pkgs = import nixpkgs { inherit system; };
+
+      python = pkgs.python313;
+
+      sphinx-tags = python.pkgs.buildPythonPackage rec {
+        pname = "sphinx-tags";
+        version = "0.4";
+
+        src = pkgs.fetchPypi {
+          pname = "sphinx_tags";
+          inherit version;
+          sha256 = "MGUhm6z0dWfHBvIjfVZlsi86UWc2e0xFaLzaQ3GlNZ0=";
+        };
+
+        pyproject = true;
+        build-system = [ python.pkgs.flit-core ];
+
+        propagatedBuildInputs = with python.pkgs; [
+          sphinx
+        ];
+
+        doCheck = false;
+      };
+
+      sphinx-collapse = python.pkgs.buildPythonPackage rec {
+        pname = "sphinx_collapse";
+        version = "0.1.3";
+
+        src = pkgs.fetchPypi {
+          inherit version pname;
+          sha256 = "yuFB5vA+zVLtJGowWmnhsNXQXmzfP+gD1A1YOtatiVo=";
+        };
+
+        pyproject = true;
+        build-system = [ python.pkgs.flit-core ];
+
+        propagatedBuildInputs = with python.pkgs; [
+          sphinx
+        ];
+
+        doCheck = false;
+      };
+
+      nuttx-doc-py-env = python.withPackages (
+        ps: with ps; [
+          sphinx
+          sphinx_rtd_theme
+          myst-parser
+          sphinx-tabs
+          sphinx-autobuild
+          sphinx-copybutton
+          sphinx-togglebutton
+          pytz
+          importlib-metadata
+          sphinx-design
+          sphinx-tags
+          sphinx-collapse
+        ]
+      );
+    in
+    {
+      devShells.${system}.default = pkgs.mkShell {
+        buildInputs = [ nuttx-doc-py-env ];
+        shellHook = ''
+          echo "Welcome to NuttX documentation devShell"
+        '';
+      };
+    };
+}