Description:

The Test::Cmd module provides a low-level framework for portable
automated testing of executable commands and scripts (in any language,
not just Perl), especially commands and scripts that interact with the
file system.

The Test::Cmd module makes no assumptions about what constitutes
a successful or failed test. Attempting to read a file that doesn't
exist, for example, may or may not be an error, depending on the
software being tested.

Consequently, no Test::Cmd methods (including the new() method)
exit, die or throw any other sorts of exceptions (but they all do
return useful error indications). Exceptions or other error status
should be handled by a higher layer: a subclass of Test::Cmd, or
another testing framework such as the Test or Test::Simple Perl
modules, or by the test itself.

(That said, see the Test::Cmd::Common module if you want a similar
module that provides exception handling, either to use directly in
your own tests, or as an example of how to use Test::Cmd.)

In addition to running tests and evaluating conditions, the Test::Cmd
module manages and cleans up one or more temporary workspace
directories, and provides methods for creating files and directories
in those workspace directories from in-line data (that is,
here-documents), allowing tests to be completely self-contained. When
used in conjunction with another testing framework, the Test::Cmd
module can function as a fixture (common startup code for multiple
tests) for simple management of command execution and temporary
workspaces.