Metadata-Version: 2.0
Name: golumn
Version: 0.20.2
Summary: Graphical CSV viewer. `column` with a "g"
Home-page: https://github.com/ddrscott/golumn
Author: Scott Pierce
Author-email: ddrscott@gmail.com
License: MIT
Description-Content-Type: UNKNOWN
Keywords: csv development desktop wxWidgets
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: MacOS X :: Cocoa
Classifier: Environment :: Win32 (MS Windows)
Classifier: License :: OSI Approved
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows :: Windows 7
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: POSIX
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Desktop Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Requires-Python: >=3
Requires-Dist: wxPython
Requires-Dist: chardet

Golumn
======

Golumn is a desktop CSV viewer to replace the ``column`` command. Think ``column`` with a "g". It behaves similar to the ``column`` command, but with a graphic user interface. It bridges the command line and desktop divide by allowing us to present tabular data outside the confines of the terminal.

.. class:: no-web

    .. image:: https://raw.githubusercontent.com/ddrscott/golumn/dev/docs/screenshot.png
        :alt: screenshot
        :width: 100%
        :align: center

It is challenging without this tool to manage a bunch of tabular output within only a terminal window. It's difficult to maintain context when long scrolling text and we're often executing the same statements to bring up previous results.

A typical workflow without this tool is chain together commands:

.. code:: sh

    # psql
    #   -X :: ignore ~/.psqlrc 
    #   -A :: remove whitespace
    #   -c :: run the SQL statement
    # column
    #   -t :: table-ize
    #   -s :: set delimiter
    # less
    #   -S :: Scroll horizontally (enables left/right arrows)
    psql -X -A --pset footer -c 'select * from actors_list' dvdrental | column -ts '|' | less -S

When you're done viewing the data it disappears. Leaving you to remember what you saw as you're building the next statement. We could (and probably should) manage our terminal windows better with splits and tabs, but there's limits which desktop GUI's have solved. Enter ``golumn``.

Usage
-----

.. code:: sh

    # Open a CSV file:
    golumn data.csv &

    # Pipe in the data:
    cat data.csv | golumn &

    # Show Query Results:
    psql -X -A --pset footer -c 'select * from actors_list' dvdrental | golumn &

Installation
------------

Requires Python3. Please makes sure it's installed property on target OS with Pip package manager.

This package is available via https://pypi.python.org/pypi. To install on the target system try:

.. code:: sh

    pip3 install golumn --upgrade --user
    # --upgrade ensures you get the latest version
    # --user install only for your user

For more info on install pip packages see:
https://pip.pypa.io/en/stable/quickstart/

Make sure ``pip3`` binaries are available in your ``$PATH``:

Contributing
------------

Bug reports and pull requests are welcome on GitHub at
https://github.com/ddrscott/golumn

License
-------

The gem is available as open source under the terms of the `MIT License <https://opensource.org/licenses/MIT>`__.


