Update: Add support for Literal types

Author: Andrej730

src/fake_bpy_module/transformer/data_type_refiner.py

@@ -85,6 +85,7 @@
 _REGEX_DATA_TYPE_OPTION_OPTIONAL = re.compile(r"(^|^An |\()[oO]ptional(\s|\))")
 _REGEX_DATA_TYPE_STARTS_WITH_COLLECTION = re.compile(r"^(list|tuple|dict)")
 _REGEX_DATA_TYPE_MODIFIER_TYPES = re.compile(r"^(Iterable|Sequence|Callable|list|dict|tuple|type)?\[(.+)\]$")  # noqa: E501
+_REGEX_DATA_TYPE_LITERALS_TYPE = re.compile(r"^Literal\[(.+)\]$")
 _REGEX_DATA_TYPE_START_AND_END_WITH_PARENTHESES = re.compile(r"^\((.+)\)$")
 
 REGEX_SPLIT_OR = re.compile(r" \| | or |,")
@@ -769,6 +770,11 @@ def parse_multiple_data_type_elements(
 
             return parse_multiple_data_type_elements(m.group(2), modifier)
 
+        if m := _REGEX_DATA_TYPE_LITERALS_TYPE.match(dtype_str):
+            new_dtype_node = DataTypeNode()
+            append_child(new_dtype_node, nodes.Text(f"typing.Literal[{m.group(1)}]"))
+            return [new_dtype_node]
+
         # Ex. string, default "", -> string
         if m := REGEX_MATCH_DATA_TYPE_WITH_DEFAULT.match(dtype_str):
             dtype_str = m.group(1)

tests/python/fake_bpy_module_test/fake_bpy_module_test/transformer_test_data/data_type_refiner_test/expect/special_data_type.xml

@@ -56,6 +56,13 @@
         <data-type-list>
             <data-type>
                 Callable[[float, int], tuple[float, int]]
+    <data>
+        <name>
+            data_python_typing_syntax_7
+        <description>
+        <data-type-list>
+            <data-type>
+                Literal["OPTION_1", "OPTION_2", "OPTION_3"]
     <data>
         <name>
             data_multiple_lines

tests/python/fake_bpy_module_test/fake_bpy_module_test/transformer_test_data/data_type_refiner_test/expect/special_data_type_transformed.xml

@@ -82,6 +82,13 @@
                 int
                 ]
                 ]
+    <data>
+        <name>
+            data_python_typing_syntax_7
+        <description>
+        <data-type-list>
+            <data-type option="never none">
+                typing.Literal["OPTION_1", "OPTION_2", "OPTION_3"]
     <data>
         <name>
             data_multiple_lines

tests/python/fake_bpy_module_test/fake_bpy_module_test/transformer_test_data/data_type_refiner_test/input/special_data_type.rst

@@ -24,6 +24,10 @@
 
    :type: Callable[[float, int], tuple[float, int]]
 
+.. data:: data_python_typing_syntax_7
+
+   :type: Literal["OPTION_1", "OPTION_2", "OPTION_3"]
+
 .. data:: data_multiple_lines
 
    :type: type[