NAME

dada_tester.cgi - a VERY rudimentary runner of Perl automated tests.


VERSION

Refer to the version of Dada Mail you're using - NEVER use a version of this proggy with an earlier or later version of Dada Mail.


USAGE


DESCRIPTION

This small script runs the Perl automated test files that come with Dada Mail. These files are located in the, dada/t directory.

Usually, these files are run using the, prove command like so:

running in a command line, cd'd into the, cgi-bin/dada directory...

 prove -r

If you have the ability to run the Dada Mail tests using the prove command via a command line, that's the best way to do it. This very script is basically a very crude wrapper around that command.


WARNING!

Do Not have this script available for anything but testing. It shouldn't be kept in your cgi-bin/dada/extensions directory with permissions to execute, unless you're actually using it. Any other time, either change the permissions to disallow execution, or remove the script entirely.


SEE ALSO

Dada Mail's automated test suite is much like any other automated test suites for Perl modules and scripts, distributed through CPAN and other means.

Because of this, any and all the advice given about Perl automated tests applies to Dada Mail's own testing suite. Some good articles you may want to read to understand how Perl automated tests work:


DIAGNOSTICS

None, really.


CONFIGURATION AND ENVIRONMENT


DEPENDENCIES

Currently, the server running your Dada Mail is going to have to have at the very least, the Test::Simple and Test::More CPAN modules. Some of the test files require different testing modules to do their job. They'll usually tell you if something's missing.

If the prove utility isn't available, try this:

Find this line in the dada_tester.cgi script:

     print `prove -r -v $Test_Files/$file`;

And comment it out.

Find this line in the dada_tester.cgi script:

    #   print `perl $Test_Files/$file`;

And uncomment it (delete the, '#' character)

and try running the script again.


INCOMPATIBILITIES


BUGS AND LIMITATIONS

Please, let me know if you find any bugs.


AUTHOR

Justin Simoni

See: http://dadamailproject.com/contact


LICENCE AND COPYRIGHT

Copyright (c) 2006-2008 Justin Simoni All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.