1File::ChangeNotify(3) User Contributed Perl DocumentationFile::ChangeNotify(3)
2
3
4

NAME

6       File::ChangeNotify - Watch for changes to files, cross-platform style
7

VERSION

9       version 0.31
10

SYNOPSIS

12           use File::ChangeNotify;
13
14           my $watcher =
15               File::ChangeNotify->instantiate_watcher
16                   ( directories => [ '/my/path', '/my/other' ],
17                     filter      => qr/\.(?:pm|conf|yml)$/,
18                   );
19
20           if ( my @events = $watcher->new_events ) { ... }
21
22           # blocking
23           while ( my @events = $watcher->wait_for_events ) { ... }
24

DESCRIPTION

26       This module provides an API for creating a File::ChangeNotify::Watcher
27       subclass that will work on your platform.
28
29       Most of the documentation for this distro is in
30       File::ChangeNotify::Watcher.
31

METHODS

33       This class provides the following methods:
34
35   File::ChangeNotify->instantiate_watcher(...)
36       This method looks at each available subclass of
37       File::ChangeNotify::Watcher and instantiates the first one it can load,
38       using the arguments you provided.
39
40       It always tries to use the File::ChangeNotify::Watcher::Default class
41       last, on the assumption that any other class that is available is a
42       better option.
43
44   File::ChangeNotify->usable_classes
45       Returns a list of all the loadable File::ChangeNotify::Watcher
46       subclasses except for File::ChangeNotify::Watcher::Default, which is
47       always usable.
48

SUPPORT

50       Bugs may be submitted at
51       <http://rt.cpan.org/Public/Dist/Display.html?Name=File-ChangeNotify> or
52       via email to bug-file-changenotify@rt.cpan.org <mailto:bug-file-
53       changenotify@rt.cpan.org>.
54
55       I am also usually active on IRC as 'autarch' on "irc://irc.perl.org".
56

SOURCE

58       The source code repository for File-ChangeNotify can be found at
59       <https://github.com/houseabsolute/File-ChangeNotify>.
60

DONATIONS

62       If you'd like to thank me for the work I've done on this module, please
63       consider making a "donation" to me via PayPal. I spend a lot of free
64       time creating free software, and would appreciate any support you'd
65       care to offer.
66
67       Please note that I am not suggesting that you must do this in order for
68       me to continue working on this particular software. I will continue to
69       do so, inasmuch as I have in the past, for as long as it interests me.
70
71       Similarly, a donation made in this way will probably not make me work
72       on this software much more, unless I get so many donations that I can
73       consider working on free software full time (let's all have a chuckle
74       at that together).
75
76       To donate, log into PayPal and send money to autarch@urth.org, or use
77       the button at <http://www.urth.org/~autarch/fs-donation.html>.
78

AUTHOR

80       Dave Rolsky <autarch@urth.org>
81

CONTRIBUTORS

83       •   Aaron Crane <arc@cpan.org>
84
85       •   H. Merijn Branch <h.m.brand@xs4all.nl>
86
87       •   Karen Etheridge <ether@cpan.org>
88
90       This software is Copyright (c) 2009 - 2019 by Dave Rolsky.
91
92       This is free software, licensed under:
93
94         The Artistic License 2.0 (GPL Compatible)
95
96       The full text of the license can be found in the LICENSE file included
97       with this distribution.
98
99
100
101perl v5.36.0                      2023-01-20             File::ChangeNotify(3)
Impressum