Skip to content

[CodeStyle] Bump Ruff to v0.16.0 and sync tooling docs#7923

Open
ShigureNyako wants to merge 2 commits into
PaddlePaddle:developfrom
ShigureNyako:docs/sync-ast-grep-ruff-2026-07
Open

[CodeStyle] Bump Ruff to v0.16.0 and sync tooling docs#7923
ShigureNyako wants to merge 2 commits into
PaddlePaddle:developfrom
ShigureNyako:docs/sync-ast-grep-ruff-2026-07

Conversation

@ShigureNyako

@ShigureNyako ShigureNyako commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

同步 PaddlePaddle/Paddle#79546 的代码检查工具版本:

  • 将 docs 仓库的 Ruff pre-commit pin 从 0.15.0 升级到 0.16.0
  • 将代码规范指南中的 ast-grep 版本从 0.44.0 更新为 0.45.0
  • 将代码规范指南中的 Ruff 版本从 0.15.0 更新为 0.16.0
  • 在 Ruff 配置中明确排除 Markdown,继续由 docs 仓库现有的专用 Markdown hooks 负责格式检查,避免直接运行 ruff format 时批量改写文档代码块。

ast-grep 未作为 docs 仓库的 pre-commit hook 引入,指南中的版本仅用于同步 Paddle 仓库的实际配置。

本地验证:

  • Ruff 0.16 全仓 lint 通过;
  • Ruff 0.16 format check 仅覆盖 69 个 Python/PYI/Jupyter 文件并通过,Markdown 排除策略生效;
  • 变更文件上的完整 pre-commit hooks 全部通过;
  • git diff --check 通过。

@paddle-bot

paddle-bot Bot commented Jul 25, 2026

Copy link
Copy Markdown

感谢你贡献飞桨文档,文档预览构建中,Docs-New 跑完后即可预览,预览链接:http://preview-pr-7923.paddle-docs-preview.paddlepaddle.org.cn/documentation/docs/zh/api/index_cn.html
预览工具的更多说明,请参考:飞桨文档预览工具

@github-actions

Copy link
Copy Markdown
📚 本次 PR 文档预览链接(点击展开)
ℹ️ 预览提醒
请等待 Docs-NEW 流水线运行完成后再点击预览链接,否则可能会看到旧版本内容或遇到链接无法访问的情况。
  • docs/dev_guides/git_guides/codestyle_check_guide_cn.md: 点击预览

@ShigureNyako

Copy link
Copy Markdown
Contributor Author

已完成自 review:

  • docs 仓库仅升级实际使用的 Ruff hook;
  • ast-grep 只更新版本表,与 Paddle PR 保持一致,未额外引入 hook;
  • GitHub PR diff 与本地提交 2f5252c 一致,完整 pre-commit 及 Ruff 全仓检查均已通过。

@SigureMo 请 review,谢谢。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants