.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Dist::Zilla::App::Command::xtest 3pm"
.TH Dist::Zilla::App::Command::xtest 3pm "2022-12-06" "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Dist::Zilla::App::Command::xtest \- run xt tests for your dist
.SH "VERSION"
.IX Header "VERSION"
version 0.029
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
Run xt tests for your distribution:
.PP
.Vb 1
\&  dzil xtest [ \-\-no\-author] [ \-\-no\-release ] [ \-\-no\-automated ] [ \-\-all ]
.Ve
.PP
This runs with \s-1AUTHOR_TESTING\s0 and \s-1RELEASE_TESTING\s0 environment variables turned
on, so it's like doing this:
.PP
.Vb 8
\&  export AUTHOR_TESTING=1
\&  export RELEASE_TESTING=1
\&  dzil build
\&  rsync \-avp My\-Project\-Version/ .build/
\&  cd .build;
\&  perl Makefile.PL
\&  make
\&  prove \-l \-r xt
.Ve
.PP
Except for the fact it's built directly in a subdir of .build (like
\&\fI.build/ASDF123\fR).
.PP
A build that fails tests will be left behind for analysis, and \fIdzil\fR will
exit a non-zero value.  If the tests are successful, the build directory will
be removed and \fIdzil\fR will exit with status 0.
.PP
You can also use 'xt' as an alias for 'xtest':
.PP
.Vb 1
\&  dzil xt
.Ve
.PP
If you provide one or more filenames on the command line, only
those tests will be run (however deeply they are nested).
.PP
.Vb 1
\&  dzil xtest pod\-spell.t
.Ve
.PP
Arguments are turned into regexp patterns, so you can
do any sort of partial match you want:
.PP
.Vb 2
\&  dzil xtest author/    # just the author tests
\&  dzil xtest spell      # a test with \*(Aqspell\*(Aq in the path
.Ve
.PP
There is no need to add anything to \fIdist.ini\fR \*(-- installation of this module
is sufficient to make the command available.
.SH "OPTIONS"
.IX Header "OPTIONS"
.SS "\-\-no\-author"
.IX Subsection "--no-author"
This will run the test suite without setting \s-1AUTHOR_TESTING\s0
.SS "\-\-no\-release"
.IX Subsection "--no-release"
This will run the test suite without setting \s-1RELEASE_TESTING\s0
.SS "\-\-automated"
.IX Subsection "--automated"
This will run the test suite with AUTOMATED_TESTING=1
.SS "\-\-all"
.IX Subsection "--all"
Equivalent to \-\-release \-\-automated \-\-author
.SH "AUTHORS"
.IX Header "AUTHORS"
.IP "\(bu" 4
David Golden <dagolden@cpan.org>
.IP "\(bu" 4
Jesse Luehrs <doy@cpan.org>
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
This software is Copyright (c) 2016 by David Golden.
.PP
This is free software, licensed under:
.PP
.Vb 1
\&  The Apache License, Version 2.0, January 2004
.Ve