/ 
Plack-App-DAIA-0.45
River stage zero No dependents
⭐ Starred 2 GitHub stars
/ provedaia

NAME

provedaia - run DAIA test suites

VERSION

version 0.45

SYNOPSIS

provedaia [<OPTIONS>] [<FILES>]

Options:
  -?|-h|--help          show this help
  --version             show version
  --server URL-or-file  set base URL of DAIA server or load PSGI script
  --end                 skip everything until __END__ in input
  --combined            use files as both, server and test suite
  --verbose             more diagnostic messages

DESCRIPTION

This script can be used to test DAIA servers. It is based on the package Plack::App::DAIA::Test::Suite, so the output of this script conforms to the Test Anything Protocol (TAP). You can provide a full test script or a DAIA server that contains its own test suite after the __END__ marker. If no file is provided, it is read from standard input. See the bottom of examples/daia-ubbielefeld.pl for an example.

A typical usage scenario for this script is:

  • You implement a DAIA server, for instance in myapp.psgi and run it, for instance a http://localhost:5000/.

  • You write some test suites for the DAIA server, for instance in test1.txt and test2.txt. These tests are sets of document identifiers and (partial) responses which you expect your server to return. A description of the test format is given in Plack::App::DAIA::Test::Suite.

  • You run provedaia as

    provedaia --server myapp.psgi test1.txt test2.txt

    or as

    provedaia --server http://localhost:5000/ test1.txt test2.txt

    If you server implementation contains its own test suite, you can also call

    provedaia --combined myapp.psgi

AUTHOR

Jakob Voss

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Jakob Voss.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.