delete file or directory-tree

README.md

@@ -15,7 +15,9 @@
 - `Path().size()` to get size in bytes of a file or directory
 - `Path().read_lines()` to yield over all lines from a file until EOF
 - `contextmanager` to change current working directory with `with` statement
-
+- `Path().copy()` copy a file or directory to a new path destination
+- `Path().delete()` delete a file or directory-tree
+
 ## Installation
 
 ```bash

pathlibutil/path.py

@@ -1,3 +1,4 @@
+import errno
 import hashlib
 import os
 import pathlib
@@ -117,3 +118,20 @@ def copy(self, dst: str, exist_ok: bool = True, **kwargs) -> 'Path':
             )
 
         return Path(_path)
+
+    def delete(self, *, recursive: bool = False, missing_ok: bool = False, **kwargs) -> None:
+        """
+            Deletes the file or directory.
+        """
+        try:
+            self.rmdir()
+        except NotADirectoryError:
+            self.unlink(missing_ok)
+        except FileNotFoundError as e:
+            if not missing_ok:
+                raise e
+        except OSError as e:
+            if not recursive or e.errno != errno.ENOTEMPTY:
+                raise e
+
+            shutil.rmtree(self, **kwargs)

tests/test_shutil.py

@@ -1,9 +1,18 @@
 import pytest
+import shutil
 import pathlib
 
 from pathlibutil import Path
 
 
+@pytest.fixture
+def tmp_dirpath(file: Path, cls: Path, tmp_path: pathlib.Path):
+
+    shutil.copy(file, tmp_path)
+
+    yield cls(tmp_path)
+
+
 def test_copy_file(file: Path, tmp_path: pathlib.Path):
     assert hasattr(Path, 'copy')
 
@@ -51,3 +60,28 @@ def test_copy_raises(file: Path, tmp_path: pathlib.Path):
 def test_copy_mkdir(file: Path, tmp_path: pathlib.Path):
     with pytest.raises(FileNotFoundError):
         file.copy(tmp_path / 'not-exists')
+
+
+def test_delete(file: Path, tmp_path: pathlib.Path):
+    assert hasattr(Path, 'delete')
+
+    p = file.copy(tmp_path)
+
+    p.delete()
+    assert not p.exists()
+
+    with pytest.raises(FileNotFoundError):
+        p.delete()
+
+
+def test_delete_directory(tmp_dirpath: Path):
+
+    with pytest.raises(OSError):
+        tmp_dirpath.delete()
+
+    with pytest.raises(TypeError):
+        tmp_dirpath.delete(True)
+
+    tmp_dirpath.delete(recursive=True)
+
+    assert not tmp_dirpath.exists()