Html Types

Html data structures for rust.

Motivation

To provide data types that will make it easier to test views. Ultimately allowing render functions that return Nodes or similar to be compared against data structures, rather than strings.

This could also be helpful when constructing future templating/macro based html generators. As they could focus on building these trees, rather than string types, leaving rendering to something else.

Design

Currently the types try to be as open as possible, allowing the end-user to manipulate the tree however they see fit. However they will not be able to create a tree that is invalid

Currently implements a general shape over html, covering text nodes, comment nodes, and element nodes. Element nodes can be void or non-void.

See tests for usage examples

Also note that rendering uses the public interfaces entirely, so the tree can be rendered to other data types if necessary, though a string rendering module is included.

Node/Elements

Node and Elements are general purpose, and mostly complete now. You should be able to cover most HTML generation purposes using these, though they expect you to understand the rules of how to properly order it.

Semantic Module

This semantic module is still in development, but the examples show it's motivation. Semantic elements have rules around there construction, and have attributes/children that make sense.

There is still a large amount of work to do in this module, expanding it out.

This module will probably never cover 'all' use cases of html, eg strange tags/combinations people may use, but the aim is to cover must as possible.

Note: These items are always convertible to elements It would be possible to convert back (with failures). Though this would be along way From being implemented.

Pretty Printing

While this is optional, I currently don't plan on implementing it. This would be a good candidate for a Pull request.

Testing

As everything is rust datastructures, it is easy to write tests. Ideally this will evolve into a html library with extensive testing