snipcheck

Check embedded snippets

MIT License

Downloads
2.7K
Stars
1
Committers
1

Snipcheck

Snipcheck makes sure that the code snippets in markdown files are up-to-date.

This is very much a work in progress. The only function currently available is

checkMarkdownFile :: FilePath -> IO ()

that will run shell snippets and errored out if the output doesn't match the snippet. You can skip some of the output with ....

Example:

# Some title

some markdown content

``` shell
$ echo foo; echo bar; echo baz; echo qux
foo
...
qux
```

some more content

Release check-list

  1. Make sure you're on master

  2. Bump the version in snipcheck.cabal:

Given a version number MAJOR.MINOR.PATCH, increment the:

MAJOR version when you make incompatible API changes, MINOR version when you add functionality in a backwards-compatible manner, and PATCH version when you make backwards-compatible bug fixes.

  1. Run cabal sdist and cabal upload --publish ./dist/snipcheck-... to
    upload snipcheck to hackage
  2. Commit the updated snipcheck.cabal file.
Package Rankings
Top 34.59% on Hackage.haskell.org
Badges
Extracted from project README
Build Status