Title: The docstring for `os.mkdir` should mention the effect of umask · Issue #96288 · python/cpython · GitHub
Open Graph Title: The docstring for `os.mkdir` should mention the effect of umask · Issue #96288 · python/cpython
X Title: The docstring for `os.mkdir` should mention the effect of umask · Issue #96288 · python/cpython
Description: Documentation In os.mkdir, when the argument mode is used, the current umask value is first masked out of it. This behavior is mentioned in the library's documentation, but not in the docstring. This behavior may be unexpected for some (...
Open Graph Description: Documentation In os.mkdir, when the argument mode is used, the current umask value is first masked out of it. This behavior is mentioned in the library's documentation, but not in the docstring. Th...
X Description: Documentation In os.mkdir, when the argument mode is used, the current umask value is first masked out of it. This behavior is mentioned in the library's documentation, but not in the docstring...
Opengraph URL: https://github.com/python/cpython/issues/96288
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"The docstring for `os.mkdir` should mention the effect of umask","articleBody":"# Documentation\r\n\r\nIn `os.mkdir`, when the argument `mode` is used, the current umask value is first masked out of it. This behavior is mentioned in the library's documentation, but not in the docstring.\r\n\r\nThis behavior 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 will be mentioned in the docstring.\r\n\r\nMy edit suggestion is given in #96271.","author":{"url":"https://github.com/hagai-helman","@type":"Person","name":"hagai-helman"},"datePublished":"2022-08-25T22:22:31.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/96288/cpython/issues/96288"}| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:1f946c30-33e4-fef0-3e36-3c5e66949619 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | B7E8:EDE04:149245A:1C252AA:69694CB4 |
| html-safe-nonce | 78c2d7cd2b116f6b09d798c9967da5b120003c386100af200a797b9057740a73 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCN0U4OkVERTA0OjE0OTI0NUE6MUMyNTJBQTo2OTY5NENCNCIsInZpc2l0b3JfaWQiOiIzODk0OTQ1MTY3Nzg0MzY1MjM3IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 860add40740a70ff092d25f5faa4db91a1c3161ab63b7827efa84d632819694e |
| hovercard-subject-tag | issue:1351506119 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/cpython/96288/issue_layout |
| twitter:image | https://opengraph.githubassets.com/efebf0a4a42e91d8a5d07d50465ade16fb637baeb0556abe93dc38b5be4ac92d/python/cpython/issues/96288 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/efebf0a4a42e91d8a5d07d50465ade16fb637baeb0556abe93dc38b5be4ac92d/python/cpython/issues/96288 |
| og:image:alt | Documentation In os.mkdir, when the argument mode is used, the current umask value is first masked out of it. This behavior is mentioned in the library's documentation, but not in the docstring. Th... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | hagai-helman |
| hostname | github.com |
| expected-hostname | github.com |
| None | 54182691a21263b584d2e600b758e081b0ff1d10ffc0d2eefa51cf754b43b51d |
| turbo-cache-control | no-preview |
| go-import | github.com/python/cpython git https://github.com/python/cpython.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 81598961 |
| octolytics-dimension-repository_nwo | python/cpython |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 81598961 |
| octolytics-dimension-repository_network_root_nwo | python/cpython |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | d69ac0477df0f87da03b8b06cebd187012d7a930 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width