Skip to content

gh-151138: Document Windows-specific temp dirs in gettempdir() #156016

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
maksimtech wants to merge 3 commits into from
+13 −2
Closed

gh-151138: Document Windows-specific temp dirs in gettempdir() #156016

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
18f1503
gh-151138: Document Windows-specific temp dirs in gettempdir()
maksimtech Aug 18, 2026
e4d7297
Merge branch 'main' into fix/tempfile-windows-docs
maksimtech Aug 18, 2026
9eebcbb
Merge branch 'main' into fix/tempfile-windows-docs
maksimtech Aug 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 13 additions & 2 deletions Doc/library/tempfile.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -348,8 +348,14 @@ The module defines the following user-callable items:

#. A platform-specific location:

* On Windows, the directories :file:`C:\\TEMP`, :file:`C:\\TMP`,
:file:`\\TEMP`, and :file:`\\TMP`, in that order.
* On Windows, the following directories, in that order:

- :file:`%USERPROFILE%\\AppData\\Local\\Temp`
- :file:`%SYSTEMROOT%\\Temp`
- :file:`C:\\TEMP`
- :file:`C:\\TMP`
- :file:`\\TEMP`
- :file:`\\TMP`

* On all other platforms, the directories :file:`/tmp`, :file:`/var/tmp`, and
:file:`/usr/tmp`, in that order.
Expand All @@ -359,6 +365,11 @@ The module defines the following user-callable items:
The result of this search is cached, see the description of
:data:`tempdir` below.

.. versionchanged:: 3.6
On Windows, :file:`%USERPROFILE%\\AppData\\Local\\Temp` and
:file:`%SYSTEMROOT%\\Temp` are now checked before the hardcoded
directory paths.

.. versionchanged:: 3.10

Always returns a str. Previously it would return any :data:`tempdir`
Expand Down
Loading