NAME
    File::Hotfolder - recursive watch directory for new or modified files

SYNOPSIS
        my $hf = File::Hotfolder->new(
            watch    => '/my/input/path',
            delete   => 1
            callback => sub { 
                my $path = shift; # absolute path
                ...
                return should_delete($path) ? 1 : 0;
            },
        );

DESCRIPTION
    This module uses Linux::Inotify2 to recursively watch a directory for
    new or modified files. A callback is called on each file with its
    absolute path.

    Deletions and new subdirectories are not reported but new subdirectories
    will be watched as well.

CONFIGURATION
    watch
        Base directory to watch

    callback
        Callback for each new or modified file. The callback is not called
        during a write but after a file has been closed.

    delete
        Delete the modified file if a callback returned a true value
        (disabled by default).

EXAMPLE
        use File::Hotfolder;
        use File::Spec;

        my $root = @ARGV[0];

        my $hf = File::Hotfolder->new( 
            watch => $root,
            delete => 0,
            callback => sub {
                my $path = shift;
                print File::Spec->abs2rel( $path, $root ) . "\n";
            }
        );

        1 while $hf->poll;

SEE ALSO
    File::ChangeNotify, Filesys::Notify::Simple, AnyEvent::Inotify::Simple

COPYRIGHT AND LICENSE
    Copyright Jakob Voss, 2015-

    This library is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

