Metadata-Version: 2.1
Name: visidata
Version: 3.4
Summary: terminal interface for exploring and arranging tabular data
Home-page: https://visidata.org
Download-URL: https://github.com/saulpw/visidata/tarball/3.4
Author: Saul Pwanson
Author-email: visidata@saul.pw
License: GPL-3.0-only
Keywords: console tabular data spreadsheet terminal viewer textpunkcurses csv hdf5 h5 xlsx excel tsv
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: Console :: Curses
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Database :: Front-Ends
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Office/Business :: Financial :: Spreadsheet
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.gpl3
Requires-Dist: python-dateutil
Requires-Dist: windows-curses (>=2.4.1) ; platform_system == "Windows"
Requires-Dist: importlib-resources ; python_version < "3.9"
Requires-Dist: standard-mailcap ; python_version >= "3.13"
Provides-Extra: all
Requires-Dist: python-dateutil ; extra == 'all'
Requires-Dist: requests ; extra == 'all'
Requires-Dist: lxml ; extra == 'all'
Requires-Dist: openpyxl (>=2.4) ; extra == 'all'
Requires-Dist: xlrd ; extra == 'all'
Requires-Dist: xlwt ; extra == 'all'
Requires-Dist: h5py ; extra == 'all'
Requires-Dist: psycopg2-binary ; extra == 'all'
Requires-Dist: boto3 ; extra == 'all'
Requires-Dist: pyshp ; extra == 'all'
Requires-Dist: mapbox-vector-tile ; extra == 'all'
Requires-Dist: pypng ; extra == 'all'
Requires-Dist: fonttools ; extra == 'all'
Requires-Dist: sas7bdat ; extra == 'all'
Requires-Dist: xport (<3.3,>=3) ; extra == 'all'
Requires-Dist: PyYAML (>=5.1) ; extra == 'all'
Requires-Dist: dpkt ; extra == 'all'
Requires-Dist: dnslib ; extra == 'all'
Requires-Dist: namestand ; extra == 'all'
Requires-Dist: datapackage ; extra == 'all'
Requires-Dist: pdfminer.six ; extra == 'all'
Requires-Dist: tabula ; extra == 'all'
Requires-Dist: vobject ; extra == 'all'
Requires-Dist: tabulate ; extra == 'all'
Requires-Dist: wcwidth ; extra == 'all'
Requires-Dist: zstandard ; extra == 'all'
Requires-Dist: odfpy ; extra == 'all'
Requires-Dist: urllib3 ; extra == 'all'
Requires-Dist: shapely ; extra == 'all'
Requires-Dist: seaborn ; extra == 'all'
Requires-Dist: matplotlib ; extra == 'all'
Requires-Dist: sh ; extra == 'all'
Requires-Dist: psutil ; extra == 'all'
Requires-Dist: numpy ; extra == 'all'
Requires-Dist: pyconll ; extra == 'all'
Requires-Dist: msgpack ; extra == 'all'
Requires-Dist: brotli ; extra == 'all'
Requires-Dist: fecfile ; extra == 'all'
Requires-Dist: requests-cache ; extra == 'all'
Requires-Dist: beautifulsoup4 ; extra == 'all'
Requires-Dist: Faker ; extra == 'all'
Requires-Dist: praw ; extra == 'all'
Requires-Dist: matrix-client ; extra == 'all'
Requires-Dist: zulip ; extra == 'all'
Requires-Dist: pyairtable ; extra == 'all'
Requires-Dist: pandas (>=1.0.5) ; (python_version < "3.11") and extra == 'all'
Requires-Dist: tomli ; (python_version < "3.11") and extra == 'all'
Requires-Dist: backports.zoneinfo ; (python_version < "3.9") and extra == 'all'
Requires-Dist: pyarrow-hotfix ; (python_version <= "3.7") and extra == 'all'
Requires-Dist: pyarrow ; (python_version <= "3.7") and extra == 'all'
Requires-Dist: pandas (>=1.5.3) ; (python_version >= "3.11") and extra == 'all'
Requires-Dist: pyarrow (>=14.0.1) ; (python_version >= "3.8") and extra == 'all'
Provides-Extra: test
Requires-Dist: brotli ; extra == 'test'
Requires-Dist: dnslib ; extra == 'test'
Requires-Dist: dpkt ; extra == 'test'
Requires-Dist: fecfile ; extra == 'test'
Requires-Dist: Faker ; extra == 'test'
Requires-Dist: h5py ; extra == 'test'
Requires-Dist: lxml ; extra == 'test'
Requires-Dist: msgpack ; extra == 'test'
Requires-Dist: odfpy ; extra == 'test'
Requires-Dist: openpyxl ; extra == 'test'
Requires-Dist: pandas (>=1.5.3) ; extra == 'test'
Requires-Dist: pyarrow ; extra == 'test'
Requires-Dist: pyconll ; extra == 'test'
Requires-Dist: pypng ; extra == 'test'
Requires-Dist: pytest ; extra == 'test'
Requires-Dist: PyYAML (>=5.1) ; extra == 'test'
Requires-Dist: shapely ; extra == 'test'
Requires-Dist: tabulate ; extra == 'test'
Requires-Dist: tomli ; extra == 'test'
Requires-Dist: wcwidth ; extra == 'test'
Requires-Dist: xport (<3.3,>=3.0) ; extra == 'test'
Provides-Extra: windows-curses
Requires-Dist: windows-curses (>=2.4.1) ; (platform_system == "Windows") and extra == 'windows-curses'

