Test::Synopsis is an (author) test module to find .pm or .pod files under your lib directory and then make sure the example snippet code in your SYNOPSIS section passes the perl compile check.
Note that this module only checks the perl syntax (by wrapping the code with 'sub') and doesn't actually run the code, UNLESS that code is a 'BEGIN {}' block or a 'use' statement.
Suppose you have the following POD in your module.
=head1 NAME
Awesome::Template - My awesome template
=head1 SYNOPSIS
use Awesome::Template; my $template = Awesome::Template->new; $tempalte->render("template.at");
=head1 DESCRIPTION
An user of your module would try copy-paste this synopsis code and find that this code doesn't compile because there's a typo in your variable name $tempalte. Test::Synopsis will catch that error before you ship it.
Package Version | Update ID | Released | Package Hub Version | Platforms | Subpackages |
---|---|---|---|---|---|
0.17-bp156.2.1 info | GA Release | 2023-07-22 | 15 SP6 |
|
|
0.17-bp155.1.4 info | GA Release | 2023-05-17 | 15 SP5 |
|
|
0.16-bp154.1.18 info | GA Release | 2022-05-09 | 15 SP4 |
|
|
0.15-bp153.1.14 info | GA Release | 2021-03-06 | 15 SP3 |
|
|
0.15-bp152.3.13 info | GA Release | 2020-04-16 | 15 SP2 |
|
|
0.15-bp151.3.1 info | GA Release | 2019-07-17 | 15 SP1 |
|
|
0.15-bp151.2.12 info | GA Release | 2019-05-18 | 15 SP1 |
|
|
0.15-bp150.2.4 info | GA Release | 2018-07-30 | 15 |
|
|