From 0778c9581dd6b9b794db57ffccb69dc0a8748db9 Mon Sep 17 00:00:00 2001
From: Ethan Rooke <ethan@roo.ke>
Date: Mon, 13 Oct 2025 10:26:51 -0500
Subject: [PATCH] python3packages.mkdocs-gen-files: init at 0.5.0

---
 .../mkdocs-gen-files/default.nix              | 47 +++++++++++++++++++
 pkgs/top-level/python-packages.nix            |  2 +
 2 files changed, 49 insertions(+)
 create mode 100644 pkgs/development/python-modules/mkdocs-gen-files/default.nix

diff --git a/pkgs/development/python-modules/mkdocs-gen-files/default.nix b/pkgs/development/python-modules/mkdocs-gen-files/default.nix
new file mode 100644
index 000000000000..67fb28dadc4c
--- /dev/null
+++ b/pkgs/development/python-modules/mkdocs-gen-files/default.nix
@@ -0,0 +1,47 @@
+{
+  lib,
+  buildPythonPackage,
+  fetchFromGitHub,
+  hatchling,
+  mkdocs,
+  pytestCheckHook,
+  pytest-golden,
+}:
+
+buildPythonPackage rec {
+  pname = "mkdocs-gen-files";
+  version = "0.5.0";
+  pyproject = true;
+
+  src = fetchFromGitHub {
+    owner = "oprypin";
+    repo = "mkdocs-gen-files";
+    tag = "v${version}";
+    hash = "sha256-nRRdY7/en42s4PmHH+9vccRIl4pIp1F/Ka1bYvSHpBw=";
+  };
+
+  build-system = [
+    hatchling
+  ];
+
+  dependencies = [
+    mkdocs
+  ];
+
+  nativeCheckInputs = [
+    pytestCheckHook
+    pytest-golden
+  ];
+
+  pythonImportsCheck = [
+    "mkdocs_gen_files"
+  ];
+
+  meta = {
+    description = "MkDocs plugin to programmatically generate documentation pages during the build";
+    homepage = "https://oprypin.github.io/mkdocs-gen-files/";
+    changelog = "https://github.com/oprypin/mkdocs-gen-files/releases/tag/${src.tag}";
+    license = lib.licenses.mit;
+    maintainers = with lib.maintainers; [ erooke ];
+  };
+}
diff --git a/pkgs/top-level/python-packages.nix b/pkgs/top-level/python-packages.nix
index beb96bbe5f4f..a980ac092e71 100644
--- a/pkgs/top-level/python-packages.nix
+++ b/pkgs/top-level/python-packages.nix
@@ -9471,6 +9471,8 @@ self: super: with self; {
 
   mkdocs-exclude = callPackage ../development/python-modules/mkdocs-exclude { };
 
+  mkdocs-gen-files = callPackage ../development/python-modules/mkdocs-gen-files { };
+
   mkdocs-get-deps = callPackage ../development/python-modules/mkdocs-get-deps { };
 
   mkdocs-git-authors-plugin = callPackage ../development/python-modules/mkdocs-git-authors-plugin { };