glentities

An HTML entity encoder/decoder for Gleam.

Entities can be encoded using named or hex entity references. Named entity references use the WHATWG "Named character references" list available at https://html.spec.whatwg.org/multipage/named-characters.html#named-character-references.

Quick start

import glentities

glentities.encode("</html>", glentities.HTMLBody) // "</html>"
glentities.encode("</html>", glentities.Named)    // "<&sol;html>"
glentities.encode("</html>", glentities.Hex)      // "</html>"

glentities.decode("</html>")       // "</html>"
glentities.decode("<&sol;html>")            // "</html>"

Code size

If you import glentities, it will pull in all the encoders and the entire named decoder. Since there are so many different entity names, this will result in a hefty JS payload. If you need to minimise the payload size, prefer importing glentities/decoder or one of the glentities/*_encoder modules directly.

Development

gleam test  # Run the tests

Installation

This package can be added to your Gleam project:

gleam add glentities

and its documentation can be found at https://hexdocs.pm/glentities.