[Typing][C-116,C-117] Add type annotations for "paddle/geometric/*"

[successfulbarrier]

PR Category

User Experience

PR Types

Improvements

Description

C-116，C117 ,为公开AP添加类型提示信息
#65008

[paddle-bot]

你的PR提交成功，感谢你对开源项目的贡献!
请关注后续CI自动化测试结果，详情请参考Paddle-CI手册。
Your PR has been submitted. Thanks for your contribution!
Please wait for the result of CI firstly. See Paddle CI Manual for details.

[megemini]

Suggested change

	name: Tensor | None = None,
	name: str | None = None,

[megemini]

Suggested change

	x: Tensor,
	neighbors: list | tuple,
	count: list | tuple,
	value_buffer: Tensor | None = None,
	index_buffer: Tensor | None = None,
	name: str | None = None,
	) -> tuple[Tensor, Tensor, Tensor]:
	x: Tensor,
	neighbors: Sequence[Tensor],
	count: Sequence[Tensor],
	value_buffer: Tensor | None = None,
	index_buffer: Tensor | None = None,
	name: str | None = None,
	) -> tuple[Tensor, Tensor, Tensor]:

[megemini]

使用 overload 区分不同的输出情况

[megemini]

同上

[megemini]

重写了一遍函数？overload 不是这么用的，可以搜一下已经使用了 overload 标注的地方 ～

一个简单的例子

@overload
def foo(arg0: Any, arg1: Literal[True]) -> int: ...
@overload
def foo(arg0: Any, arg1: Literal[False]) -> str: ...
@overload
def foo(arg0: Any, arg1: bool = ...) -> int | str: ...
def foo(arg0, arg1=True):
    if arg1:
        return int(arg0)
    return str(arg0)

x: int = foo(1, True)
y: str = foo(1, False)

[successfulbarrier]

已经修正，感谢您的耐心指导

[megemini]

改的还是有点问题，注意几个地方：

• overload 中一般不写具体参数值，更不能更改原赋值
• overload 中使用 Literal ，如果原定义中有默认值，可以跟 = ...
• 需要单独一个 arg1: bool = ... 的 overload ，用于针对参数传值而非直接传值
• 使用 overload 后，原函数不需要再标注类型（也可以不定义最后的 overload ，而直接在原函数中标注）

overload 本身有些行为定义的还不是很清楚，但，一定要分清楚类型标注和默认值的关系 ～

p.s. 更新了上面的示例

[successfulbarrier]

是这样吗？

[megemini]

Suggested change

	return_eids: bool = Literal[True],
	return_eids: Literal[True] = ...,

其他几个类似 ～

[megemini]

LGTM ～