Run `black` on python code blocks in documentation files
Project description
blacken-docs
Run black
on python code blocks in documentation files.
install
pip install blacken-docs
usage
blacken-docs
provides a single executable (blacken-docs
) which will modify
.rst
/ .md
/ .tex
files in place.
It currently supports the following black
options:
-l
/--line-length
-t
/--target-version
-S
/--skip-string-normalization
Following additional parameters can be used:
-E
/--skip-errors
blacken-docs
will format code in the following block types:
(markdown)
```python
def hello():
print("hello world")
```
(rst)
.. code-block:: python
def hello():
print("hello world")
(latex)
\begin{minted}{python}
def hello():
print("hello world")
\end{minted}
usage with pre-commit
See pre-commit for instructions
Sample .pre-commit-config.yaml
:
- repo: https://github.com/asottile/blacken-docs
rev: v1.4.0
hooks:
- id: blacken-docs
additional_dependencies: [black==...]
Since black
is currently a moving target, it is suggested to pin black
to a specific version using additional_dependencies
.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
blacken_docs-1.4.0.tar.gz
(4.2 kB
view hashes)
Built Distribution
Close
Hashes for blacken_docs-1.4.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a0bf8857219819a91e969b399d3ae160b347acd5acda08023e335e373b5fe6ff |
|
MD5 | c0b8957a8fa78272a30c6dc3cbce0be2 |
|
BLAKE2b-256 | 0440fd759dcb30afbae3b81124489996e939a541a9eba2320a47664617b120c1 |