Grip -- Github Readme Instant Preview
Render local readme files before sending off to Github.
Grip is a server written in Python that uses the Github markup API to render a local readme. The styles also come directly from Github, so you'll know exactly how it will appear.
The package includes both a command-line interface and a Python API.
Sometimes you just want to see the exact readme result before committing and pushing to Github.
The command-line interface is simple. To render the readme of a repository:
$ cd myrepo $ grip
Now open a browser and visit http://localhost:5000.
You can also specify your own port:
$ grip 8080
You can access the API directly with Python, using it in your own projects:
from grip import serve serve(directory='path-to-your-file')
Other functions include:
To install grip, simply:
$ pip install grip