1Dist::Zilla::Dist::BuilUdseerr(3C)ontributed Perl DocumeDnitsatt:i:oZnilla::Dist::Builder(3)
2
6 Dist::Zilla::Dist::Builder - dist zilla subclass for building dists
7
9 version 6.023
10
12 This module should work on any version of perl still receiving updates
13 from the Perl 5 Porters. This means it should work on any version of
14 perl released in the last two to three years. (That is, if the most
15 recently released version is v5.40, then this module should work on
16 both v5.40 and v5.38.)
17 Although it may work on older versions of perl, no guarantee is made
19 that the minimum required version will not be increased. The version
20 may be increased for any reason, and there is no promise that patches
21 will be accepted to lower the minimum required perl.
22
24 built_in
25 This is the Path::Tiny, if any, in which the dist has been built.
26
28 from_config
29 my $zilla = Dist::Zilla->from_config(\%arg);
30 This routine returns a new Zilla from the configuration in the current
32 working directory.
33 This method should not be relied upon, yet. Its semantics are certain
35 to change.
36 Valid arguments are:
38 config_class - the class to use to read the config
40 default: Dist::Zilla::MVP::Reader::Finder
41 build_in
43 $zilla->build_in($root);
44 This method builds the distribution in the given directory. If no
46 directory name is given, it defaults to DistName-Version. If the
47 distribution has already been built, an exception will be thrown.
48 build
50 This method just calls "build_in" with no arguments. It gets you the
51 default behavior without the weird-looking formulation of "build_in"
52 with no object for the preposition!
53 ensure_built_in
55 $zilla->ensure_built_in($root);
56 This method behaves like "build_in", but if the dist is already built
58 in $root (or the default root, if no root is given), no exception is
59 raised.
60 ensure_built
62 This method just calls "ensure_built_in" with no arguments. It gets
63 you the default behavior without the weird-looking formulation of
64 "ensure_built_in" with no object for the preposition!
65 dist_basename
67 my $basename = $zilla->dist_basename;
68 This method will return the dist's basename (e.g. "Dist-Name-1.01".
70 The basename is used as the top-level directory in the tarball. It
71 does not include "-TRIAL", even if building a trial dist.
72 archive_filename
74 my $tarball = $zilla->archive_filename;
75 This method will return the filename (e.g. "Dist-Name-1.01.tar.gz") of
77 the tarball of this distribution. It will include "-TRIAL" if building
78 a trial distribution, unless the version contains an underscore. The
79 tarball might not exist.
80 build_archive
82 $zilla->build_archive;
83 This method will ensure that the dist has been built, and will then
85 build a tarball of the build directory in the current directory.
86 release
88 $zilla->release;
89 This method releases the distribution, probably by uploading it to the
91 CPAN. The actual effects of this method (as with most of the methods)
92 is determined by the loaded plugins.
93 clean
95 This method removes temporary files and directories suspected to have
96 been produced by the Dist::Zilla build process. Specifically, it
97 deletes the .build directory and any entity that starts with the dist
98 name and a hyphen, like matching the glob "Your-Dist-*".
99 ensure_built_in_tmpdir
101 $zilla->ensure_built_in_tmpdir;
102 This method will consistently build the distribution in a temporary
104 subdirectory. It will return the path for the temporary build location.
105 install
107 $zilla->install( \%arg );
108 This method installs the distribution locally. The distribution will
110 be built in a temporary subdirectory, then the process will change
111 directory to that subdir and an installer will be run.
112 Valid arguments are:
114 keep_build_dir - if true, don't rmtree the build dir, even if everything
116 seemed to work
117 install_command - the command to run in the subdir to install the dist
118 default (roughly): $^X -MCPAN -einstall .
119 this argument should be an arrayref
121 test
123 $zilla->test(\%arg);
124 This method builds a new copy of the distribution and tests it using
126 "run_tests_in".
127 "\%arg" may be omitted. Otherwise, valid arguments are:
129 keep_build_dir - if true, don't rmtree the build dir, even if everything
131 seemed to work
132 run_tests_in
134 my $error = $zilla->run_tests_in($directory, $arg);
135 This method runs the tests in $directory (a Path::Tiny), which must
137 contain an already-built copy of the distribution. It will throw an
138 exception if there are test failures.
139 It does not set any of the *_TESTING environment variables, nor does it
141 clean up $directory afterwards.
142 run_in_build
144 $zilla->run_in_build( \@cmd );
145 This method makes a temporary directory, builds the distribution there,
147 executes all the dist's BuildRunners (unless directed not to, via
148 "$arg->{build} = 0"), and then runs the given command in the build
149 directory. If the command exits non-zero, the directory will be left
150 in place.
151
153 Ricardo SIGNES 😏 <rjbs@semiotic.systems>
154
156 This software is copyright (c) 2021 by Ricardo SIGNES.
157 This is free software; you can redistribute it and/or modify it under
159 the same terms as the Perl 5 programming language system itself.
160perl v5.34.0 2021-07-22 Dist::Zilla::Dist::Builder(3)