Skip to main content

a smarter pager

Project description

The Kitchen Sink Pager is a pager that does more, but its primary feature is adding per file syntax highlighting to git diffs.

Installation

pip install KitchenSink

Examples

# use it for paging. sometimes, it can even figure out
# the filetype and add syntax highlighting. (press 's')
cat some_file.py | kk

# Use it as a quick file jumper for grep results.
# Press 'lf' to quickly view a file in the current buffer
grep * -Rn my_string | kk

# Use it as a git log viewer.
# press 'lo' to [l]ist all git [o]bjects
# press 'lf' to [list] [f]iles in the buffer
git log | kk

# it does git diff highlighting, too
# press 's' to toggle highlighting
git log --color -n1 -p | kk

# if there are numbers in the buffer,
# the kitchen sink math them with 'm'
cat lots_of_numbers.txt | kk

Screenshots

KitchenSink syntax highlighting

https://raw.github.com/okayzed/kk.py/master/images/kk.png

KitchenSink syntax highlighting vs. the traditional git diff highlighting

https://raw.github.com/okayzed/kk.py/master/images/kk_vs_less.png

Changing Syntax Coloring

if the syntax coloring style isn’t your style or isn’t showing up well, you can use any of pygments other available styles by setting KK_STYLE environment variable.

# listing the styles

python -c “import pygments.styles; print pygments.styles.STYLE_MAP.keys()”

# changing the style to vim. put this in .bashrc if you always want it

export KK_STYLE=vim

Why another pager?

why not? operating on pipe output is one of the slower parts of my workflow. this is an attempt to make it more bearable.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

KitchenSink-0.1.0.tar.gz (17.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page