Metadata-Version: 2.1
Name: mdformat_pyproject
Version: 0.0.1
Summary: An mdformat plugin for...
Keywords: mdformat,markdown,markdown-it
Author-email: Carles Sala <csala@csail.mit.com>
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: mdformat ~=0.7
Requires-Dist: tomli ~=2.0; python_version < '3.11'
Requires-Dist: pre-commit ; extra == "dev"
Requires-Dist: pytest~=6.0 ; extra == "test"
Requires-Dist: coverage ; extra == "test"
Requires-Dist: pytest-cov ; extra == "test"
Project-URL: Homepage, https://github.com/csala/mdformat-pyproject
Provides-Extra: dev
Provides-Extra: test

# mdformat-pyproject

[![Build Status][ci-badge]][ci-link] [![codecov.io][cov-badge]][cov-link]
[![PyPI version][pypi-badge]][pypi-link]

An [mdformat] plugin to read configuration from `pyproject.toml`.

## Install

Install with:

```bash
pip install mdformat-pyproject
```

## Usage

After installing this plugin, the [mdformat configuration][mdformat-configuration] can be added in
a new `[tool.mdformat]` section inside the `pyproject.toml` file.

```toml
[tool.mdformat]
wrap = "keep"       # possible values: {"keep", "no", INTEGER}
number = false      # possible values: {false, true}
end_of_line = "lf"  # possible values: {"lf", "crlf", "keep"}
```

## Usage as a [pre-commit] hook

Add the following to your `.pre-commit-config.yaml`:

```yaml
- repo: https://github.com/executablebooks/mdformat
  rev: 0.7.13  # Use the ref you want to point at
  hooks:
    - id: mdformat
      additional_dependencies:
        - mdformat-pyproject
```

[ci-badge]: https://github.com/csala/mdformat-pyproject/workflows/CI/badge.svg?branch=master
[ci-link]: https://github.com/csala/mdformat/actions?query=workflow%3ACI+branch%3Amaster+event%3Apush
[cov-badge]: https://codecov.io/gh/csala/mdformat-pyproject/branch/master/graph/badge.svg
[cov-link]: https://codecov.io/gh/csala/mdformat-pyproject
[mdformat]: https://github.com/executablebooks/mdformat
[mdformat-configuration]: https://mdformat.readthedocs.io/en/stable/users/configuration_file.html
[pre-commit]: https://pre-commit.com
[pypi-badge]: https://img.shields.io/pypi/v/mdformat-pyproject.svg
[pypi-link]: https://pypi.org/project/mdformat-pyproject

