1Dist::Zilla::App::CommaUnsde:r:rCuonn(t3r)ibuted Perl DoDciusmte:n:tZaitliloan::App::Command::run(3)
2
3
4
6 Dist::Zilla::App::Command::run - run stuff in a dir where your dist is
7 built
8
10 version 6.023
11
13 $ dzil run ./bin/myscript
14 $ dzil run prove -bv t/mytest.t
15 $ dzil run bash
16
18 This command will build your dist with Dist::Zilla, then build the
19 distribution and then run a command in the build directory. It's
20 something like doing this:
21
22 dzil build
23 rsync -avp My-Project-version/ .build/
24 cd .build
25 perl Makefile.PL # or perl Build.PL
26 make # or ./Build
27 export PERL5LIB=$PWD/blib/lib:$PWD/blib/arch
28 <your command as defined by rest of params>
29
30 Except for the fact it's built directly in a subdir of .build (like
31 .build/69105y2).
32
33 A command returning with an non-zero error code will left the build
34 directory behind for analysis, and "dzil" will exit with a non-zero
35 status. Otherwise, the build directory will be removed and dzil will
36 exit with status zero.
37
38 If no run command is provided, a new default shell is invoked. This can
39 be useful for testing your distribution as if it were installed.
40
42 This module should work on any version of perl still receiving updates
43 from the Perl 5 Porters. This means it should work on any version of
44 perl released in the last two to three years. (That is, if the most
45 recently released version is v5.40, then this module should work on
46 both v5.40 and v5.38.)
47
48 Although it may work on older versions of perl, no guarantee is made
49 that the minimum required version will not be increased. The version
50 may be increased for any reason, and there is no promise that patches
51 will be accepted to lower the minimum required perl.
52
54 Ricardo SIGNES 😏 <rjbs@semiotic.systems>
55
57 This software is copyright (c) 2021 by Ricardo SIGNES.
58
59 This is free software; you can redistribute it and/or modify it under
60 the same terms as the Perl 5 programming language system itself.
61
62
63
64perl v5.34.0 2021-07-22 Dist::Zilla::App::Command::run(3)