Scroll to navigation

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


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


version 6.017


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


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.


Ricardo SIGNES 😏 <>


This software is copyright (c) 2020 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.

2020-11-04 perl v5.30.3