Skip to content

gh-96288: Add a sentence to os.mkdir's docstring.#96271

Merged
JelleZijlstra merged 6 commits intopython:mainfrom
hagai-helman:main
Oct 7, 2022
Merged

gh-96288: Add a sentence to os.mkdir's docstring.#96271
JelleZijlstra merged 6 commits intopython:mainfrom
hagai-helman:main

Conversation

@hagai-helman
Copy link
Contributor

@hagai-helman hagai-helman commented Aug 25, 2022

A clarification about the use of umask (copied from the os module documentation) is added to the docstring of os.mkdir.

The behavior described may be unexpected for some (for example, this is not the behavior of GNU's mkdir command - when a mode is explicitly given to it, it overrides the umask). When one is unaware of this behavior, it can lead to bugs that are difficult to notice or trace. For these two reasons, I suggest it is mentioned in the docstring.

Loading
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.

6 participants