fix: applying @RobPasMue's suggestions

Author: clatapie

src/pyconverter/xml2py/ast_tree.py

@@ -2689,14 +2689,6 @@ def __init__(
         if "VAL1" in self._initial_arguments:
             print(self._initial_arguments)
 
-    # def fix_initial_arguments(self, initial_arguments: List) -> None:
-    #     """Fix the initial arguments."""
-    #     # All arguments are present, need to add the missing ones
-    #     _, start_iter = get_iter_values(ellipsis_args[0])
-    #     _, end_iter = get_iter_values(ellipsis_args[-1])
-    #     for i in range(start_iter, end_iter + 1):
-    #         complete_args.append(f"{name_without_iter}{i}")
-
     @property
     def py_arg_name(self) -> str:
         """Python-compatible term."""

src/pyconverter/xml2py/custom_functions.py

@@ -40,18 +40,16 @@ def get_docstring_lists(
 
     Returns
     -------
-    List[str]
-        List containing the docstring ``Parameters`` section.
-    List[str]
-        List containing the docstring ``Returns`` section.
-    List[str]
-        List containing the docstring ``Notes`` section.
-    List[str]
-        List containing the docstring ``Examples`` section.
-    List[str]
-        List containing the source code.
-    List[str]
-        List containing the library import section.
+    Tuple[List[str], List[str], List[str], List[str], List[str], List[str], List[str]]
+        Tuple containing lists of strings for different sections of the Python file.
+        The order of the lists is as follows:
+        - Arguments list
+        - Parameters section
+        - Returns section
+        - Notes section
+        - Examples section
+        - Source code
+        - Library import section
     """
     lines = None
     with open(filename, "r", encoding="utf-8") as pyfile:

src/pyconverter/xml2py/writer.py

@@ -380,7 +380,7 @@ def write_source(
     structured: bool = True,
     check_structure_map: bool = False,
     check_files: bool = True,
-) -> dict | None:
+) -> dict:
     """Write out XML commands as Python source files.
 
     Parameters