From: Łukasz Langa <lukasz@langa.pl>
Date: Tue, 1 Aug 2017 23:47:50 +0000 (-0700)
Subject: Document Path.is_mount(), update Misc/ACKS and Misc/NEWS (#2980)
X-Git-Tag: v3.7.0a1~323
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=47320a652e872003f3dd3a9db4243067b09dd316;p=python

Document Path.is_mount(), update Misc/ACKS and Misc/NEWS (#2980)
---

diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index 0c9bd0d940..3d28a1bea3 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -761,6 +761,18 @@ call fails (for example because the path doesn't exist):
    other errors (such as permission errors) are propagated.
 
 
+.. method:: Path.is_mount()
+
+   Return ``True`` if the path is a :dfn:`mount point`: a point in a
+   file system where a different file system has been mounted.  On POSIX, the
+   function checks whether *path*'s parent, :file:`path/..`, is on a different
+   device than *path*, or whether :file:`path/..` and *path* point to the same
+   i-node on the same device --- this should detect mount points for all Unix
+   and POSIX variants.  Not implemented on Windows.
+
+   .. versionadded:: 3.7
+
+
 .. method:: Path.is_symlink()
 
    Return ``True`` if the path points to a symbolic link, ``False`` otherwise.
diff --git a/Misc/ACKS b/Misc/ACKS
index e0640c114f..f1f6c147f4 100644
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -886,6 +886,7 @@ Inyeol Lee
 James Lee
 John J. Lee
 Thomas Lee
+Cooper Ry Lees
 Tennessee Leeuwenburg
 Luc Lefebvre
 Pierre Paul Lefebvre
diff --git a/Misc/NEWS.d/next/Library/2017-08-01-15-56-50.bpo-30897.OuT1-Y.rst b/Misc/NEWS.d/next/Library/2017-08-01-15-56-50.bpo-30897.OuT1-Y.rst
new file mode 100644
index 0000000000..41a75b805a
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2017-08-01-15-56-50.bpo-30897.OuT1-Y.rst
@@ -0,0 +1,3 @@
+``pathlib.Path`` objects now include an ``is_mount()`` method (only
+implemented on POSIX).  This is similar to ``os.path.ismount(p)``. Patch by
+Cooper Ry Lees.