From 0434f3071a6a34cb911307a14e976e30da4bf7f7 Mon Sep 17 00:00:00 2001
From: Kirill Radzikhovskyy <kirillrdy@gmail.com>
Date: Thu, 1 Jan 2026 07:20:47 +1100
Subject: [PATCH] python3Packages.sphinx-autodoc2: fix build with astroid 4

---
 .../python-modules/sphinx-autodoc2/default.nix       | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/pkgs/development/python-modules/sphinx-autodoc2/default.nix b/pkgs/development/python-modules/sphinx-autodoc2/default.nix
index d50c265dab7c..edcddd2b3462 100644
--- a/pkgs/development/python-modules/sphinx-autodoc2/default.nix
+++ b/pkgs/development/python-modules/sphinx-autodoc2/default.nix
@@ -2,6 +2,7 @@
   lib,
   buildPythonPackage,
   fetchFromGitHub,
+  fetchDebianPatch,
   pythonOlder,
 
   flit-core,
@@ -30,6 +31,17 @@ buildPythonPackage rec {
     hash = "sha256-Wu079THK1mHVilD2Fx9dIzuIOOYOXpo/EMxVczNutCI=";
   };
 
+  patches = [
+    # compatibility with astroid 4, see: https://github.com/sphinx-extensions2/sphinx-autodoc2/pull/93
+    (fetchDebianPatch {
+      pname = "python-sphinx-autodoc2";
+      inherit version;
+      debianRevision = "9";
+      patch = "astroid-4.patch";
+      hash = "sha256-tRWDee30GSQ+AobCAHdtw65B6YyRpzn7kW5rzK7/QOk=";
+    })
+  ];
+
   build-system = [ flit-core ];
 
   dependencies = [