feat(doc): add directory listings to py modules (#2658)

Author: SamWilsn

pyproject.toml

@@ -225,7 +225,7 @@ actionlint = [
     "shellcheck-py>=0.10",
 ]
 doc = [
-    "docc>=0.4.0,<0.5.0",
+    "docc>=0.5.0,<0.6.0",
     "fladrif>=0.2.0,<0.3.0",
     "mistletoe>=1.5.0,<2",
 ]
@@ -302,6 +302,7 @@ omit = [
 
 [tool.docc]
 context = [
+    "docc.listing.context",
     "docc.references.context",
     "docc.search.context",
     "docc.html.context",
@@ -322,6 +323,7 @@ build = [
     "docc.resources.build",
 ]
 transform = [
+    "docc.listing.transform",
     "docc.python.transform",
     "docc.verbatim.transform",
     "docc.mistletoe.transform",

src/ethereum_spec_tools/docc.py

@@ -45,7 +45,7 @@
 from docc.discover import Discover, T
 from docc.document import BlankNode, Document, ListNode, Node, Visit, Visitor
 from docc.plugins import html, mistletoe, python, verbatim
-from docc.plugins.listing import Listable
+from docc.plugins.listing import Listable, ListingNode
 from docc.plugins.python import PythonBuilder
 from docc.plugins.references import Definition, Reference
 from docc.settings import PluginSettings
@@ -667,6 +667,10 @@ def shallow_equals(self, lhs: Node, rhs: Node) -> bool:
             assert isinstance(rhs, ListNode)
             return True
 
+        elif isinstance(lhs, ListingNode):
+            assert isinstance(rhs, ListingNode)
+            return True
+
         elif isinstance(lhs, verbatim.Transcribed):
             assert isinstance(rhs, verbatim.Transcribed)
             return True
@@ -750,6 +754,9 @@ def shallow_hash(self, node: Node) -> int:
         elif isinstance(node, ListNode):
             return hash(type(ListNode))
 
+        elif isinstance(node, ListingNode):
+            return hash(type(ListingNode))
+
         elif isinstance(node, verbatim.Transcribed):
             return hash(type(verbatim.Transcribed))