mdformat_frontmatter 0.1.1

An mdformat plugin for parsing / ignoring frontmatter.

mdformat-frontmatter

An mdformat plugin for ensuring that yaml frontmatter is respected. As we are unable to tell the intent of a user if the yaml is incorrectly formatted it will trigger an exception.

This package was built from the template provided by executable books and customized (specifically to separate content PR's from the release cycle).

Development

This package dirver flit as the build engine, and tox for test automation.

To install these development dependencies:

pip install tox

To run the tests:

tox

and with test coverage:

tox -e py37-cov

The easiest way to write tests, is to edit tests/fixtures.md

To run the code formatting and style checks:

tox -e py37-pre-commit

or directly

pip install pre-commit
pre-commit run --all

To run the pre-commit hook test:

tox -e py37-hook

Publish to PyPi

Either use flit directly:

pip install flit
flit publish

or trigger the GitHub Action job, by creating a release with a tag equal to the version, e.g. v0.0.1.

Note, this requires generating an API key on PyPi and adding it to the repository Settings/Secrets, under the name PYPI_KEY.