Test::Inline works very well for testing the SYNOPSIS section and all other snippets of code you mention in your (POD) documentation.