gh-145227: Clarify os.remove() directory exception is platform-dependent

[mohsinm-dev]

The OSError subclass raised by os.remove() when the path is a directory depends on the platform and underlying errno:

• Linux: unlink() returns EISDIR → IsADirectoryError
• macOS: unlink() returns EPERM → PermissionError

The documentation previously stated only that OSError is raised, which is technically correct but can mislead users into catching a specific subclass that isn't portable. For example:

try:
    os.remove(path)
except IsADirectoryError:
    os.rmdir(path)

This works on Linux but fails on macOS, where PermissionError is raised instead.

Updated the os.remove() docs to note that the exact subclass is platform-dependent, with IsADirectoryError and PermissionError as examples. No change needed for os.unlink() since its docs already defer to os.remove().

• Issue: Specify type of exception returned by os.remove() #145227

---

📚 Documentation preview 📚: https://cpython-previews--145265.org.readthedocs.build/

[benediktjohannes]

Looks good to me! One suggestion: Could you maybe add, on which plattform (for the well known ones) which error is used? Thanks!

[benediktjohannes]

Nice! Thanks, LGTM

[LKajan]

I added a comment regarding Windows behavior.

[LKajan]

Windows raises a PermissionError as well.

Suggested change

	on macOS.
	on macOS and Windows.