Barbie > Test-XHTML > Test::XHTML::Valid

Download:
Test-XHTML-0.12.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.12   Source  

NAME ^

Test::XHTML::Valid - test web page DTD validation.

SYNOPSIS ^

    my $txv = Test::XHTML::Valid->new();

    $txv->ignore_list(@IGNORE);             # patterns to ignore

    # dynamic pages
    $txv->process_root($opt{url});          # test all pages beneath root
    $txv->process_link($opt{link});         # test single link
    $txv->process_url_list($opt{ulist});    # test list of links

    # static pages
    $txv->process_path($opt{path});         # test all files within path
    $txv->process_file($opt{file});         # test single file
    $txv->process_file_list($opt{flist});   # test list of files

    # XML strings
    $txv->process_xml($xml);                # test XML as a string

    $txv->process_retries();                # retest any network failures
    my $results = $txv->process_results();

    $txv->content();            # for further testing of single page content
    $txv->errors();             # all current errors reported
    $txv->clear();              # clear all current errors and results

    $txv->retrieve_url($url);   # retrieve URL, no testing required
    $txv->retrieve_file($file); # retrieve file, no testing required

    $txv->logfile($file);       # logfile for verbose messages
    $txv->logclean(1);          # 1 = create/overwrite, 0 = append (default)

DESCRIPTION ^

Using either URLs or flat files, this module attempts to validate web pages according to the DTD schema specified within each page.

METHODS ^

Constructor

Enables test object to retain content, results and errors as appropriate.

new()

Creates and returns a Test::XHTML::Valid object.

Public Methods

ignore_list(@LIST)

Patterns to ignore.

process_root(URL)

Test all pages beneath root URL.

process_link(URL)

Test a single link.

process_url_list(FILE)

Test list of links contained in FILE (one per line).

process_path(PATH)

Test all files within the local directory path.

process_file(FILE)

Test a single file.

process_file_list(FILE)

Test list of files contained in FILE (one per line).

process_xml(XML)

Test a single XML string, which is assumed to be a complete XHTML file.

process_retries()

Retest any network failures.

process_results()

Record results to log file (if given) and returns a hashref.

content()

Returns the single page content of the last processed page. Useful if required for further testing.

errors()

Returns all the current errors reported as XML::LibXML::Error objects.

errstr()

Returns all the current errors reported as a single string.

clear()

Clear all current errors and results.

retrieve_url(URL)

Retrieve URL, no testing required.

retrieve_file(FILE)

Retrieve FILE, no testing required.

logfile(FILE)

Set output log file for verbose messages.

logclean(STATE)

Set STATE to 1 (create/overwrite) or 0 (append - the default)

BUGS, PATCHES & FIXES ^

There are no known bugs at the time of this release. However, if you spot a bug or are experiencing difficulties, that is not explained within the POD documentation, please send bug reports and patches to barbie@cpan.org.

Fixes are dependent upon their severity and my availability. Should a fix not be forthcoming, please feel free to (politely) remind me.

SEE ALSO ^

XML::LibXML

AUTHOR ^

  Barbie, <barbie@cpan.org>
  for Miss Barbell Productions <http://www.missbarbell.co.uk>.

COPYRIGHT AND LICENSE ^

  Copyright (C) 2008-2013 Barbie for Miss Barbell Productions.

  This distribution is free software; you can redistribute it and/or
  modify it under the Artistic Licence v2.
syntax highlighting: