Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Simple, Pygments-based local web app for viewing source code.
Python
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
src
.gitignore
CHANGELOG.rst
LICENSE
MANIFEST.in
Makefile
README.rst
buildout.cfg
requirements.txt
setup.py

README.rst

Pygge

Pygge is a Pygments wrapper that provides a simple, local web application for viewing highlighted source code.

Quickstart:

$ git clone git://github.com/jds/pygge.git
$ cd pygge
$ make env
$ bin/pygge --help
Usage: pygge [options] [base_dir]

Options:
  -h, --help            show this help message and exit
  -x, --no-browser      do not automatically open a web browser
  -s STYLE, --style=STYLE
                        pygments style (trac)
  -p PORT, --port=PORT  port to run the server on (4242)
  -i IP, --ip=IP        ip to run the server on (localhost)
  --cache-cpu=CACHE_CPU
                        limit CPU usage to this percentage (35)
  --log-level=LOG_LEVEL
                        logging level (INFO)

If you prefer pip to zc.buildout, you can install this way:

$ pip install -E ~/pygge \
      -r https://github.com/jds/pygge/raw/master/requirements.txt
$ cd ~/pygge
$ source bin/activate
$ pygge --help

Why?

I like to read code in the browser.

To me, code reads differently in the browser with highlighting that's different than my editor's. I use pygge to do a once-over of my own work before considering it finished. Usually I can find a few weird-looking spots that didn't stick out in the editor.

It's also handy for browsing other people's source code. If I already have a source tarball downloaded and extracted, or a repository checked out, it's faster to fire up pygge in those directories than to visit the project's web-based code browser (if the project even has one).

Something went wrong with that request. Please try again.