debian man page for dist::zilla::app::command::run

Dist::Zilla::App::Command::run(3pm)			User Contributed Perl Documentation		       Dist::Zilla::App::Command::run(3pm)

NAME
       Dist::Zilla::App::Command::run - run stuff in a dir where your dist is built

VERSION
       version 4.300020

SYNOPSIS
	 $ dzil run ./bin/myscript
	 $ dzil run prove -bv t/mytest.t
	 $ dzil run bash

DESCRIPTION
       This command will build your dist with Dist::Zilla, then build the distribution and then run a command in the build directory.  It's
       something like doing this:

	 dzil build
	 rsync -avp My-Project-version/ .build/
	 cd .build
	 perl Makefile.PL	     # or perl Build.PL
	 make			     # or ./Build
	 export PERL5LIB=$PWD/blib/lib:$PWD/blib/arch
	 <your command as defined by rest of params>

       Except for the fact it's built directly in a subdir of .build (like .build/69105y2).

       A command returning with an non-zero error code will left the build directory behind for analysis, and "dzil" will exit with a non-zero
       status.	Otherwise, the build directory will be removed and dzil will exit with status zero.

       If no run command is provided, a new default shell is invoked. This can be useful for testing your distribution as if it were installed.

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-06-21				       Dist::Zilla::App::Command::run(3pm)