Test::HTML::Spelling - spelling of HTML documents
version v0.4.0
use Test::More; use Test::HTML::Spelling; use Test::WWW::Mechanize; my $sc = Test::HTML::Spelling->new( ignore_classes => [qw( no-spellcheck )], check_attributes => [qw( title alt )], ); $sc->speller->set_option('lang','en_GB'); $sc->speller->set_option('sug-mode','fast'); my $mech = Test::WWW::Mechanize->new(); $mech->get_ok('http://www.example.com/'); $sc->spelling_ok($mech->content, "spelling"); done_testing;
This module parses an HTML document, and checks the spelling of the text and some attributes (such as the title and alt attributes).
title
alt
It will not spellcheck the attributes or contents of elements (including the contents of child elements) with the class no-spellcheck. For example, elements that contain user input, or placenames that are unlikely to be in a dictionary (such as timezones) should be in this class.
no-spellcheck
It will fail when an HTML document is not well-formed.
This is an accessor method for the names of element classes that will not be spellchecked. It is also a constructor parameter.
It defaults to no-spellcheck.
This is an accessor method for the names of element attributes that will be spellchecked. It is also a constructor parameter.
It defaults to title and alt.
This is an accessor method for setting a hash of words that will be ignored by the spellchecker. Use it to specify a custom dictionary, e.g.
use File::Slurp; my %dict = map { chomp($_); $_ => 1 } read_file('custom'); $sc->ignore_words( \%dict );
my $sc = $sc->speller($lang);
This is an accessor that gives you access to a spellchecker for a particular language (where $lang is a two-letter ISO 639-1 language code). If the language is omitted, it returns the default spellchecker:
$lang
$sc->speller->set_option('sug-mode','fast');
Note that options set for the default spellchecker will not be set for other spellcheckers. To ensure all spellcheckers have the same options as the default, use something like the following:
foreach my $lang (qw( en es fs )) { $sc->speller($lang)->set_option('sug-mode', $sc->speller->get_option('sug-mode') ) }
my @langs = $sc->langs;
Returns a list of languages (as two-letter ISO 639-1 codes) that there are spellcheckers for.
This can be checked after testing a document to ensure that the document does not contain markup in unexpected languages.
if ($sc->check_spelling( $content )) { .. }
Check the spelling of a document, and return true if there are no spelling errors.
$sc->spelling_ok( $content, $message );
Parses the HTML file and checks the spelling of the document text and selected attributes.
Suppose you subclass a module like Test::WWW::Mechanize and add a spelling_ok method that calls "spelling_ok". This will work fine, except that any errors will be reported as coming from your module, rather than the test scripts that call your method.
spelling_ok
To work around this, call the "check_spelling" method from within your module.
The following modules have similar functionality:
The development version is on github at https://github.com/robrwo/Test-HTML-Spelling and may be cloned from git://github.com/robrwo/Test-HTML-Spelling.git
Please report any bugs or feature requests on the bugtracker website https://github.com/robrwo/Test-HTML-Spelling/issues
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
Robert Rothenberg <rrwo@cpan.org>
Interactive Information, Ltd <cpan@interactive.co.uk>
Murray Walker <perl@minty.org>
Rusty Conover <rusty@luckydinosaur.com>
Shlomi Fish <shlomif@shlomifish.org>
This software is Copyright (c) 2012-2018 by Robert Rothenberg.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
To install Test::HTML::Spelling, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Test::HTML::Spelling
CPAN shell
perl -MCPAN -e shell install Test::HTML::Spelling
For more information on module installation, please visit the detailed CPAN module installation guide.