fix: union and multiple lines in CustomFunctioins + fix links in py_term

Author: clatapie

src/pyconverter/xml2py/ast_tree.py

@@ -1383,6 +1383,9 @@ def to_rst(self, indent="", max_length=100, links=None, base_url=None, fcache=No
 
         if "``" in py_term:
             py_term = py_term.replace("``", "")
+        
+        if re.finditer(r"`.+`_", py_term) is None:
+            py_term = f"``{py_term}``"
 
         intersection_types = set(NO_RESIZE_LIST).intersection(self.text.children_types)
         if len(intersection_types) == 0 and "* " not in py_text:
@@ -1401,7 +1404,7 @@ def to_rst(self, indent="", max_length=100, links=None, base_url=None, fcache=No
 
             py_text = f"{first_line}\n{rest_lines}"
 
-        lines = [f"* ``{py_term}`` - {py_text}"]
+        lines = [f"* {py_term} - {py_text}"]
         output = "\n".join(lines)
 
         return output

src/pyconverter/xml2py/custom_functions.py

@@ -74,9 +74,16 @@ def get_docstring_lists(filename: str) -> Tuple[list[str], list[str], list[str],
         if bool_def and not end_def:
             if ")" in line:
                 end_def = True
+                line = re.search(r".+(?=\))", line)
+                if line is not None:
+                    line = line.group()
+                else:
+                    continue
             # TODO: Union types are ignored for now
             if re.search(r"\[(\w+, )+\w+\]", line) is not None:
                 line = re.sub(r"\[(\w+, )+\w+\]", "", line)
+            elif re.search(r'\[("\w*", )+"\w*"\]', line):
+                line = re.sub(r'\[("\w*", )+"\w*"\]', "", line)
             split_def = line.split(",")
             for split_arg in split_def:
                 split_arg = split_arg.strip()

tests/customized_functions/cmlist.py

@@ -0,0 +1,60 @@
+from typing import Any, Dict, Literal
+
+def cmlist(
+    self,
+    name: str = "",
+    key: str = "",
+    entity: Literal["VOLU", "AREA", "LINE", "KP", "ELEM", "NODE", ""] = "",
+    **kwargs: Dict[Any, Any],
+) -> None:
+    """Lists the contents of a component or assembly.
+
+    APDL Command: CMLIST
+
+    Parameters
+    ----------
+    name
+        Name of the component or assembly to be listed (if blank, list all
+        selected components and assemblies). If Name is specified, then
+        Entity  is ignored.
+
+    key
+        Expansion key:
+
+        0
+            Do not list individual entities in the component.
+
+        1 or EXPA
+            List individual entities in the component.
+
+    entity
+        If Name is blank, then the following entity types can be specified:
+
+        VOLU
+            List the volume components only.
+
+        AREA
+            List the area components only.
+
+        LINE
+            List the line components only.
+
+        KP
+            List the keypoint components only
+
+        ELEM
+            List the element components only.
+
+        NODE
+            List the node components only.
+
+    Notes
+    -----
+    This command is valid in any processor.  For components, it lists the
+    type of geometric entity. For assemblies, it lists the components
+    and/or assemblies that make up the assembly.
+
+    Examples of possible usage:
+    """
+    command = f"CMLIST,{name},{key},{entity}"
+    return self.run(command, **kwargs)