From 1606d94c77b54f5c243e079e9ebb4b43f5c469bb Mon Sep 17 00:00:00 2001
From: coloursofnoise <coloursofthenoise@gmail.com>
Date: Wed, 20 Jul 2022 00:15:54 -0700
Subject: [PATCH 1/2] Add maxdepth option to limit nesting

---
 sphinx_click/ext.py | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/sphinx_click/ext.py b/sphinx_click/ext.py
index 4a35d3a..5ebb880 100644
--- a/sphinx_click/ext.py
+++ b/sphinx_click/ext.py
@@ -385,6 +385,7 @@ class ClickDirective(rst.Directive):
     option_spec = {
         'prog': directives.unchanged_required,
         'nested': nested,
+        'maxdepth': directives.unchanged_required,
         'commands': directives.unchanged,
         'show-nested': directives.flag,
     }
@@ -432,8 +433,10 @@ def _generate_nodes(
         command: click.Command,
         parent: ty.Optional[click.Context],
         nested: str,
+        maxdepth: int,
         commands: ty.Optional[ty.List[str]] = None,
         semantic_group: bool = False,
+        current_depth: int = 0
     ) -> ty.List[nodes.section]:
         """Generate the relevant Sphinx nodes.
 
@@ -443,6 +446,7 @@ def _generate_nodes(
         :param command: Instance of `click.Group` or `click.Command`
         :param parent: Instance of `click.Context`, or None
         :param nested: The granularity of subcommand details.
+        :param maxdepth: The maximum depth of recursive subcommands to display.
         :param commands: Display only listed commands or skip the section if
             empty
         :param semantic_group: Display command as title and description for
@@ -480,7 +484,7 @@ def _generate_nodes(
 
         # Subcommands
 
-        if nested == NESTED_FULL:
+        if (maxdepth < 1 or current_depth < maxdepth) and nested == NESTED_FULL:
             if isinstance(command, click.CommandCollection):
                 for source in command.sources:
                     section.extend(
@@ -489,7 +493,9 @@ def _generate_nodes(
                             source,
                             parent=ctx,
                             nested=nested,
+                            maxdepth=maxdepth,
                             semantic_group=True,
+                            current_depth=current_depth + 1
                         )
                     )
             else:
@@ -498,7 +504,7 @@ def _generate_nodes(
                     parent = ctx if not semantic_group else ctx.parent
                     section.extend(
                         self._generate_nodes(
-                            command.name, command, parent=parent, nested=nested
+                            command.name, command, parent=parent, nested=nested, maxdepth=maxdepth, current_depth=current_depth + 1
                         )
                     )
 
@@ -515,6 +521,7 @@ def run(self) -> ty.Iterable[nodes.section]:
         prog_name = self.options.get('prog')
         show_nested = 'show-nested' in self.options
         nested = self.options.get('nested')
+        maxdepth = int(self.options.get('maxdepth') or 0)
 
         if show_nested:
             if nested:
@@ -534,7 +541,7 @@ def run(self) -> ty.Iterable[nodes.section]:
                 command.strip() for command in self.options.get('commands').split(',')
             ]
 
-        return self._generate_nodes(prog_name, command, None, nested, commands)
+        return self._generate_nodes(prog_name, command, None, nested, maxdepth, commands)
 
 
 def setup(app: application.Sphinx) -> ty.Dict[str, ty.Any]:

From 6be35d31dde1a638aa33bb7fef5549d14f968658 Mon Sep 17 00:00:00 2001
From: coloursofnoise <coloursofthenoise@gmail.com>
Date: Wed, 20 Jul 2022 16:19:50 -0700
Subject: [PATCH 2/2] Auto-format code

---
 sphinx_click/ext.py | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/sphinx_click/ext.py b/sphinx_click/ext.py
index 5ebb880..0a948db 100644
--- a/sphinx_click/ext.py
+++ b/sphinx_click/ext.py
@@ -436,7 +436,7 @@ def _generate_nodes(
         maxdepth: int,
         commands: ty.Optional[ty.List[str]] = None,
         semantic_group: bool = False,
-        current_depth: int = 0
+        current_depth: int = 0,
     ) -> ty.List[nodes.section]:
         """Generate the relevant Sphinx nodes.
 
@@ -495,7 +495,7 @@ def _generate_nodes(
                             nested=nested,
                             maxdepth=maxdepth,
                             semantic_group=True,
-                            current_depth=current_depth + 1
+                            current_depth=current_depth + 1,
                         )
                     )
             else:
@@ -504,7 +504,12 @@ def _generate_nodes(
                     parent = ctx if not semantic_group else ctx.parent
                     section.extend(
                         self._generate_nodes(
-                            command.name, command, parent=parent, nested=nested, maxdepth=maxdepth, current_depth=current_depth + 1
+                            command.name,
+                            command,
+                            parent=parent,
+                            nested=nested,
+                            maxdepth=maxdepth,
+                            current_depth=current_depth + 1,
                         )
                     )
 
@@ -541,7 +546,9 @@ def run(self) -> ty.Iterable[nodes.section]:
                 command.strip() for command in self.options.get('commands').split(',')
             ]
 
-        return self._generate_nodes(prog_name, command, None, nested, maxdepth, commands)
+        return self._generate_nodes(
+            prog_name, command, None, nested, maxdepth, commands
+        )
 
 
 def setup(app: application.Sphinx) -> ty.Dict[str, ty.Any]: