astral-sh/ruff

`PTH*`: Incorrect suggestion to use `Pathlib` when using file descriptors

Open

#17,699 建立於 2025年4月29日

在 GitHub 查看
 (7 留言) (0 反應) (0 負責人)Rust (47,527 star) (2,088 fork)batch import
bugfixeshelp wantedrule

描述

Multiple pathlib rules recommend the use of pathlib.Path over their os equivalent even when they're used with a bytes string or directory descriptor which aren't supported by pathlib.

One such example is

import os
os.listdir(1)

$ ruff --version
ruff 0.11.7
$ ruff check --isolated --select PTH208 t.py
t.py:2:1: PTH208 Use `pathlib.Path.iterdir()` instead.
  |
1 | import os
2 | os.listdir(1)
  | ^^^^^^^^^^ PTH208
  |

Found 1 error.

Past instances of the same or similar error:

貢獻者指南

技術棧
pythonrust
領域
toolingdeveloper experience
議題類型
bug
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
3
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
1-3 hours
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
active
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
clear
前置要求
Pythonpathlibruff rulesfile descriptors
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
65
研究方向
Investigate the implementation of PTH208 in the ruff codebase, likely in `crates/ruff linter/src/rules/pathlib/`. Check how the rule currently determines when to suggest `pathlib.Path.iterdir()`. The issue indicates that the rule should skip cases where the argument is a bytes string or a file descriptor (integer). Review past issues #7620 and #12871 for prior discussion and potential solutions. Implement a condition to suppress the rule when the argument is not a string path.