codeblocks 0.1.1.post1

Extract and process code blocks from markdown files.

codeblocks

Extract and process code blocks from markdown files.

Examples

Extract Python code blocks:

codeblocks --python README.md

Check formatting of Python code blocks with black:

codeblocks --python README.md | black --check -

Reformat Python code blocks with black, in place:

codeblocks --python README.md -- black -

Type check Python code blocks with mypy:

mypy somemodule anothermodule <(codeblocks --python README.md)

Full type checking example

def plus(x: int, y: int) -> int:
    return x + y

plus(1, '2')

$ mypy --pretty --strict <(codeblocks --python README.md)
/dev/fd/63:5: error: Argument 2 to "plus" has incompatible type "str"; expected "int"
        plus(1, '2')
                ^
Found 1 error in 1 file (checked 1 source file)

TODO

• protect against empty (and weird?) in-place modifications
• use same regex for both modes
• example for pytest
• automatically add async for functions with await in them
• support other languages
• use proper markdown parser
• support multiple files

Related

• https://github.com/nschloe/excode
• https://github.com/jonschlinkert/gfm-code-blocks
• blacken-docs (does not support black --check)
• prettier works out of the box for supported languages (PR)