summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2023-05-29 12:36:08 (GMT)
committerGitHub <noreply@github.com>2023-05-29 12:36:08 (GMT)
commit635ce29257a7f7272af009d3c08379522317d89b (patch)
treee94651f74c58ee00798cd3874733f9e93ad529d0 /Doc
parent5dc6b18cb0c83faab556b46bdcf96ce21880fa91 (diff)
downloadcpython-635ce29257a7f7272af009d3c08379522317d89b.zip
cpython-635ce29257a7f7272af009d3c08379522317d89b.tar.gz
cpython-635ce29257a7f7272af009d3c08379522317d89b.tar.bz2
gh-104803: Implement ntpath.isdevdrive for checking whether a path is on a Windows Dev Drive (GH-104805)
(cherry picked from commit bfd20d257e4ad16a25f4bac0ea4dbb719cdf6bc7) Co-authored-by: Steve Dower <steve.dower@python.org>
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/os.path.rst18
1 files changed, 18 insertions, 0 deletions
diff --git a/Doc/library/os.path.rst b/Doc/library/os.path.rst
index 7881c52..3a668e2 100644
--- a/Doc/library/os.path.rst
+++ b/Doc/library/os.path.rst
@@ -304,6 +304,24 @@ the :mod:`glob` module.)
Accepts a :term:`path-like object`.
+.. function:: isdevdrive(path)
+
+ Return ``True`` if pathname *path* is located on a Windows Dev Drive.
+ A Dev Drive is optimized for developer scenarios, and offers faster
+ performance for reading and writing files. It is recommended for use for
+ source code, temporary build directories, package caches, and other
+ IO-intensive operations.
+
+ May raise an error for an invalid path, for example, one without a
+ recognizable drive, but returns ``False`` on platforms that do not support
+ Dev Drives. See `the Windows documentation <https://learn.microsoft.com/windows/dev-drive/>`_
+ for information on enabling and creating Dev Drives.
+
+ .. availability:: Windows.
+
+ .. versionadded:: 3.12
+
+
.. function:: join(path, *paths)
Join one or more path segments intelligently. The return value is the