---
name: "Test2::Formatter::Stream"
section: "3pm"
platform: "linux"
package: "libtest2-harness-perl"
version: "1.000158-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Test2::Formatter::Stream"
---

# Test2::Formatter::Stream(3pm)

Test2 Formatter that directly writes events.

## NAME

Test2::Formatter::Stream - Test2 Formatter that directly writes events.

## DESCRIPTION

This formatter writes all test2 events to event files (one per process/thread) instead of writing them to STDERR/STDOUT. It will output synchronization messages to STDERR/STDOUT every time an event is written. From this data the test output can be properly reconstructed in order with STDERR/STDOUT and events mostly synced so that they appear in the correct order.

This formatter is not usually useful to humans. This formatter is used by Test2::Harness when possible to prevent the loss of data that normally occurs when TAP is used.

## SYNOPSIS

If you really want your test to output this:

```
    use Test2::Formatter::Stream;
    use Test2::V0;
    ...
```

Otherwise just use App::Yath without the `"--no-stream"` argument and this formatter will be used when possible.

## SOURCE

The source code repository for Test2-Harness can be found at *http://github.com/Test-More/Test2-Harness/*.

## MAINTAINERS

- Chad Granum \<exodist@cpan.org\>

  ## AUTHORS

- Chad Granum \<exodist@cpan.org\>

  ## COPYRIGHT

Copyright 2020 Chad Granum \<exodist7@gmail.com\>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See *http://dev.perl.org/licenses/*