The microformats2-parser package

Properties

Versions	0.1.0, 0.1.1, 1.0.0, 1.0.1, 1.0.1.1, 1.0.1.2, 1.0.1.3, 1.0.1.4, 1.0.1.5
Change log	None available
Dependencies	aeson, aeson-pretty, aeson-qq, attoparsec, base (>=4.7.0.0 && <5), base-compat (>=0.8.0), blaze-html, blaze-markup, bytestring, containers, data-default, either, errors, html-conduit, lens-aeson, microformats2-parser, network, network-uri, options, pcre-heavy, safe, scotty, streaming-commons, tagsoup, text, time, transformers, unordered-containers, vector, wai-extra, warp, xml-lens, xss-sanitize [details]
License	PublicDomain
Copyright	2015 Greg V <[email protected]>
Author	Greg V
Maintainer	[email protected]
Category	Web
Home page	https://github.com/myfreeweb/microformats2-parser
Source repository	head: git clone git://github.com/myfreeweb/microformats2-parser.git
Executables	microformats2-parser
Uploaded	Thu Mar 24 18:30:57 UTC 2016 by myfreeweb
Distributions	LTSHaskell:1.0.1.5, NixOS:1.0.1.5, Stackage:1.0.1.5
Downloads	380 total (18 in last 30 days)
Votes	1 []
Status	Docs pending Build status unknown [no reports yet]

Modules

Data
- Microformats2
  - Data.Microformats2.Parser
    - Data.Microformats2.Parser.Date
    - Data.Microformats2.Parser.HtmlUtil
    - Data.Microformats2.Parser.Property
    - Data.Microformats2.Parser.Util

Downloads

microformats2-parser-1.0.1.5.tar.gz [browse] (Cabal source package)
Package description (included in the package)

Maintainers' corner

For package maintainers and hackage trustees

edit package information

Readme for microformats2-parser-1.0.1.5

microformats2-parser

Microformats 2 parser for Haskell! #IndieWeb

Originally created for sweetroll.

parses items, rels, rel-urls
resolves relative URLs (with support for the <base> tag), including inside of html for e-* properties
parses the value-class-pattern, including date and time normalization
handles malformed HTML (the actual HTML parser is tagstream-conduit)
high performance
extensively tested

Also check out http-link-header because you often need to read links from the Link header!

DEMO PAGE

Usage

Look at the API docs on Hackage for more info, here's a quick overview:

{-# LANGUAGE OverloadedStrings #-}

import Data.Microformats2.Parser
import Data.Default
import Network.URI

parseMf2 def $ documentRoot $ parseLBS "<body><p class=h-entry><h1 class=p-name>Yay!</h1></p></body>"

parseMf2 (def { baseUri = parseURI "https://where.i.got/that/page/from/" }) $ documentRoot $ parseLBS "<body><base href=\"base/\"><link rel=micropub href='micropub'><p class=h-entry><h1 class=p-name>Yay!</h1></p></body>"

The def is the default configuration.

The configuration includes:

htmlMode, an HTML parsing mode (Unsafe | Escape | Sanitize)
baseUri, the Maybe URI that represents the address you retrieved the HTML from, used for resolving relative addresses -- you should set it

parseMf2 will return an Aeson Value structured like canonical microformats2 JSON. lens-aeson is a good way to navigate it.

Development

Use stack to build.
Use ghci to run tests quickly with :test (see the .ghci file).

$ stack build

$ stack test

$ stack ghci

Contributing

Please feel free to submit pull requests! Bugfixes and simple non-breaking improvements will be accepted without any questions :-)

By participating in this project you agree to follow the Contributor Code of Conduct.

The list of contributors is available on GitHub.

License

This is free and unencumbered software released into the public domain.
For more information, please refer to the UNLICENSE file or unlicense.org.