Whatpm (beta)

Introduction

Whatpm is a work-in-progress set of Perl modules for Web hypertext application technologies. It is part of the manakai project.

Modules

Whatpm::CacheManifest

An HTML5 cache manifest parser.

Whatpm::Charset::UniversalCharDet

A Perl interface to universalchardet character encoding detection library.

Whatpm::ContentChecker

A DOM5 HTML (in-memory representation of a document) conformance checker with a partial support for Atom 1.0. (See also demo.)

Whatpm::ContentType

An implementation of HTML5 Content Type sniffing algorithm.

Whatpm::CSS::Cascade

A media-independent implementation of CSS cascading and value computation. (See also demo.)

Whatpm::CSS::Parser

A CSS parser that constructs CSSOM trees from style sheets. (See also demo.)

Whatpm::CSS::SelectorsParser

A group of selectors parser. (See also demo.)

Whatpm::CSS::SelectorsSerializer

A group of selectors serializer. (See also specification and demo.)

Whatpm::CSS::Tokenizer

A CSS tokenizer. (See also demo.)

Whatpm::HTML

An implementation of HTML5 document and fragment parsing algorithms. It can be used to convert an arbitrary string into a DOM. (See also demo.)

Whatpm::HTML::Serializer

An implementation of HTML5 fragment serialization algorithm. (See also demo.)

Whatpm::HTMLTable

An implementation of the HTML5 table algorithm. It can be used to extract a table structure from a DOM table element node. (See also demo.)

Whatpm::IMTChecker

An Internet Media Type (aka MIME type) label conformance checker.

Whatpm::URIChecker

An IRI reference conformance checker.

Whatpm::WebIDL

A WebIDL fragment parser. It parses an IDL fragment, whether conforming or not, and constructs a DOM-like object model for further processing. Non-conforming (or broken) IDL fragment-like string will be parsed using CSS-like error-tolerant parsing rules, e.g. ignoring anything until next ; character.

Whatpm::LangTag

A language tag parser and conformance checker, supporting both older RFC 3066 definition and latest RFC 4646 definition. (See also demo.)

Whatpm::XMLSerializer

A simple XML serializer.

Note that all of these modules are work in progress and have a number of unresolved problems.

Note also that some modules have no documentation for now.

Specifications

SSFT Specification

The specification for the serialization format used for testing Selectors-related modules.

manakai's Selectors Extensions

The specification for :-manakai-* pseudo-classes implemented by Selectors-related modules.

Documentations

List of error types

Description of errors to be notified to callback functions by Whatpm modules.

Selectors object

Description of data structure for Selectors, as implemented by Whatpm::CSS::SelectorsParser (as output), and Whatpm::CSS::SelectorsSerializer (as input).

List of predefined user data names

List of user data names defined by Whatpm modules.

Handle objects

Description of character or byte stream input handle interfaces.

Demo

• HTML5 parser and checker demo (source, with a lightweight non-conforming DOM implementation)
• HTML5 parser and checker demo, with manakai's DOM implementation (source)
• HTML5 table structure visualization demo (source)
• CSS tokenizer, parser, and computed style computation demo (source)
• Language tag parsing and conformance checking demo (source)

Application

• WebHACC (Web hypertext application conformance checker)

Dependency

Perl 5.8 or later

It is recommended to use newer stable release of Perl 5.8 (or later).

Some modules require Encode modules, which are part of standard Perl distribution.

Modules from manakai-core

Error

Module Whatpm::HTML requires Error, which is bundled in manakai-core.

Message::IMT::InternetMediaType

Module Whatpm::IMTChecker depends on Message::IMT::InternetMediaType, which is part of manakai-core.

Message::URI::URIReference

Modules Whatpm::URIChecker and Whatpm::CacheManifest depend on Message::URI::URIReference, which is part of manakai-core.

Message::Charset::Info

Module Whatpm::ContentChecker depends on Message::Charset::Info, which is part of manakai-core.

Message::DOM::DOMImplementation

Module Whatpm::URIChecker depends on Message::DOM::DOMImplementation, which is part of manakai-core.

Message::DOM::DOMImplementation and related modules

Testing for module Whatpm::ContentChecker depends on Message::DOM::DOMImplementation and related modules in manakai-core. They are not required in practice.

manakai charlib

Module Whatpm::Charset::DecodeHandle depends on modules in manakai charlib for decoding of Japanese character encodings. See the documentation for manakai charlib for more information.

Python, Perl Inline::Python module, and Universal Encoding Detector

For the module Whatpm::Charset::UniversalCharDet being meaningful, these softwares are required on the system. See the documentation for more information.

JSON

Testing for modules Whatpm::HTML and Whatpm::CSS::Tokenizer depends on JSON and related modules. They are not required in practice.

Distribution

The development version of Whatpm may be found in the CVS repository.

The latest developmenet version of the Whatpm is also available as a tarball.

TO DO

• Bug fix (Test results: Whatpm::ContentType, HTML tokenization, HTML tree construction, Whatpm::ContentChecker).
• Merge with the manakai-core code tree.
• Charset detection.
• Validation for meta.
• Validation for media queries, IRIs (against URI schemes), language tags, and so on.
• Documentations are missing for some features.
• XML parser.
• In addition, each module has its own TO DO items. (Search for ## TODO and ## ISSUE in each module.)

Acknowledgments

Thanks to the html5lib team for their HTML5 parser test data.

Author

Wakaba.

License

Copyright 2007‐2008 Wakaba <w@suika.fam.cx>.

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