NAME

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

VERSION

version 6.012

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