about undead process
- Added stop_timeout to allow user to control timings.
- Refactored to roles
+ - removed Proc::Daemon dependency
+ - removed File::Pid dependency
+
+ * Test::MooseX::Daemonize
+ - updated docs
+ - removed Proc::Daemon dependency
* MooseX::Daemonize::Core
- the core daemonization methods are here
- added tests for this (stevan)
0.04 2007-11-11
- - Fix stupid perlcritic.t cause the Module::Starter::PBP tests were stupid but I didn't realize it.
+ - Fix stupid perlcritic.t cause the Module::Starter::PBP tests were
+ stupid but I didn't realize it.
0.03 2007-10-22
- Add File::Slurp to dependencies so our tests pass better
0.02 Sept 19, 2007
- - Fixed bug where sometimes the pidfile is writeable but pidbase is not -- reported by dec
- - Fixed bug where the pidfile wasn't being updated properly -- reported by dec
+ - Fixed bug where sometimes the pidfile is writeable but pidbase is not -- reported by dec
+ - Fixed bug where the pidfile wasn't being updated properly -- reported by dec
- Added is_daemon attribute
- Added another fork to make sure we short circuit out of the daemonize process properly
- Switch to File::Pid
-use strict;
-
package Test::MooseX::Daemonize;
-use Proc::Daemon;
+use strict;
# BEGIN CARGO CULTING
use Sub::Exporter;
use Test::Builder;
-our $VERSION = '0.02';
+
+our $VERSION = '0.03';
our $AUTHORITY = 'cpan:PERIGRIN';
{
}
else {
sleep(1); # Punt on sleep time, 1 seconds should be enough
- $Test->ok( -e $daemon->pidfile->file, $msg )
+ $Test->ok( $daemon->pidfile->does_file_exist, $msg )
|| $Test->diag(
'Pidfile (' . $daemon->pidfile->file . ') not found.' );
}
1;
__END__
+=pod
=head1 NAME
-Test::MooseX::Daemonize - provides a Role that daemonizes your Moose based application.
-
+Test::MooseX::Daemonize - Tool to help test MooseX::Daemonize applications
=head1 VERSION
This document describes MooseX::Daemonize version 0.0.1
-
=head1 SYNOPSIS
package main;
=head1 DESCRIPTION
-Often you want to write a persistant daemon that has a pid file, and responds appropriately to Signals.
-This module helps provide the basic infrastructure to do that.
-
-=head1 ATTRIBUTES
-
-=over
-
-=item progname Str
-
-The name of our daemon, defaults to $0
-
-=item pidbase Str
-
-The base for our bid, defaults to /var/run/$progname
-
-=item pidfile Str
-
-The file we store our PID in, defaults to /var/run/$progname/
-
-=item foreground Bool
-
-If true, the process won't background. Useful for debugging. This option can be set via Getopt's -f.
-
-=back
-
-=head1 METHODS
-
-=over
-
-=item check()
-
-Check to see if an instance is already running.
-
-=item start()
+This module provides some basic Test::Builder compatible test methods to
+use when writing tests for you MooseX::Daemonize based modules.
-Setup a pidfile, fork, then setup the signal handlers.
+=head1 EXPORTED FUNCTIONS
-=item stop()
+=over 4
-Stop the process matching the pidfile, and unlinks the pidfile.
+=item B<daemonize_ok ( $daemon, ?$msg )>
-=item restart()
+This will attempt to daemonize your C<$daemon> returning ok on
+success and not ok on failure.
-Litterally
+=item B<check_test_output ( $daemon )>
- $self->stop();
- $self->start();
-
-=item daemonize()
-
-Calls C<Proc::Daemon::Init> to daemonize this process.
-
-=item kill($pid)
-
-Kills the process for $pid. This will try SIGINT, and SIGTERM before falling back to SIGKILL and finally giving up.
-
-=item setup_signals()
-
-Setup the signal handlers, by default it only sets up handlers for SIGINT and SIGHUP
-
-=item handle_sigint()
-
-Handle a INT signal, by default calls C<$self->stop()>;
-
-=item handle_sighup()
-
-Handle a HUP signal. Nothing is done by default.
-
-=item meta()
-
-the C<meta()> method from L<Class::MOP::Class>
-
-=item daemonize_ok()
-
-=item check_test_output()
+This is expected to be used with a C<$daemon> which does the
+B<Test::MooseX::Daemonize::Testable> role (included in this package
+see the source for more info). It will collect the test output
+from your daemon and apply it in the parent process by mucking
+around with L<Test::Builder> stuff, again, read the source for
+more info. If we get time we will document this more thoroughly.
=back
-=head1 DEPENDENCIES
-
-=for author to fill in:
- A list of all the other modules that this module relies upon,
- including any restrictions on versions, and an indication whether
- the module is part of the standard Perl distribution, part of the
- module's distribution, or must be installed separately. ]
-
-Obviously L<Moose>, also L<Carp>, L<Proc::Daemon>, L<File::Flock>, L<File::Slurp>
-
=head1 INCOMPATIBILITIES
-=for author to fill in:
- A list of any modules that this module cannot be used in conjunction
- with. This may be due to name conflicts in the interface, or
- competition for system or program resources, or due to internal
- limitations of Perl (for example, many modules that use source code
- filters are mutually incompatible).
-
None reported.
-
=head1 BUGS AND LIMITATIONS
-=for author to fill in:
- A list of known problems with the module, together with some
- indication Whether they are likely to be fixed in an upcoming
- release. Also a list of restrictions on the features the module
- does provide: data types that cannot be handled, performance issues
- and the circumstances in which they may arise, practical
- limitations on the size of data sets, special cases that are not
- (yet) handled, etc.
-
No bugs have been reported.
Please report any bugs or feature requests to
=head1 SEE ALSO
-L<Proc::Daemon>, L<Daemon::Generic>, L<MooseX::Getopt>
+L<MooseX::Daemonize>
=head1 AUTHOR
Chris Prather C<< <perigrin@cpan.org> >>
-
=head1 LICENCE AND COPYRIGHT
Copyright (c) 2007, Chris Prather C<< <perigrin@cpan.org> >>. All rights reserved.
This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself. See L<perlartistic>.
-
=head1 DISCLAIMER OF WARRANTY
BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.
+
+=cut
projects / gitmo/MooseX-Daemonize.git / commitdiff