app::cmd::tester(3pm) [debian man page]

App::Cmd::Tester(3pm)					User Contributed Perl Documentation				     App::Cmd::Tester(3pm)

NAME

       App::Cmd::Tester - for capturing the result of running an app

VERSION

       version 0.318

SYNOPSIS

	 use Test::More tests => 4;
	 use App::Cmd::Tester;

	 use YourApp;

	 my $result = test_app(YourApp => [ qw(command --opt value) ]);

	 like($result->stdout, qr/expected output/, 'printed what we expected');

	 is($result->stderr, '', 'nothing sent to sderr');

	 is($result->error, undef, 'threw no exceptions');

	 my $result = test_app(YourApp => [ qw(command --opt value --quiet) ]);

	 is($result->output, '', 'absolutely no output with --quiet');

DESCRIPTION

       One of the reasons that user-executed programs are so often poorly tested is that they are hard to test.  App::Cmd::Tester is one of the
       tools App-Cmd provides to help make it easy to test App::Cmd-based programs.

       It provides one routine: test_app.

METHODS

   test_app
       Note: while "test_app" is a method, it is by default exported as a subroutine into the namespace that uses App::Cmd::Tester.  In other
       words: you probably don't need to think about this as a method unless you want to subclass App::Cmd::Tester.

	 my $result = test_app($app_class => @argv_contents);

       This will locally set @ARGV to simulate command line arguments, and will then call the "run" method on the given application class (or
       application).  Output to the standard output and standard error filehandles  will be captured.

       $result is an App::Cmd::Tester::Result object, which has methods to access the following data:

	 stdout - the output sent to stdout
	 stderr - the output sent to stderr
	 output - the combined output of stdout and stderr
	 error	- the exception thrown by running the application, or undef
	 run_rv - the return value of the run method (generally irrelevant)
	 exit_code - the numeric exit code that would've been issued (0 is 'okay')

AUTHOR

       Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Ricardo Signes.

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

perl v5.14.2							    2012-05-05						     App::Cmd::Tester(3pm)

App::Info::Handler::Print(3pm)				User Contributed Perl Documentation			    App::Info::Handler::Print(3pm)

NAME

       App::Info::Handler::Print - Print App::Info event messages

SYNOPSIS

	 use App::Info::Category::FooApp;
	 use App::Info::Handler::Print;

	 my $stdout = App::Info::Handler::Print->new( fh => 'stdout' );
	 my $app = App::Info::Category::FooApp->new( on_info => $stdout );

	 # Or...
	 my $app = App::Info::Category::FooApp->new( on_error => 'stderr' );

DESCRIPTION

       App::Info::Handler::Print objects handle App::Info events by printing their messages to a filehandle. This means that if you want event
       messages to print to a file or to a system filehandle, you can easily do it with this class.  You'll find, however, that
       App::Info::Handler::Print is most effective for info and error events; unknown and prompt events are better handled by event handlers that
       know how to prompt users for data. See App::Info::Handler::Prompt for an example of that functionality.

       Upon loading, App::Info::Handler::Print registers itself with App::Info::Handler, setting up a couple of strings that can be passed to an
       App::Info concrete subclass constructor. These strings are shortcuts that tell App::Info how to create the proper App::Info::Handler::Print
       object for handling events. The registered strings are:

       stdout
	   Prints event messages to "STDOUT".

       stderr
	   Prints event messages to "STDERR".

       See the "new()" constructor below for how to have App::Info::Handler::Print print event messages to different filehandle.

INTERFACE

   Constructor
       new

	 my $stderr_handler = App::Info::Handler::Print->new;
	 $stderr_handler = App::Info::Handler::Print->new( fh => 'stderr' );
	 my $stdout_handler = App::Info::Handler::Print->new( fh => 'stdout' );
	 my $fh = FileHandle->new($file);
	 my $fh_handler = App::Info::Handler::Print->new( fh => $fh );

       Constructs a new App::Info::Handler::Print and returns it. It can take a single parameterized argument, "fh", which can be any one of the
       following values:

       stderr
	   Constructs a App::Info::Handler::Print object that prints App::Info event messages to "STDERR".

       stdout
	   Constructs a App::Info::Handler::Print object that prints App::Info event messages to "STDOUT".

       FileHandle
       GLOB
	   Pass in a reference and App::Info::Handler::Print will assume that it's a filehandle reference that it can print to. Note that passing
	   in something that can't be printed to will trigger an exception when App::Info::Handler::Print tries to print to it.

       If the "fh" parameter is not passed, "new()" will default to creating an App::Info::Handler::Print object that prints App::Info event
       messages to "STDOUT".

       handler

       This method is called by App::Info to print out the message from events.

BUGS

       Please send bug reports to <bug-app-info@rt.cpan.org> or file them at <http://rt.cpan.org/NoAuth/Bugs.html?Dist=App-Info>.

AUTHOR

       David Wheeler <david@justatheory.com>

SEE ALSO

       App::Info documents the event handling interface.

       App::Info::Handler::Carp handles events by passing their messages Carp module functions.

       App::Info::Handler::Prompt offers event handling more appropriate for unknown and confirm events.

       App::Info::Handler describes how to implement custom App::Info event handlers.

COPYRIGHT AND LICENSE

       Copyright (c) 2002-2008, David Wheeler. Some Rights Reserved.

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

perl v5.10.1							    2011-03-15					    App::Info::Handler::Print(3pm)