=pod

=encoding utf8

=head1 NAME

App::Prove::Plugin::SetEnv - A prove plugin to set environment variables

=head1 SYNOPSIS

  # command-line usage using shell expansion
  prove -PSetEnv=TZ=UTC,PATH="./bin:$PATH"

  # command-line usage using String::Expand expansion
  prove -PSetEnv=TZ=UTC,PATH='./bin:$PATH'

=head1 DESCRIPTION

This L<prove> plugin lets you set environment variables for your test scripts.
It expands environment variables using L<String::Expand>. This is particularly
handy in F<.proverc>.

=head1 CAVEAT

Due to the way L<App::Prove> splits arguments to plugins, it is not
possible to set values containing commas.

=head1 SEE ALSO

=over 2

=item *

L<App::Prove/PLUGINS>

=back

=head1 AUTHORS

Sven Willenbuecher <sven.willenbuecher@gmx.de>

Dagfinn Ilmari Mannsåker <ilmari@photobox.com>

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2025 by Sven Willenbuecher.

This software is copyright (c) 2012-2025 by PhotoBox Limited.

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

=cut
