feat: use docstrings from doc/fragments/*

Author: ntamas

doc/fragments/igraph_empty.txt

@@ -0,0 +1,5 @@
+Creates an empty graph with the given number of vertices.
+
+Parameters:
+    n: the number of vertices
+    directed: whether the graph is directed

doc/fragments/igraph_famous.txt

@@ -0,0 +1,10 @@
+Creates one of the "famous" graphs embedded into igraph by name.
+
+See the documentation of the ``igraph_famous()`` function in igraph's C core
+for a list of names accepted by this function.
+
+Parameters:
+    name: the name of the graph to construct
+
+Returns:
+    the constructed graph

poetry.lock

@@ -16,8 +16,8 @@ pycapi = "^0.82.1"
 pytest = "^7.2.1"
 pytest-cov = "^4.0.0"
 richbench = "^1.0.3"
-igraph = "^0.10.4"
-stimulus = { git = "https://github.com/igraph/stimulus.git", tag = "0.13.0" }
+igraph = "^0.10.6"
+stimulus = { git = "https://github.com/igraph/stimulus.git", tag = "0.14.0" }
 
 [tool.ruff]
 ignore = ["F405"]

pyproject.toml

@@ -276,6 +276,8 @@ def main():
         str(SOURCE_FOLDER / "codegen" / "functions.yaml"),
         "-t",
         str(SOURCE_FOLDER / "codegen" / "types.yaml"),
+        "-D",
+        str(SOURCE_FOLDER.parent / "doc" / "fragments"),
     ]
 
     args = [

src/codegen/run.py

@@ -37,7 +37,12 @@
 
 
 def empty(n: int = 0, directed: bool = True) -> Graph:
-    """Type-annotated wrapper for ``igraph_empty``."""
+    """Creates an empty graph with the given number of vertices.
+
+    Parameters:
+        n: the number of vertices
+        directed: whether the graph is directed
+    """
     # Prepare input arguments
     c_graph = _Graph()
     c_n = n
@@ -687,7 +692,17 @@ def kautz(m: int, n: int) -> Graph:
 
 
 def famous(name: str) -> Graph:
-    """Type-annotated wrapper for ``igraph_famous``."""
+    """Creates one of the "famous" graphs embedded into igraph by name.
+
+    See the documentation of the ``igraph_famous()`` function in igraph's C core
+    for a list of names accepted by this function.
+
+    Parameters:
+        name: the name of the graph to construct
+
+    Returns:
+        the constructed graph
+    """
     # Prepare input arguments
     c_graph = _Graph()
     c_name = name.encode("utf-8")