任务背景

此次任务为 为 Paddle 框架 API 添加类型提示（Type Hints） 以及 Python 版本退场中 Ruff 升级部分的联合企划。

Python 3.8 EOL 在即1，是时候开始考虑 Python 3.8 退场的一些事情了。但是先别急，正式退场还需要一段时间，但我们可以考虑一些现阶段可以做的事情了～

自引入 Ruff 以来，每退场一个旧版本时必做的事情就是调整 target-version 了，我们现在所使用的 target-version 是 py38 ，也就是表明我们最低支持的 Python 版本是 3.8。当然，在我们正式退场 3.8 时需要将其调整为 py39 。

经过简单的测试，我们发现升级 py39 居然有 1000 多个问题需要修复，这么庞大的数量对于我们退场 3.8 来说是有一点小小的阻力的

$ ruff check . --statistics --output-format concise --target-version=py39
691     UP006   [*] non-pep585-annotation
375     UP035   [ ] deprecated-import
3     UP036   [*] outdated-version-block

一般来说，只有真正能退场 3.8 的时候才可以修复这些问题，因为这些问题是 3.9 引入了一些新特性，而 3.8 并不支持……但我们这次的报错是有一些不同的，这里的报错基本都是 PEP 585 的升级问题，即使用类似 list 、 collections.abc.Sequence 这种标准泛型来替代 typing.List 、 typing.Sequence 这种泛型，虽然直接使用仍然会报错，但是 PEP 585 明确提到了，如果使用 PEP 563 （即 from __future__ import annotations ），那么我们是可以在「类型注解语义」下使用这些标准泛型的。而刚好，我们的类型提示本就是将使用 PEP 563 作为规范的一部分的，因此我们完全可以在当前还支持 3.8 的情况下，通过使用 PEP 563，在「类型注解语义」的 case 下，来修复 PEP 585 弃用掉的类型

因此本次希望与大家一起推动 PEP 585 升级，退场掉大部分弃用的 typing 泛型使用

任务目标

让我们来看看具体要怎么做吧～

示例一

from typing import List

def code_block(self, lang: str, block: List[str]):
    ...

修改为

from __future__ import annotations

def code_block(self, lang: str, block: list[str]):
    ...

Note

一定要在文件开头加上 from __future__ import annotations ，否则如上所述，这在 3.8 下会报错的哦～

如果不清楚使用方式, 请搜索仓库中存量的 from __future__ import annotations 来查看使用方法。

示例二

from typing import Sequence

def transpose(
    x: Tensor, perm: Sequence[int], name: str | None = None
) -> Tensor:
    ...

修改为

from __future__ import annotations

from collections.abc import Sequence

def transpose(
    x: Tensor, perm: Sequence[int], name: str | None = None
) -> Tensor:
    ...

示例三

如果需要替换的对象出现在 「非类型注解语义」 的场景下不能进行修改, 如果一个文件所有 case 都处于「非类型注解语义」下，请在本 issue 评论区留言或在提交 PR 时指出即可。

from __future__ import annotations

from collections.abc import Iterable

IterableInt = Iterable[int] # 非类型注解语义，这里运行时会执行
class Foo(Iterable[int]): ... # 非类型注解语义，同样会执行

def foo() -> Iterable[int]: ... # 类型注解语义，PEP 563 下会延迟计算
def foo(input: Iterable[int]): ... # 类型注解语义，PEP 563 下会延迟计算

当然我们大多数类型提示都是在「类型注解语义」下使用的，「非类型注解语义」下使用的很少，所以大多数可以放心替换～

你也可以参考 PR #66941 来查看一个完整的 PR 大概要如何修改

实施步骤

安装 ruff v0.5.0

首先我们需要能够复现这 1000 多个问题，首先就需要自己安装一下 Ruff

目前 paddle 所使用的 ruff 版本为 0.5.0，请使用相同版本确保问题的可复现性：

$ pip install ruff==0.5.0

问题复现

以 python/paddle/tensor/linalg.py 为例

$ ruff check python/paddle/tensor/linalg.py --target-version=py39
python/paddle/tensor/linalg.py:16:1: UP035 [*] Import from `collections.abc` instead: `Sequence`
|
14 | from __future__ import annotations
15 |
16 | from typing import TYPE_CHECKING, Literal, Sequence, overload
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ UP035
17 |
18 | import numpy as np
|
= help: Import from `collections.abc`

Found 1 error.
[*] 1 fixable with the `--fix` option.

UP035 为错误码，可以参考「示例二」进行修改，也可以在 ruff rules 查找错误码对应的规则。

Note

PEP 585 只对应 UP006 和 UP035 两条 rule，如果遇到 UP036 则直接跳过，当前 Python 3.8 未退场的情况下无法提前修复 UP036

任务列表

任务认领方式

⭐️ 提交PR 模版 ⭐️：

• // ------- PR 标题 --------

[Typing][PEP585 Upgrade][261] Use stardand collections for type hints in `python/paddle/distribution/beta.py`

或者多个任务：

[Typing][PEP585 Upgrade][1-3] Use stardand collections for type hints in `test/ir/inference/*`

Note

北航同学请注意在任务标题中添加 [BUAA] ，如：

[Typing][PEP585 Upgrade][BUAA][261] Use stardand collections for type hints in `python/paddle/distribution/beta.py`
[Typing][PEP585 Upgrade][BUAA][1-3] Use stardand collections for type hints in `test/ir/inference/*`

⭐️ 认领方式 ⭐️：
请大家以 comment 的形式认领任务，如：

【报名】：1、3、5-7

Note

建议前期先只提 1 个 PR 熟悉流程，如果被 reviewer approve 了，那么后续可以每个 PR 修改 5-10 个文件，避免提交太多 PR, 以避免重复问题。
Warning

单个 PR 提交禁止修改超过 10 个文件, 否则会被 reviewer close。
提交 PR 模版

<!-- TemplateReference: https://github.com/PaddlePaddle/Paddle/wiki/PULL-REQUEST-TEMPLATE--REFERENCE -->
<!-- Demo: https://github.com/PaddlePaddle/Paddle/pull/24810 -->

### PR Category
<!-- One of [ User Experience | Execute Infrastructure | Operator Mechanism | CINN | Custom Device | Performance Optimization | Distributed Strategy | Parameter Server | Communication Library | Auto Parallel | Inference | Environment Adaptation ] -->

User Experience

### PR Types
<!-- One of [ New features | Bug fixes | Improvements | Performance | BC Breaking | Deprecations | Docs | Devs | Not User Facing | Security | Deprecations | Others ] -->

Devs

### Description
<!-- Describe what you’ve done -->

为如下文件添加 PEP 563，并进行 PEP 585 升级：

- xxx.py
- xxx.py

### Related links

- #66936

@gouzil

状态介绍：
✅：已经完全迁移，所有单测都OK！
🙋: 报名
🟢：审核完毕待合入，合入之后完成！
🔵：可认领！
🟡：当前阶段不需要人力继续跟进，下阶段推进
🚧：迁移中，单测还没有过，还没有审核完。

大致正常流程为:
🔵 -> 🙋 -> 🚧 -> 🟢 -> ✅

异常流程为:
🔵 -> 🙋 -> 🚧 -> 🟡

看板信息

排名不分先后 @enkilee(1) @SigureMo(2)

拓展延伸

感兴趣的同学可以了解下 PEP 649 和 PEP 749 ，看看未来 Python（3.14+）又是使用了什么方案来替代 PEP 563 的～

Footnotes

1. https://devguide.python.org/versions/ ↩