Skip to content
A python package offering data frame scrolling in the terminal
Python
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
datascroller
resources
LICENSE.txt
README.md
setup.cfg
setup.py

README.md

datascroller - data scrolling in the terminal!

Welcome to the datascroller project! While IDEs and notebooks are excellent or interactive data exploration, there will always be some of us who prefer to stay in the terminal. For exploring Pandas data frames, that meant painstakingly tedius use of .iloc, until now...

Note: commands shown on the demo are out of date as of version 0.9.2. See Usage and Examples below.

Installation

via pip

pip install datascroller

Usage

Import the scroll function with

from datascroller import scroll

and call scroll with a Pandas DataFrame as an argument. Press 'q' to quit viewing.

Keys

The default (only at the moment) keys are set up to resemble Vim's edit mode.

The following keys are currently supported:

Movement

  • h: move to the left
  • j: move down
  • k: move up
  • l: move left

Data Frame Resizing

  • d: grow data frame by one column
  • x: grow data frame by one row
  • a: shrink data frame by one column
  • w: shring data frame by one row

Quick Movement

  • Ctrl + F: Page down
  • Ctrl + B: Page up (not working as well for some reason)

Exiting

  • q

Examples

Using iPython is a good way to try out datascroller interactively:

import pandas as pd
from datascroller import scroll

train = pd.read_csv(
    'https://raw.githubusercontent.com/datasets/house-prices-uk/master/data/data.csv')

scroll(train)
You can’t perform that action at this time.