Add pathlib-compatible Path.is_mount

newsfragments/214.feature.1.rst

@@ -0,0 +1 @@
+Added ``Path.is_mount()`` as an alias for ``Path.ismount()`` for pathlib compatibility.

path/__init__.py

@@ -1038,6 +1038,8 @@ def ismount(self) -> bool:
         """
         return self.module.ismount(self)
 
+    is_mount = ismount
+
     def samefile(self, other: str) -> bool:
         """.. seealso:: :func:`os.path.samefile`"""
         return self.module.samefile(self, other)

tests/test_path.py

@@ -147,6 +147,27 @@ def test_home(self):
         assert isinstance(home, Path)
         assert home == os.path.expanduser('~')
 
+    @pytest.mark.parametrize('method', ['ismount', 'is_mount'])
+    @pytest.mark.parametrize('kind', ['directory', 'file', 'missing', 'root'])
+    def test_is_mount(self, tmp_path, method, kind):
+        (tmp_path / 'directory').mkdir()
+        (tmp_path / 'file').touch()
+        target = Path(tmp_path.anchor) if kind == 'root' else Path(tmp_path / kind)
+        assert getattr(target, method)() is (kind == 'root')
+
+    @pytest.mark.parametrize('method', ['ismount', 'is_mount'])
+    @pytest.mark.parametrize('expected', [False, True])
+    def test_is_mount_module(self, monkeypatch, method, expected):
+        module = types.ModuleType('mount_module')
+        target = Path.using_module(module)('some-path')
+
+        def ismount(value):
+            assert value is target
+            return expected
+
+        monkeypatch.setattr(module, 'ismount', ismount, raising=False)
+        assert getattr(target, method)() is expected
+
     def test_explicit_module(self):
         """
         The user may specify an explicit path module to use.