# VisiData v3.4

[![Tests](https://github.com/saulpw/visidata/workflows/visidata-ci-build/badge.svg)](https://github.com/saulpw/visidata/actions/workflows/main.yml)
[![Gitpod ready-to-code](https://img.shields.io/badge/Gitpod-ready--to--code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/saulpw/visidata)

[![discord](https://img.shields.io/discord/880915750007750737?label=discord)](https://visidata.org/chat)
[![Mastodon](https://img.shields.io/mastodon/follow/110136431814047095?domain=https%3A%2F%2Ffosstodon.org)](https://fosstodon.org/@saulpw)

A terminal interface for exploring and arranging tabular data.

![Frequency table](http://visidata.org/videos/freq-move-row.gif)

VisiData supports tsv, csv, sqlite, json, xlsx (Excel), hdf5, and [many other formats](https://visidata.org/formats).

## Platform requirements

- Linux, OS/X, or Windows (with WSL)
- Python 3.8+
- additional Python modules are required for certain formats and sources

## Install

To install the latest release from PyPi:

    pip3 install visidata

To try VisiData without installing, use [pipx](https://pipx.pypa.io/) or [uv](https://docs.astral.sh/uv/):

    pipx run visidata          # or: uvx visidata

To install permanently (adds `vd` to your PATH):

    pipx install visidata      # or: uv tool install visidata

Additional Python packages are needed for some formats:

    pipx install visidata --preinstall openpyxl --preinstall lxml
    # or: uv tool install visidata --with openpyxl --with lxml

To add format packages to an existing pipx install:

    pipx inject visidata openpyxl lxml

To install the cutting edge `develop` branch (no warranty expressed or implied):

    pip3 install git+https://github.com/saulpw/visidata.git@develop

If VisiData reports `package X not installed` even after you installed it, `vd`
is almost certainly running from a different environment than the one you
installed the package into. Check `which vd`, then install the package into
*that* environment — e.g. `pipx inject visidata X` for a pipx install, or the
Homebrew Python for `brew install visidata`.

See [visidata.org/install](https://visidata.org/install) for detailed instructions for all available platforms and package managers.

### Usage

    $ vd <input>
    $ <command> | vd

Press `Ctrl+Q` to quit at any time.

Hundreds of other commands and options are also available; see the documentation.

### Documentation

* [VisiData documentation](https://visidata.org/docs)
* [Plugin Author's Guide and API Reference](https://visidata.org/docs/api)
* [Quick reference](https://visidata.org/man) (available within `vd` with `Ctrl+H`), which has a list of commands and options.
* [Intro to VisiData Tutorial](https://jsvine.github.io/intro-to-visidata/) by [Jeremy Singer-Vine](https://www.jsvine.com/)

### Help and Support

If you have a question, issue, or suggestion regarding VisiData, please [create an issue on Github](https://github.com/saulpw/visidata/issues) or chat with us at #visidata on [irc.libera.chat](https://libera.chat/).

If you use VisiData regularly, please [support me on Patreon](https://www.patreon.com/saulpw)!

## License

Code in the `stable` branch of this repository, including the main `vd` application, loaders, and plugins, is available for use and redistribution under GPLv3.

## Credits

VisiData is conceived and developed by Saul Pwanson `<vd@saul.pw>`.

Anja Kefala `<anja.kefala@gmail.com>` maintains the documentation and packages for all platforms.

Many thanks to numerous other [contributors](https://visidata.org/credits/), and to those wonderful users who provide feedback, for helping to make VisiData the awesome tool that it is.
