4 releases
0.1.0-alpha4 | Jul 16, 2020 |
---|---|
0.1.0-alpha3 | Jul 15, 2020 |
0.1.0-alpha2 | Feb 27, 2019 |
0.1.0-alpha1 | Jan 5, 2019 |
#2039 in Parser implementations
6,212 downloads per month
Used in 5 crates
7KB
104 lines
Matter
A universal frontmatter parser and extractor, written in Rust.
Installation
By default, matter is installed with support for TOML, YAML, and JSON frontmatter formats. However, you can override the defaults and install support for one specific format like so:
matter = { version = "0.1.0-alpha3", features = ["toml"] }
Usage
Once installed, you'll notice that Matter exports only a handful of functions. This is because it does most of the work for you. It also attempts to operate with minimal overhead, by only allocating as necessary.
let input = std::fs::read_to_string("./path/to/content.md").unwrap();
let Some((matter, content)) = matter::extract(&input).unwrap();
See the docs for more examples.
CLI
Matter is also distributed as a command line application. Install (cargo install matter --version 0.1.0-alpha3
) and run to inspect any file's frontmatter:
matter path/to/content.md
License
Copyright 2018 Nicholas Young, All rights reserved. Released under a 3-Clause BSD License.
Dependencies
~2.2–3MB
~54K SLoC