fix: custom_notes for cmlist

Author: clatapie

src/pyconverter/xml2py/ast_tree.py

@@ -90,6 +90,7 @@
 NO_RESIZE_LIST = [
     "Variablelist",
     "ItemizedList",
+    "SimpleList"
     "Caution",
     "XMLWarning",
     "ProgramListing",
@@ -2395,15 +2396,10 @@ def to_rst(self, indent="", max_length=100, links=None, base_url=None, fcache=No
             items.append(entry_item)
 
         entry_content = " ".join(items)
-        # entry_content = resize_length(
-        #     entry_content, max_length=max_length, initial_indent=indent, subsequent_indent=" " * 2
-        # )
 
         if self.morerows is not None:
             entry_content = f":rspan:`{content}` " + entry_content
 
-            print(entry_content)
-        # to be checked - not working
         return entry_content
 
 
@@ -3125,13 +3121,13 @@ def py_signature(self, custom_functions: CustomFunctions, indent="") -> str:
         arg_sig = ", ".join(args)
         return f"{indent}def {self.py_name}({arg_sig}, **kwargs):"
 
-    def custom_notes(self, custom_functions: CustomFunctions = None):
+    def custom_notes(self, custom_functions: CustomFunctions = None, automated_notes: List[str]= None) -> List[str]:
         """Customized notes for the command."""
         lines = []
         if custom_functions is not None and (
             self.py_name in custom_functions.py_names and self.py_name in custom_functions.py_notes
         ):
-            if len("\n".join(lines)) < len("\n".join(custom_functions.py_notes[self.py_name])):
+            if len("\n".join(automated_notes)) < len("\n".join(custom_functions.py_notes[self.py_name])):
                 lines = custom_functions.py_notes[self.py_name]
         return lines
 
@@ -3180,14 +3176,15 @@ def py_docstring(
             and self.py_name in custom_functions.py_returns
         ):
             items += [""] + custom_functions.py_returns[self.py_name]
-        custom_notes = self.custom_notes(custom_functions)
+        automated_notes = self.py_notes(self.notes, "Notes")
+        custom_notes = self.custom_notes(custom_functions, automated_notes)
         if not custom_notes:
             if self.other_parameters:
                 items += [""]
                 items.extend(self.py_notes(self.other_parameters, "Other Parameters"))
             if self.notes:
                 items += [""]
-                items.extend(self.py_notes(self.notes, "Notes"))
+                items.extend(automated_notes)
         else:
             items.extend(custom_notes)
         if custom_functions and (
@@ -3400,7 +3397,7 @@ def py_notes(self, note_elem_list, section_title):
                 resized_item = resize_length(item, self._max_length)
                 notes = notes.replace(item, resized_item)
             lines.extend(notes.split("\n"))
-
+ 
         return lines
 
     @property

src/pyconverter/xml2py/custom_functions.py

@@ -38,8 +38,12 @@ def get_docstring_lists(filename: str) -> Tuple[list[str], list[str], list[str],
 
     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]