update cli

docs/cli_help.txt

@@ -3,7 +3,8 @@ usage: watchfiles [-h] [--ignore-paths [IGNORE_PATHS]]
                   [--filter [FILTER]] [--args [ARGS]] [--verbose]
                   [--non-recursive] [--verbosity [{warning,info,debug}]]
                   [--sigint-timeout [SIGINT_TIMEOUT]]
-                  [--sigkill-timeout [SIGKILL_TIMEOUT]] [--version]
+                  [--sigkill-timeout [SIGKILL_TIMEOUT]]
+                  [--ignore-permission-denied] [--version]
                   target [paths ...]
 
 Watch one or more directories and execute either a shell command or a python function on file changes.
@@ -38,4 +39,6 @@ options:
                         How long to wait for the sigint timeout before sending sigkill.
   --sigkill-timeout [SIGKILL_TIMEOUT]
                         How long to wait for the sigkill timeout before issuing a timeout exception.
+  --ignore-permission-denied
+                        Ignore permission denied errors while watching files and directories.
   --version, -V         show program's version number and exit

tests/test_cli.py

@@ -25,6 +25,7 @@ def test_function(mocker, tmp_path):
         sigint_timeout=5,
         sigkill_timeout=1,
         recursive=True,
+        ignore_permission_denied=False,
     )
 
 
@@ -52,6 +53,7 @@ def test_ignore_paths(mocker, tmp_work_path):
         sigint_timeout=5,
         sigkill_timeout=1,
         recursive=True,
+        ignore_permission_denied=False,
     )
 
 
@@ -105,6 +107,7 @@ def test_command(mocker, tmp_work_path):
         sigint_timeout=5,
         sigkill_timeout=1,
         recursive=True,
+        ignore_permission_denied=False,
     )
 
 
@@ -122,6 +125,7 @@ def test_verbosity(mocker, tmp_path):
         sigint_timeout=5,
         sigkill_timeout=1,
         recursive=True,
+        ignore_permission_denied=False,
     )
 
 
@@ -139,6 +143,7 @@ def test_verbose(mocker, tmp_path):
         sigint_timeout=5,
         sigkill_timeout=1,
         recursive=True,
+        ignore_permission_denied=False,
     )
 
 
@@ -156,6 +161,7 @@ def test_non_recursive(mocker, tmp_path):
         sigint_timeout=5,
         sigkill_timeout=1,
         recursive=False,
+        ignore_permission_denied=False,
     )
 
 
@@ -173,6 +179,7 @@ def test_filter_all(mocker, tmp_path, capsys):
         sigint_timeout=5,
         sigkill_timeout=1,
         recursive=True,
+        ignore_permission_denied=False,
     )
     out, err = capsys.readouterr()
     assert out == ''
@@ -193,6 +200,7 @@ def test_filter_default(mocker, tmp_path):
         sigint_timeout=5,
         sigkill_timeout=1,
         recursive=True,
+        ignore_permission_denied=False,
     )
 
 
@@ -210,6 +218,7 @@ def test_set_type(mocker, tmp_path):
         sigint_timeout=5,
         sigkill_timeout=1,
         recursive=True,
+        ignore_permission_denied=False,
     )
 
 
@@ -265,6 +274,7 @@ def test_args(mocker, tmp_path, reset_argv, caplog):
         sigint_timeout=5,
         sigkill_timeout=1,
         recursive=True,
+        ignore_permission_denied=False,
     )
     assert sys.argv == ['os.getcwd', '--version']
     assert 'WARNING: --args' not in caplog.text
@@ -286,5 +296,6 @@ def test_args_command(mocker, tmp_path, caplog):
         sigint_timeout=5,
         sigkill_timeout=1,
         recursive=True,
+        ignore_permission_denied=False,
     )
     assert 'WARNING: --args is only used when the target is a function\n' in caplog.text

tests/test_rust_notify.py

@@ -307,3 +307,6 @@ def test_polling_repr(test_dir: Path):
 @skip_windows
 def test_ignore_permission_denied():
     RustNotify(['/'], False, False, 0, True, True)
+
+    with pytest.raises(PermissionError):
+        RustNotify(['/'], False, False, 0, True, False)

watchfiles/_rust_notify.pyi

@@ -35,6 +35,7 @@ class RustNotify:
             poll_delay_ms: delay between polling for changes, only used if `force_polling=True`
             recursive: if `True`, watch for changes in sub-directories recursively, otherwise watch only for changes in
                 the top-level directory, default is `True`.
+            ignore_permission_denied: if `True`, permission denied errors are ignored while watching changes.
         """
     def watch(
         self,

watchfiles/cli.py

@@ -111,6 +111,11 @@ def cli(*args_: str) -> None:
         default=1,
         help='How long to wait for the sigkill timeout before issuing a timeout exception.',
     )
+    parser.add_argument(
+        '--ignore-permission-denied',
+        action='store_true',
+        help='Ignore permission denied errors while watching directories.',
+    )
     parser.add_argument('--version', '-V', action='version', version=f'%(prog)s v{VERSION}')
     arg_namespace = parser.parse_args(args)
 
@@ -165,6 +170,7 @@ def cli(*args_: str) -> None:
         sigint_timeout=arg_namespace.sigint_timeout,
         sigkill_timeout=arg_namespace.sigkill_timeout,
         recursive=not arg_namespace.non_recursive,
+        ignore_permission_denied=arg_namespace.ignore_permission_denied,
     )