os.chmod() on Windows doesn't follow symlinks by default

[nineteendo]

I just read python/cpython#113188 which states the following:

os.chmod() still does not follow symlinks by default on Windows

But the stubs say otherwise:

typeshed/stdlib/os/__init__.pyi

Line 750 in 0445d74

def chmod(path: FileDescriptorOrPath, mode: int, *, dir_fd: int | None = None, follow_symlinks: bool = True) -> None: ...

We should just use an ellipsis here:

def chmod(path: FileDescriptorOrPath, mode: int, *, dir_fd: int | None = None, follow_symlinks: bool = ...) -> None: ...

• PR: Fix os.chmod #11775

[srittau]

Then the Python docs are wrong and should be fixed first: https://docs.python.org/3/library/os.html#os.chmod.

os.chmod(path, mode, *, dir_fd=None, follow_symlinks=True)

[nineteendo]

It has already been fixed on the main branch: https://docs.python.org/3.13/library/os.html#os.chmod

The default value of follow_symlinks is False on Windows.

[srittau]

Semi-fixed. It still says True in the signature, only when reading the low-contrast box on the next screen page, it states the correct default. Also, in older docs versions, it doesn't state that follow_symlinks doesn't exist/isn't supported on Windows.

[nineteendo]

Also, in older docs versions, it doesn't state that follow_symlinks doesn't exist/isn't supported on Windows.

No, but os.supports_follow_symlinks exists for that purpose.