os-rename (PTH104)

Derived from the flake8-use-pathlib linter.

What it does

Checks for uses of os.rename.

Why is this bad?

pathlib offers a high-level API for path manipulation, as compared to the lower-level API offered by os. When possible, using Path object methods such as Path.rename() can improve readability over the os module's counterparts (e.g., os.rename()).

Note that os functions may be preferable if performance is a concern, e.g., in hot loops.

Examples

import os

os.rename("old.py", "new.py")

Use instead:

from pathlib import Path

Path("old.py").rename("new.py")

References

• Python documentation: Path.rename
• Python documentation: os.rename
• PEP 428 – The pathlib module – object-oriented filesystem paths
• Correspondence between os and pathlib
• Why you should be using pathlib
• No really, pathlib is great