David Dorward > Catalyst-TraitFor-View-MarkupValidation-0.003 > Catalyst::TraitFor::View::MarkupValidation

Download:
Catalyst-TraitFor-View-MarkupValidation-0.003.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.003   Source  

NAME ^

Catalyst::TraitFor::View::MarkupValidation - Validates output and replaces it with an error report if not OK

SYNOPSIS ^

    package Catalyst::View::Validation;

    use Moose;
    use namespace::autoclean;

    extends qw/Catalyst::View::TT/;
    with qw/Catalyst::TraitFor::View::MarkupValidation/;

    __PACKAGE__->config(MARKUP_VALIDATOR_URI => q[http://localhost/w3c-validator/check]);

    1;

DESCRIPTION ^

This is a Role which which takes generated content that is ready for output and validates it. If there are errors it replaces the default output with an error report.

CONFIGURATION ^

You must set the MARKUP_VALIDATOR_URI to the URI for an instance of the W3C Markup Validation Service. You are encouraged to install a local instance of the validator so that you see high levels of performance and do not hammer the public server (which is funded by donations).

See http://validator.w3.org/source/ for downloads and installation instructions on a variety of platforms.

CAVEATS ^

This is useful when you're developing your application, as it will identify validity errors in the markup. In production, however, the performance cost is likely to be too high, and throwing errors at users that browsers could probably recover from is unfriendly.

This module checks that Catalyst is running in debug mode and will not run if it is not.

METHOD MODIFIERS ^

after process

Validates document and (in event of an error) replaces it with an error report.

TODO ^

Make document types that get validated configurable
Add line numbering to output
Hyperlink from error to source

BUGS AND LIMITATIONS ^

Please report any you find using RT.

If URI to validation service is incorrect, shows error report w/ 0 errors.

AUTHOR ^

David Dorward (dorward) <david@dorward.me.uk>

CONTRIBUTORS ^

Tomas Doran (t0m) <bobtfish@bobtfish.net>

LICENSE AND COPYRIGHT ^

This module itself is copyright (c) 2009 David Dorward and is licensed under the same terms as Perl itself.

syntax highlighting: