---
name: "Dist::Zilla::App::Command::xtest"
section: "3pm"
platform: "linux"
package: "libdist-zilla-plugin-checkextratests-perl"
version: "0.029-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Dist::Zilla::App::Command::xtest"
---

# Dist::Zilla::App::Command::xtest(3pm)

run xt tests for your dist

## NAME

Dist::Zilla::App::Command::xtest - run xt tests for your dist

## VERSION

version 0.029

## SYNOPSIS

Run xt tests for your distribution:

```
  dzil xtest [ --no-author] [ --no-release ] [ --no-automated ] [ --all ]
```

This runs with AUTHOR\_TESTING and RELEASE\_TESTING environment variables turned on, so it's like doing this:

```
  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
```

Except for the fact it's built directly in a subdir of .build (like *.build/ASDF123*).

A build that fails tests will be left behind for analysis, and *dzil* will exit a non-zero value.  If the tests are successful, the build directory will be removed and *dzil* will exit with status 0.

You can also use 'xt' as an alias for 'xtest':

```
  dzil xt
```

If you provide one or more filenames on the command line, only those tests will be run (however deeply they are nested).

```
  dzil xtest pod-spell.t
```

Arguments are turned into regexp patterns, so you can do any sort of partial match you want:

```
  dzil xtest author/    # just the author tests
  dzil xtest spell      # a test with 'spell' in the path
```

There is no need to add anything to *dist.ini* -- installation of this module is sufficient to make the command available.

## OPTIONS

### --no-author

This will run the test suite without setting AUTHOR\_TESTING

### --no-release

This will run the test suite without setting RELEASE\_TESTING

### --automated

This will run the test suite with AUTOMATED\_TESTING=1

### --all

Equivalent to --release --automated --author

## AUTHORS

- •

  David Golden \<dagolden@cpan.org\>

- •

  Jesse Luehrs \<doy@cpan.org\>

## COPYRIGHT AND LICENSE

This software is Copyright (c) 2016 by David Golden.

This is free software, licensed under:

```
  The Apache License, Version 2.0, January 2004
```