An mdformat plugin for...
Project description
mdformat-openmmlab
An mdformat plugin for OpenMMLab standard.
How to use it
Add the follow section to .pre-commit-config.yaml
:
- repo: https://github.com/executablebooks/mdformat
# To be compatible with Python 3.6, specify the version here.
rev: 0.7.9
hooks:
- id: mdformat
args: ["--number", "--table-width", "200"]
additional_dependencies:
- mdformat-openmmlab
- mdformat_frontmatter
- linkify-it-py
The argument --table-width
is used to limit the max width of tables.
If you want to avoid escaping some symbols, you can use --disable-escape
and specify the symbols to skip.
For example, to avoid escaping backslash (\
) and uri-enclosure (<
).
- repo: https://github.com/executablebooks/mdformat
# To be compatible with Python 3.6, specify the version here.
rev: 0.7.9
hooks:
- id: mdformat
args: ["--number", "--table-width", "200", "--disable-escape", "backslash", "uri-enclosure"]
additional_dependencies:
- "mdformat-openmmlab>=0.0.2"
- mdformat_frontmatter
- linkify-it-py
Here are available options:
backslash
(\
)asterisk
(*
)underscore
(_
)link-enclosure
([
and]
)uri-enclosure
(<
)
ATTENTION: This plugin already include all functionalities of mdformat-gfm
and mdformat-tables
, and is
not compatible with them, please don't install them again.
Development
This package utilises 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
.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for mdformat_openmmlab-0.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b2d5ddb3450d04b1b231bbafd57c343058cbdbbe5de513876dedb16682e82a3e |
|
MD5 | c0f0cff87807a22da8c9db362991b570 |
|
BLAKE2b-256 | badd2b3c398ad9f441f04c84fe0f33826fbd8391311a39f4c3bdb5b5a6bf4b94 |