python 调整泛型使用 __n 为 _n (#2294)

* python 调整泛型使用 `__n` 为 `_n`

* 调整泛型使用方式用例

* 更新文档

* GenericTest

Author: realybin

doc/unity/en/tutorial/python2cs.md

@@ -1,4 +1,4 @@
-# Calling C# from Python
+# Calling C# from Python
 
 > 💡 PuerTS 3.0 also supports [JavaScript](./js2cs.md) and [Lua](./lua2cs.md) calling C#, each with different syntax. Click the links to see the corresponding tutorials.
 
@@ -181,7 +181,7 @@ void Start() {
     env.Eval(@"
 exec('''
 import System
-import System.Collections.Generic.List__T1 as List
+import System.Collections.Generic.List_1 as List
 
 # create generic type: List<int>
 ListInt = puerts.generic(List, System.Int32)
@@ -197,9 +197,9 @@ print(ls.Count)  # 3
 }
 ```
 
-> ⚠️ **Special naming for generic types**: In C#, generic type names use backticks to indicate the number of type parameters (e.g. `` List`1 ``). In Python's `import` syntax, backticks must be replaced with `__T` followed by the count:
-> - `` List`1 `` → `List__T1`
-> - `` Dictionary`2 `` → `Dictionary__T2`
+> ⚠️ **Special naming for generic types**: In C#, generic type names use backticks to indicate the number of type parameters (e.g. `` List`1 ``). In Python's `import` syntax, backticks must be replaced with `_` followed by the count:
+> - `` List`1 `` → `List_1`
+> - `` Dictionary`2 `` → `Dictionary_2`
 >
 > When using `puerts.load_type()`, you can use the original backtick format directly:
 > ```python
@@ -225,12 +225,12 @@ x = InnerClassA()
 print(x.Foo)  # Hello
 
 # access generic nested class
-InnerClassB_T1 = puerts.generic(TestNestedTypes.InnerClassB__T1, Int32)
-y = InnerClassB_T1()
+InnerClassB_1 = puerts.generic(TestNestedTypes.InnerClassB_1, Int32)
+y = InnerClassB_1()
 print(y.Bar)  # Hello
 
-InnerClassB_T2 = puerts.generic(TestNestedTypes.InnerClassB__T2, Int32, String)
-z = InnerClassB_T2()
+InnerClassB_2 = puerts.generic(TestNestedTypes.InnerClassB_2, Int32, String)
+z = InnerClassB_1()
 print(z.Bar)  # Hello
 ''')
 ");

doc/unity/zhcn/tutorial/python2cs.md

@@ -1,4 +1,4 @@
-# 在 Python 中调用 C#
+# 在 Python 中调用 C#
 
 > 💡 PuerTS 3.0 同时支持 [JavaScript](./js2cs.md) 和 [Lua](./lua2cs.md) 调用 C#，语法各有不同，可点击链接查看对应教程。
 
@@ -181,7 +181,7 @@ void Start() {
     env.Eval(@"
 exec('''
 import System
-import System.Collections.Generic.List__T1 as List
+import System.Collections.Generic.List_1 as List
 
 # create generic type: List<int>
 ListInt = puerts.generic(List, System.Int32)
@@ -206,11 +206,11 @@ void Start() {
     var env = new Puerts.ScriptEnv(new Puerts.BackendPython());
     env.Eval(@"
 exec('''
-from System.Collections.Generic import List__T1
+from System.Collections.Generic import List_1
 from System import Int32
 
 # use square bracket syntax to create generic type: List<int>
-List_Int32 = List__T1[Int32]
+List_Int32 = List_1[Int32]
 ls = List_Int32()
 ls.Add(1)
 ls.Add(2)
@@ -223,11 +223,11 @@ print(ls.Count)  # 3
 }
 ```
 
-中括号语法 `List__T1[Int32]` 等价于 `puerts.generic(List__T1, Int32)`，对于多个类型参数，使用逗号分隔：`Dictionary__T2[String, Int32]`。
+中括号语法 `List_1[Int32]` 等价于 `puerts.generic(List_1, Int32)`，对于多个类型参数，使用逗号分隔：`Dictionary_2[String, Int32]`。
 
-> ⚠️ **泛型类名的特殊表示**：C# 中泛型类名使用反引号表示类型参数个数（如 `` List`1 ``），而在 Python 的 `import` 语法中，反引号需要替换为 `__T` 加参数个数：
-> - `` List`1 `` → `List__T1`
-> - `` Dictionary`2 `` → `Dictionary__T2`
+> ⚠️ **泛型类名的特殊表示**：C# 中泛型类名使用反引号表示类型参数个数（如 `` List`1 ``），而在 Python 的 `import` 语法中，反引号需要替换为 `_` 加参数个数：
+> - `` List`1 `` → `List_1`
+> - `` Dictionary`2 `` → `Dictionary_2`
 >
 > 使用 `puerts.load_type()` 时，可以直接使用反引号原始格式：
 > ```python
@@ -253,12 +253,12 @@ x = InnerClassA()
 print(x.Foo)  # Hello
 
 # access generic nested class
-InnerClassB_T1 = puerts.generic(TestNestedTypes.InnerClassB__T1, Int32)
-y = InnerClassB_T1()
+InnerClassB_1 = puerts.generic(TestNestedTypes.InnerClassB_1, Int32)
+y = InnerClassB_1()
 print(y.Bar)  # Hello
 
-InnerClassB_T2 = puerts.generic(TestNestedTypes.InnerClassB__T2, Int32, String)
-z = InnerClassB_T2()
+InnerClassB_2 = puerts.generic(TestNestedTypes.InnerClassB_2, Int32, String)
+z = InnerClassB_2()
 print(z.Bar)  # Hello
 ''')
 ");
@@ -438,10 +438,10 @@ void Start() {
     var env = new Puerts.ScriptEnv(new Puerts.BackendPython());
     env.Eval(@"
 exec('''
-from System.Collections.Generic import List__T1
+from System.Collections.Generic import List_1
 from System import Int32
 
-List_Int32 = List__T1[Int32]
+List_Int32 = List_1[Int32]
 myList = List_Int32()
 myList.Add(1)
 myList.Add(2)

unity/test/Src/Cases/Python/CrossLang/GenericTest.cs

@@ -48,9 +48,9 @@ public void ListRangePythonTest()
             var pythonEnv = new ScriptEnv(new BackendPython());
             pythonEnv.Eval(@"
 exec('''
-import System.Collections.Generic.List__T1 as List
+import System.Collections.Generic.List_1 as List_1
 import System
-ListInt = puerts.generic(List, System.Int32)
+ListInt = puerts.generic(List_1, System.Int32)
 ls = ListInt()
 ls.Add(1)
 ls.Add(2)

unity/test/Src/Cases/Python/GenIteratorTest.cs

@@ -15,10 +15,10 @@ public void GenIteratorTest()
 
             pythonEnv.Eval(@"
 exec('''
-from System.Collections.Generic import List__T1
+from System.Collections.Generic import List_1
 from System import Int32
-List__Int32 = List__T1[Int32]
-myList = List__Int32()
+List_Int32 = List_1[Int32]
+myList = List_Int32()
 myList.Add(1)
 myList.Add(2)
 myList.Add(3)

unity/test/Src/Cases/Python/NestedTypesTest.cs

@@ -60,12 +60,12 @@ from Puerts.UnitTest import TestNestedTypes
 assertAndPrint = TestHelper.AssertAndPrint
 InnerClassA = TestNestedTypes.InnerClassA
 InnerClassB = TestNestedTypes.InnerClassB
-InnerClassB__T1 = puerts.generic(TestNestedTypes.InnerClassB__T1, Int32)
-InnerClassB__T2 = puerts.generic(TestNestedTypes.InnerClassB__T2, Int32, String)
+InnerClassB_1 = puerts.generic(TestNestedTypes.InnerClassB_1, Int32)
+InnerClassB_2 = puerts.generic(TestNestedTypes.InnerClassB_2, Int32, String)
 x = InnerClassA()
 o = InnerClassB()
-y = InnerClassB__T1()
-z = InnerClassB__T2()
+y = InnerClassB_1()
+z = InnerClassB_2()
 ''')
 ");
             pythonEnv.Dispose();

unity/upms/python/Runtime/Src/Backends/BackendPython.cs

@@ -131,12 +131,12 @@ class puerts:
     def load_type(type_name: str):
         """"""
         Load a C# class or generic type definition, raise ModuleNotFoundError if the type cannot be found or loaded.
-        :param type_name: The full name of the C# type to load. If the type is generic, use the format 'TypeName__Tn' where n is the number of generic parameters.
+        :param type_name: The full name of the C# type to load. If the type is generic, use the format 'TypeName_n' where n is the number of generic parameters.
         :return: The loaded C# class or generic type definition
         """"""
-        generic_tick_index = type_name.find('__T')
+        generic_tick_index = type_name.find('_')
         if generic_tick_index != -1:
-            suffix = type_name[generic_tick_index + 3:]
+            suffix = type_name[generic_tick_index + 1:]
             if suffix and suffix.isdigit():
                 type_name = type_name[:generic_tick_index] + '`' + suffix
         if type_name in _csTypeCache_:
@@ -157,9 +157,9 @@ raise ModuleNotFoundError(f'Failed to load type {type_name} in loadType')
             for i in range(nestedTypes.Length):
                 ntype = nestedTypes.get_Item(i)
                 if ntype.IsGenericTypeDefinition:
-                    nName = ntype.Name  ## convert name (T`1) to (T__T1) for syntax compatibility
+                    nName = ntype.Name  ## convert name (T`1) to (T_1) for syntax compatibility
                     tick_index = nName.find('`')
-                    nName = nName[:tick_index] + '__T' + nName[tick_index + 1:]
+                    nName = nName[:tick_index] + '_' + nName[tick_index + 1:]
                     setattr(cs_class, nName, puerts.load_type(ntype.FullName))
                     pass  ## skip generic type definitions, use puerts.generic to instantiate them
                 else: