Add examples illustrating symbolic chmod.

jaraco · Jul 6, 2023 · 5698f1e · 5698f1e
1 parent d09b7d6
commit 5698f1e
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/path/__init__.py b/path/__init__.py
@@ -1105,6 +1105,12 @@ def chmod(self, mode):
         Set the mode. May be the new mode (os.chmod behavior) or a `symbolic
         mode <http://en.wikipedia.org/wiki/Chmod#Symbolic_modes>`_.
 
+        >>> a_file = Path(getfixture('tmp_path')).joinpath('afile.txt').touch()
+        >>> a_file.chmod(0o700)
+        Path(...
+        >>> a_file.chmod('u+x')
+        Path(...
+
         .. seealso:: :func:`os.chmod`
         """
         if isinstance(mode, str):