Metadata-Version: 2.1
Name: gtabview
Version: 0.10
Summary: A simple graphical tabular data viewer
Home-page: https://github.com/wavexx/gtabview
Author: Yuri D'Elia
Author-email: wavexx@thregr.org
License: MIT
Description: gtabview: a simple graphical tabular data viewer
        ================================================
        
        Graphical counterpart to `tabview
        <https://github.com/firecat53/tabview/>`_, a simple tabular data viewer
        that can be used both stand-alone and as a Python module for various
        files and Python/Pandas/NumPy data structures.
        
        
        Stand-alone usage
        -----------------
        
        `gtabview` reads most text tabular data formats automatically::
        
          gtabview data.csv
          gtabview data.txt
        
        If xlrd_ is installed, Excel files can be read directly::
        
          gtabview file.xls[x]
        
        .. _xlrd: https://pypi.python.org/pypi/xlrd
        
        
        Usage as a module
        -----------------
        
        ``gtabview.view()`` can be used to display simple Python types directly
        in tabulated form:
        
        .. code:: python
        
            from gtabview import view
        
            # view a file
            view("/path/to/file")
        
            # view a list
            view([1, 2, 3])
        
            # view a dict (by columns)
            view({'a': [1, 2, 3], 'b': [4, 5, 6], 'c': [7, 8, 9]})
        
            # view a dict (by rows)
            view({'a': [1, 2, 3], 'b': [4, 5, 6], 'c': [7, 8, 9]}, transpose=True)
        
            # view a simple list of lists
            view([[1, 2, 3], [4, 5, 6], [7, 8, 9]])
        
            # view a simple list of lists (with headers)
            view([['a', 'b', 'c'], [1, 2, 3], [4, 5, 6], [7, 8, 9]], hdr_rows=1)
        
        `gtabview` includes native support for NumPy and all features of Pandas'
        DataFrames, such as MultiIndexes and level names:
        
        .. code:: python
        
            from gtabview import view
        
            # numpy arrays up to two dimensions are supported
            import numpy as np
            view(np.array([[1, 2, 3], [4, 5, 6]]))
        
            # view a DataFrame/Series/Panel
            import pandas as pd
            df = pd.DataFrame([[1, 2, 3], [4, 5, 6]],
        		      columns=['a', 'b', 'c'], index=['x', 'y'])
            view(df)
        
        `gtabview` is designed to integrate correctly with `IPython`, `Jupyter`
        and `matplotlib`.
        
        When `matplotlib` is used, `gtabview` will automatically default to use
        mpl's ``interactive`` setting to determine the default behavior of the
        data window: when interactive, calls to ``view()`` will not block, and
        will keep recycling the same window.
        
        In `IPython` and `Jupyter` notebooks ``view()`` calls also default to
        non-blocking behavior, while in plain Python calls will halt until the
        window is closed.
        
        You can change this behavior with the ``view(..., wait=False)`` argument
        for each call, or by changing the module default::
        
          import gtabview
          gtabview.WAIT = False
        
        In a `Jupyter` notebook a *separate* data window will always show. The
        window can be kept around or closed, but will only be refreshed when
        evaluating the cell again.
        
        Separate data windows can also be opened by using the ``view(...,
        recycle=False)`` argument, or again by setting the global
        ``gtabview.RECYCLE`` default. See the built-in documentation of
        ``gtabview.view`` for more details.
        
        
        Requirements and installation
        -----------------------------
        
        `gtabview` is available directly on the `Python Package Index
        <https://pypi.python.org/pypi/gtabview>`_.
        
        `gtabview` requires:
        
        - Python 3 or Python 2
        - PyQt5, PyQt4 or PySide
        - setuptools (install-only)
        
        Under Debian/Ubuntu, install the required dependencies with::
        
          sudo apt-get install python3 python3-pyqt5
          sudo apt-get install python3-setuptools
        
        Then download and install simply via pip::
        
          pip install gtabview
        
        Install ``xlrd`` if direct reading of Excel files is desired::
        
          pip install xlrd
        
        
        License
        -------
        
        | gtabview is distributed under the MIT license (see ``LICENSE.txt``)
        | Copyright(c) 2014-2020: wave++ "Yuri D'Elia" <wavexx@thregr.org>
        | Copyright(c) 2014-2015: Scott Hansen <firecat4153@gmail.com>
        
        
        Latest release notes
        ====================
        
        * Fixes interactive support within IPython and Jupyter notebooks.
Keywords: data spreadsheet view viewer csv comma separated values
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Win32 (MS Windows)
Classifier: Environment :: MacOS X
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial :: Spreadsheet
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Software Development :: Widget Sets
Classifier: Topic :: Utilities
Description-Content-Type: text/x-rst
Provides-Extra: test
