Runs one dev-reloader rule: watches a directory through the configured arizona_watcher implementation, filters the changed paths by the rule's patterns, debounces bursts, and hands the resulting file list to the rule's callback and the arizona_watcher pubsub topic.

arizona_reloader_sup runs one per rule of the reloader application env (child_specs/1); see arizona_watcher for the config and the watcher contract.

Usage

1> arizona_reloader_rule:start_link("/home/me/myapp/src", #{
       watcher => arizona_watcher_fs,
       patterns => [".*\\.erl$"],
       debounce => 200,
       callback => fun arizona_reloader:reload_erl/1
   }).
{ok, <0.123.0>}

Subscribers of the arizona_watcher pubsub topic receive {arizona_watcher, Dir, Files} after each debounced burst, Dir being the rule's absolute directory, so one subscriber can tell the rules apart.

Options

• watcher -- the arizona_watcher implementation: a module, or {Module, Opts} to pass it options (required)
• patterns -- list of regex strings to filter file paths (default [".*"])
• callback -- optional fun([string()]) -> term() invoked synchronously with the changed file list before the broadcast
• debounce -- milliseconds to wait after the last change before flushing (default 100); coalesces editor-save bursts into a single event