view release on metacpan or  search on metacpan

lib/Chart/EPS_graph/Test.pm  view on Meta::CPAN

C<$foo-E<gt>full_test('/some/dir');>

Then look for both C<foo.eps> and C<foo.eps.png> to be created in C</some/dir/>.

=head1 SUBROUTINES/METHODS

There is but a single method of interest as detailed in the synopsis above.

A special default is in effect if called without C<'/some/dir'> as an argument.
Then output will default to the C</home/your_id> directory on UNIX or the
desktop in Win32 with only the C<foo.eps> (and not the C<foo.eps.png>) being
written there. This default behavior exists to allow for the module to be called
as a test when first building the module freshly downloaded from CPAN.

In the ordinary, user-diven, case (when C</some/dir> is supplied as an argument)
then this module will allow itself a free hand to search for wherever it is that
I<Ghostscript> and/or I<The GIMP> have been installed. It calls the special Perl
module C<File::Find> to do this. It must because those programs may be installed
in various paths depending upon their version number.

But while being built as a brand new module freshly downloaded from CPAN, taint

lib/Chart/EPS_graph/Test.pm  view on Meta::CPAN

files for date, size and content. Based upon what it finds it will return a
string as its pronouncement on the health of C<Chart::EPS_graph> as a module.
That string will contain several lines, all of which should start with "Okay:"
and none of which should start with "Oops!".

=head1 USAGE

Here is the output from calling this test module on the command line on
NetBSD UNIX OS. If, as below, you specify a file path between the parens
the output will be written there. Elsewise it will default to the user's home
directory on UNIX or their desktop on Win32.

C<baal: {666} perl -e "use Chart::EPS_graph::Test; \>

C<print Chart::EPS_graph::Test-E<gt>full_test('/ram');">

C<Testing Chart::EPS_graph.pm in path '/ram' >

C<Okay: File 'foo.eps' has expected first two lines. >

C<Okay: File 'foo.eps' looks fresh: 0 seconds old. >