Quattor::Doc

NAME

Test::Quattor::Doc - Class for unittesting documentation.

DESCRIPTION

This is a class to trigger documentation testing. Should be used mainly as follows:

use Test::Quattor::Doc;
Test::Quattor::Doc->new()->test();

Public methods

  • new

Returns a new object, accepts the following options

  • poddirs

Array reference of directories to test for podfiles. Default dirs are the relative paths target/lib/perl and target/doc/pod (use the exported @DOC_TEST_PATHS list of defaults or resp. $DOC_TARGET_PERL and <$DOC_TARGET_POD>)

  • podfiles

Array reference of podfiles to test (default empty)

  • emptypoddirs

Array reference of poddirs that must be empty (or non-existing). If a directory is in both poddirs and emptypoddirs, if is considered an empty poddir.

  • panpaths

Array reference of paths that hold pan files to check for annotations. Default is target/pan (use the exported $DOC_TARGET_PAN).

  • panout

Output path for pan annotations. Default target/panannotations (use exported $DOC_TARGET_PANOUT).

  • pod_files

Test all files from podfiles and poddirs. Based on all_pod_files_ok from Test::Pod.

Returns array refs of all ok and not ok files.

  • pan_annotations

Generate annotations, return arrayref with templates that have valid annotations and one for templates with invalid annotations.

TODO: Does not require annotations at all nor validates minimal contents.

  • test

Run all tests:

pod_files pan_annotations