class IO::Notification::Change {}

IO::Notification.watch-path($path) as well as IO::Path.watch produce a Supply of IO::Notification::Change events for a file or directory, depending on what is used as the $path argument or IO::Path object.

Here is a small example that prints the first ten FileChanged-notifications for the current working directory:

my $finish = Promise.new;
my $count = 0;
IO::Notification.watch-path($*CWD).act( -> $change {
    $count++ if $change.event ~~ FileChanged;
    say "($count) $change.path(): $change.event()";
    $finish.keep if $count >= 10;
});
await $finish;

The type of the change is very much dependent both on the platform and on specific system calls that were used to initiate the change. At this point in time you should not rely on the type of change in general, and test your particular situation.

Methods §

method path §

Returns the path of the file that's being watched.

method event §

Returns the type of event: FileChanged or FileRenamed.

method IO §

Returns a handle of the file that's being watched.

method gist §

Defined as:

multi method gist(IO::Notification::Change:D:)

Returns the path and event attributes, separated by semicolon.

Type Graph §