Metadata-Version: 2.1
Name: PTable
Version: 0.9.2
Summary: A simple Python library for easily displaying tabular data in a visually appealing ASCII table format
Home-page: https://github.com/kxxoling/PTable
Author: Luke Maurits
Author-email: luke@maurits.id.au
Maintainer: Kane Blueriver
Maintainer-email: kxxoling@gmail.com
License: BSD (3 clause)
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: License :: OSI Approved :: BSD License
Classifier: Topic :: Text Processing
License-File: COPYING

============
About PTable
============

PTable is a simple Python library designed to make it quick and easy to
represent tabular data in visually appealing ASCII tables, originally
forked from `PrettyTable <https://code.google.com/p/prettytable/>`_.

.. image:: https://travis-ci.org/kxxoling/PTable.svg
    :target: https://travis-ci.org/kxxoling/PTable
    :alt: Build Status

.. image:: https://landscape.io/github/kxxoling/PTable/master/landscape.svg?style=flat
    :target: https://landscape.io/github/kxxoling/PTable/master
    :alt: Code Health

.. image:: https://coveralls.io/repos/github/kxxoling/PTable/badge.svg?branch=master
    :target: https://coveralls.io/github/kxxoling/PTable?branch=master
    :alt: Coverage


Installation
============

As PTable is a fork of PrettyTable, and compatible with all its APIs,
so PTable is usage is the same as PrettyTable, and the installation
would cover on the original PrettyTable.

As always, you can install PTable in 3 ways.

Via pip (recommend)::

    pip install PTable

Via easy_install::

    easy_install PTable

From source::

    python setup.py install


Quick start
===========

PTable supports two kinds of usage:


As a library
------------

PTable library API is almost as PrettyTable, you can import the same API from
``prettytable`` library:

.. code-block:: python

    from prettytable import PrettyTable
    x = PrettyTable()

A better hosted document is hosted on `ReadTheDocument <http://ptable.readthedocs.org/>`_.


As command-line tool
--------------------

This is an original function of PTable, can be used as ``ptable`` command:

.. code-block:: shell

    ptable --csv somefile.csv

or a Unix style pipe:

.. code-block:: shell

    cat somefile.csv | ptable

Will both print a ASCII table in terminal.



Relative links
==============

* `Source Code (GitHub) <https://github.com/kxxoling/PrettyTable>`__
* `RTFD <https://ptable.readthedocs.org>`__
* `PyPI <https://pypi.python.org/pypi/ptabl://pypi.python.org/pypi/ptable>`__
* `PrettyTable <https://code.google.com/p/prettytable/>`_



