OS Manuals

/opt/airflow/bin/watchfiles

Platform to programmatically author, schedule, and monitor workflows

From airflow-3 3.2.2-r2 (os), captured 2026-11-05 by running watchfiles --help (exit 0). permalink

Also provided by 3 other package versions
usage: watchfiles [-h] [--ignore-paths [IGNORE_PATHS]] [--target-type [{command,function,auto}]]
                  [--filter [FILTER]] [--args [ARGS]] [--verbose] [--non-recursive]
                  [--verbosity [{warning,info,debug}]] [--sigint-timeout [SIGINT_TIMEOUT]]
                  [--grace-period [GRACE_PERIOD]] [--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.

Example of watching the current directory and calling a python function:

    watchfiles foobar.main

Example of watching python files in two local directories and calling a shell command:

    watchfiles --filter python 'pytest --lf' src tests

See https://watchfiles.helpmanual.io/cli/ for more information.

positional arguments:
  target                Command or dotted function path to run
  paths                 Filesystem paths to watch, defaults to current directory

options:
  -h, --help            show this help message and exit
  --ignore-paths [IGNORE_PATHS]
                        Specify directories to ignore, to ignore multiple paths use a comma as separator, e.g. "env" or "env,node_modules"
  --target-type [{command,function,auto}]
                        Whether the target should be intercepted as a shell command or a python function, defaults to "auto" which infers the target type from the target string
  --filter [FILTER]     Which files to watch, defaults to "default" which uses the "DefaultFilter", "python" uses the "PythonFilter", "all" uses no filter, any other value is interpreted as a python function/class path which is imported
  --args [ARGS]         Arguments to set on sys.argv before calling target function, used only if the target is a function
  --verbose             Set log level to "debug", wins over `--verbosity`
  --non-recursive       Do not watch for changes in sub-directories recursively
  --verbosity [{warning,info,debug}]
                        Log level, defaults to "info"
  --sigint-timeout [SIGINT_TIMEOUT]
                        How long to wait for the sigint timeout before sending sigkill.
  --grace-period [GRACE_PERIOD]
                        Number of seconds after the process is started before watching for changes.
  --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
Options (13)
OptionDescriptionSource
-h, --helpshow this help message and exithelp
--ignore-paths IGNORE_PATHSSpecify directories to ignore, to ignore multiple paths use a comma as separator, e.g. "env" or "env,node_modules"help
--target-type commandWhether the target should be intercepted as a shell command or a python function, defaults to "auto" which infers the target type from the target stringhelp
--filter FILTERWhich files to watch, defaults to "default" which uses the "DefaultFilter", "python" uses the "PythonFilter", "all" uses no filter, any other value is interpreted as a python function/class path…help
--args ARGSArguments to set on sys.argv before calling target function, used only if the target is a functionhelp
--verboseSet log level to "debug", wins over `--verbosity`help
--non-recursiveDo not watch for changes in sub-directories recursivelyhelp
--verbosity warningLog level, defaults to "info"help
--sigint-timeout SIGINT_TIMEOUTHow long to wait for the sigint timeout before sending sigkill.help
--grace-period GRACE_PERIODNumber of seconds after the process is started before watching for changes.help
--sigkill-timeout SIGKILL_TIMEOUTHow long to wait for the sigkill timeout before issuing a timeout exception.help
--ignore-permission-deniedIgnore permission denied errors while watching files and directories.help
--version, -Vshow program's version number and exithelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.