Tomas Doran > Catalyst-Devel > Catalyst::Restarter

Download:
Catalyst-Devel-1.38.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

New  5
Open  2
View/Report Bugs
Source   Latest Release: Catalyst-Devel-1.39

NAME ^

Catalyst::Restarter - Uses File::ChangeNotify to check for changed files and restart the server

SYNOPSIS ^

    my $class = Catalyst::Restarter->pick_subclass;

    my $restarter = $class->new(
        directories => '/path/to/MyApp',
        regex       => '\.yml$|\.yaml$|\.conf|\.pm$',
        start_sub => sub { ... }
    );

    $restarter->run_and_watch;

DESCRIPTION ^

This is the base class for all restarters, and it also provide functionality for picking an appropriate restarter subclass for a given platform.

This class uses File::ChangeNotify to watch one or more directories of files and restart the Catalyst server when any of those files changes.

METHODS ^

pick_subclass

Returns the name of an appropriate subclass for the given platform.

new ( start_sub => sub { ... }, ... )

This method creates a new restarter object, but should be called on a subclass, not this class.

The "start_sub" argument is required. This is a subroutine reference that can be used to start the Catalyst server.

run_and_watch

This method forks, starts the server in a child process, and then watched for changed files in the parent. When files change, it kills the child, forks again, and starts a new server.

SEE ALSO ^

Catalyst, File::ChangeNotify

AUTHORS ^

Catalyst Contributors, see Catalyst.pm

COPYRIGHT ^

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

syntax highlighting: