NAME

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

VERSION

version 5.009

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) 2014 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.