VisiData Releases Feed

v2.8

2021-12-16T00:00:00Z

v2.8 (2021-12-16)

VisiData v2.8: Python 3.10 compatibility

This is a pretty small release of mostly bugfixes, which still has a few changes that merit a minor version bump.

The all-stars of this release are @ajkerrigan and @geekscrapy.

@ajkerrigan found, debugged, and fixed a Python 3.10 compatibility bug. Before v2.8, you could see many warnings related to COLOR-1 in the status message.

@geekscrapy contributed 7 PRs for v2.8. Thanks to his PRs, VisiData now gracefully skips blank lines in json files, and will not attempt to load plugins which failed to install.

Happy holidays!

v2.7.1

2021-11-15T00:00:00Z

2.7.1 (2021-11-15)

VisiData v2.7.1: hotfix

The ever-vigilant @geekscrapy found a bug with Enter on the helpmenu #1196.

This is a small enough fix for a very important feature.

v2.7

2021-11-14T00:00:00Z

v2.7 (2021-11-14)

VisiData v2.7: new loaders - odf and lsv

A bunch of improvements, bugfixes, and a couple of new loaders.

Improvements

[movement] bind Home/End to go-top/go-bottom (thanks @geekscrapy #1161
[api] add vd.urlcache as alias for urlcache global (thanks @geekscrapy for PR #1164)
[plugins] do not continue installation if main package fails pip install (thanks @geekscrapy for PR #1194)
[plugins] allow for plugin records without SHA256; warn if absent (thanks @geekscrapy for PR #1183)
[load_lazy] do not load subsheets, if sheet.options.load_lazy is True (thanks @geekscrapy for PR #1193)
[save] confirm when save_foo function does not exist and saver fallsback to options.save_filetype (reported by @geekscrapy #1180)
[save] options.save_filetype default now 'tsv'
several cosmetic improvements

Loaders

[lsv] add lsv filetype for simple awk-like records (requested by @fourjay #1179)
[ods] add odf filetype for Open Document Format spreadsheets
[xlsx] add extra columns (cellobject, fontcolor, fillcolor) if options.xlsx_meta_columns (default False) (thanks @hoclun-rigsep for PR #1098)
[sqlite] allow query/insert (no modify/delete yet) for WITHOUT ROWID tables (requested by @stephancb #1111)

Bugfixes

[savers compression formats] fix corruption when saving to compression formats (#1159)
fix "ModuleNotFoundError: no module named 'plugins'" error on startup (#1131 #1152)
[windows] fix issue with Enter key on Windows (reported by @hossam-houssien #1154)
[draw] fix multiline rows by making height fixed for all rows (reported by @geekscrapy #916)
[DirSheet] fix bug where fix key column sheets (e.g. DirSheet, SqliteIndexSheet) keycols were not being saved in batchmode (reported by @geekscrapy #1181)
[async] make sure all threads started on sheet are cancelable (reported by @geekscrapy #1136)
[AttrDict] fix bug with setting value on nested AttrDict
[dup-X-deep] fix error with async_deepcopy (thanks @pstuifzand for fix)
[join] fix 'inconsistent-keys' issue when joining between XlsxSheet with typed columns and CsvSheet with untyped columns (reported by @davidwales #1124)
[sqlite] handle sqlite column names with spaces (thanks @davidskeck for PR #1157)
[sqlite] use options.encoding and options.encoding_errors for decoding of sqlite db text (reported by @WesleyAC #1156)
[xlsx] add handling for EmptyCell instances (thanks @hoclun-rigsep for PR #1121)
[xlsx] gate sheet name cleaning on options.clean_names (reported by @davidwales #1122)
[macos] fix bindings for Option+key
[random-rows] fix import (reported by @geekscrapy #1162)
[save-selected] better default save filename (reported by @geekscrapy #1180)
[save] fix bug where saving multiple sheets to a single non-embeddable format did not result in fail (reported by @geekscrapy #1180)
[slide] fix Shift slide-down and Shift slide-up with arrow keys (reported by @a-y-u-s-h #1137)
[replay] fix replay where join-sheets operation hangs (reported by @agjohnson #1141)
[undo] no more KeyError when Undoing modifications (reported by @geekscrapy #1133)
[unfurl-col] fix unfurl-col on cells containing exceptions (reported by @jsvine #1171)

Happy VisiDatin'!

v2.6.1

2021-09-29T00:00:00Z

v2.6.1 (2021-09-28)

VisiData v2.6.1: minor bugfixes!

In preparation for the VisiData workshop at Strangeloop 2021, this patch was released with several minor bugfixes.

Features with fixes include:

On top of this, we have updated the homebrew and personal debian repositories to contain the most recent version of VisiData.

We appreciate everyone who has mentioned VisiData in several threads on HackerNews and reddit, recently. Talking about tools you love in public spaces, means a lot to everyone who dedicates time to work on them.

Happy VisiDating!

v2.6

2021-09-19T00:00:00Z

v2.6 (2021-09-19)

VisiData v2.6: now with menus!

This release introduces a new[0] hierachical menu system for discovering and executing commands.

Press Ctrl+H to open the help menu, arrows and Enter to move around. Or use the mouse.

Here's a video demo of this new menu system, including a sample workflow within VisiData for finding which commands aren't in the menu (using the mouse almost entirely).

Also in this release are several performance improvements, feature enhancements, and bugfixes. See the CHANGELOG for full details.

[0] Back in v1.1 (2018), VisiData had an experimental one-line menu system, but it was removed in v1.3 (6 months later), as it wasn't feeling right.

v2.5

2021-07-08T00:00:00Z

v2.5 (2021-07-08)

First off, some non-technical notices:

Since 2017 when VisiData was started, I've created a number of plugins and tools that take advantage of the VisiData "platform". These have historically been separate from VisiData, but it became a fair amount of mental overhead tracking a dozen different repos when making changes to the VisiData core repo. So a little while ago I migrated some of my older projects, like vsh and vgit, into the saulpw/visidata repo, aiming at a "mono-repo". But they never really got integrated, because they didn't feel right either: some of them were wild experiments, some I don't want to release as open source, some I don't want to provide the level of support for, and some simply don't belong in the visidata repo (like galcon).

So now I'm migrating towards a "duo-repo" approach. The saulpw/visidata repo can remain focused on providing a reliable and flexible platform, and a separate repo, "vdplus", is where I put all my VisiData plugins and extras. (This vdplus repo is private and not open-source, but Patreon subscribers can get access to it and use it if they want.)

Secondly, the core VisiData repo now requires submitters to e-sign a Copyright Assignment Agreement (CAA). The core repo will always be open-source, but as the author I should have the legal authority to release it under a different license if I choose.

Finally, our IRC channel has moved from Freenode to libera.chat; come visit us on the new #visidata!

And now for the actual software changes:

Interface Changes

quitguard ux improvement
- [quitguard] confirm quit/reload only if sheet modified (references #955, #844, #483; thanks @jvns, @frosencrantz)
- not enabled by default yet
[quit] add Shift+Q/quit-sheet-free to quit and free associated memory (thanks @cwarden)
New major keybinding!
- x is now "cut" (copy and delete), like in vim.
- In v2.3 the delete family was changed to delete without copying to the clipboard (previously it acted like "cut").
[options] save to foo.visidatarc from OptionsSheet (thanks @njthomas #958)
- note that you can't save directly to .visidatarc (call it a security feature).

Minor Improvements

[splitwin] push sheet in empty pane iff splitwin
[movement] bind Ctrl+Left/Right to go-left/right-page (thanks @davidwales #1002)
[unfurl] add options.unfurl_empty to include row for empty list/dict (thanks @frosencrantz #898)
[regex expand] deprecate expand_col_scanrows; standardize on options.default_sample_size (thanks @jsvine)
[canvas] add options.disp_canvas_charset to change displayed chars (thanks @albert-ying #963)
- @albert-ying convinced me to make the canvas character set configurable. With options.disp_canvas_charset = ' o', any points on the graph become an o, which is hopefully big enough to see. You can set this to use different characters, just make sure that the first character is a space. This option can also be configured more precisely if you want to vary the character by how many/which points are present (like the braille characters).
[join] extend join columns now writable (and correct)

Loader-specific Improvements

[sqlite] rename or drop tables from the sqlite index sheet (edit the name or delete the row and then z Ctrl+S to commit as usual)
[DirSheet] add y/gy to copy file(s) to given directory
[zstd] support loading zstd-compressed files (thanks @lxcode #971)

Bugs fixed (34): #758 #895 #896 #898 #946 #952 #955 #958 #959 #961 #962 #963 #964 #966 #969 #971 #974 #975 #979 #982 #983 #987 #991 #1002 #1003 #1010 #1011 #1011 #1012 #1016 #1018 #1029 #1032 #1033

See the CHANGELOG for a comprehensive list of bugfixes and changes.

v2.4

2021-04-11T00:00:00Z

v2.4 (2021-04-11)

This release, hot on the heels of the 2.3 release last week, is primarily to address some bugs that were found in 2.3. Originally it was slated to be a patch release (2.3.1), but the removal of options.use_default_colors with the fix for #939 and the semantics of splitwindow felt sufficient to warrant a minor version bump, and so we tossed the few other improvements that were sitting on the develop branch.

Improvements

[color] remove options.use_default_colors (thanks @lxcode #939)
- options.color_default can now have both fg and bg
- other color options which do not specify fg or bg will use the missing component from color_default
- to use terminal default colors, set options.color_default=""
[splitwindow] stabilize sheet stack associations
- Shift+Z pushes 'under sheet' (if any) onto other stack
- Shift+Z does not swap panes anymore
- g Tab changes which stack is in the top vs bottom panes
- options.disp_splitwin_pct cannot be sheet-specific
[status] show nSelectedRows on rstatus

Bugfixes

[pyobj-show-hidden] grab visibility lvl from sheet specific option (thanks @frosencrantz #947)
[splitwin] prevent flickering-on-full-window
[splitwin] if top sheet quit, keep bottom sheet in bottom pane

Loader specific bugfixes

[gzip] fix progress bar when opening gzip (thanks @geekscrapy #925)
[http] fix loading files from url without specifying filetype
[sqlite] use TABLE_XINFO for hidden/virtual columns (thanks @dotcs #945)
[sqlite] reload perf: load without pre-counting rows (which required 2nd full table scan)
[vds] save typed values instead of formatted display values (thanks @frosencrantz #885)
[xlsx] stringify "header" row values for column names (thanks @davidwales #921)

v2.3

2021-04-04T00:00:00Z

v2.3 (2021-04-04)

This release adds a memory sheet and improves on several other features. Major changes are listed below. Please see the CHANGELOG for the full list of changes.

Memory sheet, for recording values usable in expressions. View the memory sheet with open-memory (Alt+Shift+M), add current cell with Alt+M, add single aggregated value with z+. Also reference the current clipboard value as clipval. #912
The split pane feature has been revamped. Now there is one sheet stack per pane, and sheets do not jump between panes. New sheets open in the current pane. Send the current sheet to the other pane with Shift+Z (same command as invoking splitpane in the first place). Ctrl+^ swaps sheets in the current pane. See the pane column on the Sheets Sheet (pane 0 means "not on any sheet stack", i.e. it's been quit). #894
Colors now may have a background color in addition to the fg color and attributes. Add e.g. "on blue" or "on 214" to a color to set the background color. There is still the (curses) limit of 256 active colors shown at one time. (This is one of several changes in 2.3 necessary to use the new darkdraw plugin.) #435
minor additions

new command: jump-first (bound to g Ctrl+^) to push the bottom sheet (used repeatedly will cycle through sheets in the current pane).
Ctrl+X within Ctrl+X (pyobj-expr) drops into a Python REPL.

changes to options and commands

options.use_default_colors now defaults to True (was False).
delete commands no longer move deleted values to clipboard #895
zd and gzd (delete-cells) set the value to options.null_value instead of always using None.

v2.2

2021-01-30T00:00:00Z

v2.2 (2021-01-30)

This release adds new features and changes some existing behavior. Please see the CHANGELOG for the complete list of changes and bugfixes.

VisiData v2.2 has been successfully packaged for Debian, and is slated to be part of the bullseye distribution.

The interpretation of "global" vs. "sheet-specific" CLI options has changed.

In v2.0 and v2.1, options given on the command-line were "sheet-specific" and only applied to files on the command-line, and -g (--global) had to be specified to make them apply to sheets created after launch. Now, options are "global" by default (affecting all sheets which don't have a sheet-specific override), and -n indicates that subsequent CLI options are sheet-specific. The -g option is now basically a no-op (though it can be given after -n (--nonglobal) to return to the default behavior after specifying some sheet-specific options). This fixes a few things that users (including myself) were consistently misinterpreting or getting frustrated with, and hopefully does not affect anyone adversely.

New feature: persistent input history

By popular demand, VisiData can now store user-provided input values so they persist between sessions. This is currently disabled by default, as it may have surprising privacy or security implications in some environments. Enable persistent input history by adding the following to visidatarc:

options.input_history='previnputs'

New type: floatlocale

The VisiData float type uses the Python builtin float, which only parses numbers in "international" notation. To parse locale-specific numbers (which use e.g. a decimal comma instead of a decimal point), there is now the floatlocale type, which parses numbers based on the LC_NUMERIC environment variable (which must be set before starting vd). A separate type was created because locale-based parsing was measured as 20x slower than the base float type. The type-floatlocale and type-floatlocale-selected (on ColumnsSheet) commands were added without keybindings; users who need this functionality will probably want to add the following to their visidatarc:

bindkey('%', 'type-floatlocale')
bindkey('g%', 'type-floatlocale-selected')

Option change: Fancy Chooser now disabled by default

The "fancy chooser", a tabular menu with helpstrings for choosing e.g. aggregators and jointypes, is now disabled by default. Choosing an aggregator or jointype now (again) uses the status/input line, and requires entering the value manually. To invoke the fancy chooser, use Ctrl+X. If the fancy chooser is preferred by default, set options.fancy_chooser=True.

New format: .vds (VisiData Sheet)

This new single-file format can store typed data and column information from multiple sheets. Use g Ctrl+S (save-all or save-selected) to invoke the multisheet saver, and then specify a filename with a .vds extension. When you load the file into vd, the Column typing and formatting will be the same!

New loader (and saver): geojson

Thanks @dracos for PR #876 implementing geojson loading and saving!

Several other improvements and bugfixes

On February 7th, a patch, v2.2.1, was shipped.

It contains two bugfixes for setcol-fill (see issue #884, and a typo fix in the man page.

Additionally, there is now a packaged visidata.1, so that man visidata will also bring up the VisiData manpage, when the manpage is successfully installed.

v2.1.1

2021-01-03T00:00:00Z

v2.1.1 (2021-01-03)

This release may be a small one, but it contains a handful of meaningful bugfixes that we wanted to get out the door.

Happy New Year, everyone!

[macros] allow macro interfaces to be longnames (thanks @frosencrantz #787)
[save] better default save filename for url sheets (thanks @geekscrapy #824)

Bugfixes

[cmdlog] record column, sheet, and row info for open-cell
[cmdlog] catch case of 'override' sheet for set-option
[expr-col] curcol now works for multiple invocations (thanks @geekscrapy #659)
[loaders postgres] account for postgres_schema when rendering Postgres tables (thanks @jdormit for PR #852)
[loaders url] fail unknown URL scheme (thanks @geekscrapy for PR #84)
[pyobj] fix Pyobj Sheets for lists (thanks @brookskindle #843)
[pipe] handle broken pipes gracefully (thanks @robdmc #851)
[scroll] fix issue with jagged scrolling down (thanks @uoee #832)
[sort] fix bug where total progress in sorting is (100 * # of columns to sort) (thanks @cwarden)

v2.1

2020-12-06T00:00:00Z

v2.1 (2020-12-06)

This release fixes several bugs in 2.0 and fills in some of the gaps. Please see the CHANGELOG for the complete list of changes and bugfixes.

options.some_selected_rows

Some commands, like setcol-expr (g=) operate on the selected rows. Before 2.0, if no rows were selected, these commands would fall back to operating over all rows. This is intuitive and helpful, but can cause problems with non-interactive script replay: sometimes there are legitimately no selected rows, and so the command should not do anything (but also not fail). So the behavior was changed in 2.0 to have reliable and deterministic results. It's reasonably easy to work around: select all rows with gs, repeat the command, and maybe unselect them all with gu. But this turned out to be ultimately disappointing for interactive use.

So, in 2.1, there is now an option some_selected_rows, which if True, causes these commands to operate on all rows, if none are selected:

`setcol-expr` (`g=`)
`setcol-iter` (`gz=`)
`setcol-subst` (`g*`)
`setcol-subst-all` (`gz*`)

This option applies only to interactive mode, and not to batch mode. In batch mode, commands that operate on selected rows will always use the list of selected rows, even if there are none (and so it won't do anything). Be careful about saving .vd scripts from sessions in which this option was set; the results when replaying in batch mode may not be as expected.

options.numeric_binning

For 2.0, ranged binning of numeric columns was implemented, and allowed to be disabled by setting options.numeric_binning to False. (By default it was set to True.)

In 2.1, this option is now disabled by default, and must be enabled (whether globally or per-sheet) by setting it to True.

[input] Shift+Arrow within edit-cell to move cursor and re-enter edit mode

By popular demand, pressing Shift+Arrow when editing a cell, will save the current value, move the cursor one row or column in the given direction, and re-enter edit mode. This makes it easier to enter data, either row-wise or column-wise.

This feature obsoletes options.cmd_after_edit, which was always a terrible hack. It has no effect now.

Expression can access column attributes

In 2.0, expressions could use attributes on the vd singleton or the current sheet object, and had sheet and row special variables to refer to the sheet and row objects themselves.

In 2.1, expressions can also use attributes of the expression column, and col can be used to refer to the column object directly. (So col.width and width both refer to the width of the expression column itself, if there are no columns named width.)

Differentiate select-equal- and select-exact-.

Previously, select-equal- (bound to ,) matched on the typed value. Now, select-equal- matches on the displayed value. New commands select-exact-cell/-row that match on typed value are bound to z, and gz, (the display value may be rounded or formatted with less precision, so using the typed value is "more precise".

(Thanks @geekscrapy for noticing)

New macro system

A new command macro-record (bound to m) starts recording commands for use in a macro. The same command stops recording and prompts for a keystroke to bind the macro to. When the given keystroke is pressed, the macro will be executed. All macros run their commands on the current (row, column, sheet), regardless of the cursor position when the macro was recorded.

The new command macro-sheet (bound to gm) opens an index of all current macros. A macro on this sheet can be viewed with Enter and then modified, saving changes with Ctrl+S

This feature obsoletes the older iteration of macro system, and removes the deprecated z Ctrl+D command.

(Thanks @bob-u for the suggestion)

Other Additions and Improvements

Add mode and stdev aggregators.
Add sort-order indicator in column header.
Unset options with d on options sheet (also add options.unset() API function).
.vdj scripts are now hashbangable. Put #!vd -p at the start of the .vdj file and watch it go! (Note: extension must still be .vdj for now.)
The floatsi type (z%) can now parse SI strings like "2.3M" (thanks @anjakefala for sponsoring).
Regex capture (;) will use capture names as column names, if available (thanks @tsibley).

Format-specific improvements

[http] auto-paginate by continuing with the given links.next.url from the response.
[json] 50% speedup for loading (thanks @lxcode).
[pdf] options.pdf_tables to parse tables from pdf with tabular.
[sqlite] Use internal rowid to update and delete rows (WITHOUT ROWID sqlite tables can no longer be modified).
[zip] Add extract-file, extract-selected, extract-file-to, extract-selected-to commands (bound to x, gx, zx, and gzx on the ZipSheet).
[fixed] Add fixed-width saver (uses col.width).
[clickhouse] Add plugin for clickhouse loader.

v2.0

2020-10-14T00:00:00Z

VisiData v2.0 (2020-10-14)

This is a major milestone. After almost 2 years of development, version 2.0 of VisiData is finally released. It's got several major improvements, a bunch of new loaders, and tons of new features and quality of life improvements. And, most importantly, an API specification for plugins.

1. Licensing Changes

[tl;dr: no more MIT vdtui; GPL3 for everything]

Previously, there was a core vdtui single-file library that I licensed as MIT, as I thought it might be a platform for a variety of apps like VisiData. Approximately no one showed interest in that though, and it became unwieldy to maintain, so over the course of developing VisiData 2.0, the vdtui library was thoroughly dismantled. It's now just the visidata module as a whole, which I'm releasing under GPL3. The last released version of vdtui.py under MIT was 1.5.2 if anyone wants to use that.

2. Plugin API

[tl;dr: "2.0" has a stable documented API; expect a growing ecosystem of plugins for a wide variety of use cases.]

To be honest, this is what held off the 2.0 release for so long. I knew I wanted to go through every function and decide whether I wanted to include it in the 2.0 API to be supported for the rest of the 2.x lifecycle, which might be years. (We don't intend to strictly adhere to "semver", but it's still important to try to maintain backwards compatibility within a major version number.) So now, we have an API spec with over 200 functions, which will be of interest if you want to customize VisiData, or create a plugin for it, or just to know more about its internal components.

Take a look at the actual API, at visidata.org/docs/api. It still needs a bit more polish, but the meat and bones are there.

3. Undo and Redo

This is a "game changer" according to @jsvine.

Undo and redo, along with the new guard-sheet command, make it much easier to rely on VisiData for data cleaning and data entry.

If you upgrade to 2.0 and learn nothing else about it, your life will be better for knowing Shift+U (undo) and Shift+R (redo).

4. Deferred modifications

[tl;dr: if you add/edit/delete rows on a few specific sheets, the changes won't take place right away; you'll have to press z Ctrl+S]

Certain sheets which know how to incrementally update their source--notably, the DirSheet and SqliteSheet--defer changes made to them, requiring an explicit save/commit step with commit-sheet (z Ctrl+S).

These changes are colorized on the screen and can be saved as data (or not saved, in the case of deletes) with save-sheet (Ctrl+S), even if they haven't been committed back to the original source with commit-sheet.

This means vd can work quite naturally as an interactive file manager, or as a sqlite database editor. I've been using it to manage my mp3 collection and my personal contacts database, which was a tsv file until I wanted to add a multiline "notes" field, so I saved it as a .json file and used that for a few months, and now I've been using it in an sqlite database. Of course they all look the same in VisiData so I can go back and forth without any friction.

5. Split Window

Press Shift+Z to split the terminal window into a top panel and bottom panel.

One panel contains the current/top sheet, the other panel contains the sheet "under" the top sheet. Press Tab or Ctrl+^ to go between them.

The fancy chooser (now the default for choosing aggregators or jointypes) uses this split window, and I have many other ideas for it as well.

It may not seem like much now, but I predict that this becomes a sleeper hit.

[previously blogged at: visidata.org/blog/2020/splitwin)]

6. So many other features

Here's curated list of highlights, the ones that seemed like people would be interested to know about:

more visibility for long values, with "v" to toggle multi-line rows and and z+hjkl to adjust cell offset
[iota] the "i" family of commands to add an increment column
[unfurl] zM, which does row-wise expansion of iterables in a column (very useful with nested data)
[join] add "merge" jointype
[numeric binning] ranged binning for numeric columns
[cli] custom options parsing allows for per-sheet options
[cli] pipe and redirect to stdout; use as an interactive chooser
[input] Ctrl+Y paste from cell clipboard and other improvements
Alt+ as new keyboard layer for user keybindings

And, as with every release, there are a bunch of new loaders, including MIME, recutils, vcard, imap, mysql, pdf, npy/npz, and more! See the new /formats page for a full list of supported formats, in tidy tabular form.

Then if you still haven't seen enough, you can see the CHANGELOG for the complete list of bugfixes and changes.

Okay, that about wraps it up for this release. If anything I've written about here sounds interesting and you'd like me to cover it first, or more in-depth, let me know! Send me an email, or tweet @VisiData, or open a github issue, or chat with us on Freenode #visidata; however you want to get in touch, we'd love to hear from you.

v1.5.2

2019-01-12T00:00:00Z

v1.5.2 (2019-01-12)

We are starting off the New Year with a very small patch for a few bugs.

Briefly,

Fixed g*
- thanks to both @jsvine and @layertwo for noticing and notifying us.
If suspended during editline (with Ctrl+Z), VisiData will now correctly resume in the editline.
Ctrl+W on an empty value in editline does not error out of the editline.

And that's it.

Happy new year, everyone!

v1.5.1

2018-12-17T00:00:00Z

v1.5.1 (2018-12-17)

v1.5.1: Bugfixes and user feedback

The initial motivation for this patch was to fix an idle performance regression. In the interim, though, we have received a bunch of feedback for improvements and a couple of feature requests.

So thanks for all of your ongoing engagement and for continuing to share VisiData with the world. We hope you enjoy this final release of 2018!

A brief overview:

Improvements to the pandas loader.
- thanks to @nickray for the bughunting
When set to True options.bulk_select_clear bulk select commands (|, g|, ,, etc) will clear the previously selected rows.
- the default is set to False and exhibits the current behaviour of retaining the already selected rows
- thanks to @aborruso for the suggestion
Shift+O once again pushes the global options sheet. You can find the sheet options by pressing zO. gO now opens the .visidatarc which can be edited and saved from within the VisiData interface.
Sorting is now asynchronous, per user request. Please let us know how you find it.
- thanks to @apnewberry for starting that conversation
gz^ now renames all visible columns to contents of selected rows and gz* substitutes over all visible columns
- thanks, once again, to @aborruso for both suggestions

As usual, the complete list of changes can be found in the Changelog.

v1.5

2018-11-02T00:00:00Z

v1.5 (2018-11-02)

For the most part, this is a bugfix release. A few other improvements are here as well:

Basic plugin support
- ~/.visidata added to sys.path on startup
- copy plugin to e.g. ~/.visidata/vdfoo.py
- add import vdfoo to .visidatarc to activate
Error saving
- for tsv and json, errors are saved as options.safe_error string (default #ERR)
- if that option is an empty string, error message is saved instead
Mouse improvements
- click now moves to column also
- right-click to edit cell, rename column, or rename sheet, depending on where clicked.
xls/xlsx loaders now use options.header to determine number of rows used to set column names (default is 1).

See the CHANGELOG for a more complete list of bugfixes and changes.

v1.4

2018-09-24T00:00:00Z

v1.4 (2018-09-24)

This is largely a bugfix and performance release. It was originally planned as a patch release (v1.3.2), but some features and interface changes crept in, so it is officially v1.4.

[pyobj] visidata.view(obj) and visidata.view_pandas(df)
[pandas] -f pandas loads file using pandas.read_<ext>()
[date] date minus date now gives float number of days instead of seconds
[vdtui] internal colorizer API changed significantly
[vdtui] significant idle performance improvement

As usual, a more complete list of changes and features is in the CHANGELOG.

See the ROADMAP for the planned future direction of VisiData.

v1.3.1

2018-08-19T00:00:00Z

v1.3.1 (2018-08-19)

We found some issues with 1.3 (aggregators interacting with nulls/errors, primarily) that we didn't want to let sit until 1.4. So we fixed those issues and a couple others, and added a few 'minor' features. This patch version should be a definitive improvement over the base 1.3 version.

The complete list of changes is in the CHANGELOG. Here are the new options and features:

new extend join type keeps the type of the first sheet, extending it with columns from the other sheets
rename-sheet command (thanks to @jsvine for suggestion; what default keybinding should it have?)
[DirSheet] add reload-rows (gz^R) to undo modifications on all selected rows
remove all options.foo_is_null and add options.null_value
options.save_errors (default True) to include errors when saving
add options.json_indent for json pretty-printing

v1.3

2018-08-11T00:00:00Z

v1.3 (2018-08-11)

It's been a productive 3 months since v1.2. The largest effort in this release was a commands/options reworking, which will hopefully pay dividends in the future. Many other so-called improvements were made as well. Here's a list of most of them:

commands

All commands were thoughtfully renamed, and the command longnames should be largely stable now.
commands.tsv is an exhaustive list of commands and their attributes and side effects.
The manpage has moved to Ctrl+H (sysopen-help), which is hopefully its final keybinding.
- F1 will still open the manpage if the terminal doesn't intercept it.
- but z? has been repurposed (see below).
- Note that because iTerm reports Ctrl+H as Backspace, these help commands are also available by using Backspace (backspace for help, a new trend).
z Ctrl+H opens a list of commands available on this sheet.
Keybindings and longnames are separated out. The cmdlog now records longnames as well.
See the new keyboard layouts page (thanks to @deinspanjer for inspiration).

changes to existing commands and options

The experimental menu system (was Space) has been removed.
Now Space (exec-longname) executes the command for the input longname (tab completion of available commands is supported). (This function was previously bound to Ctrl+A).
options.wrap (for TextSheet wrapping of lines) now defaults to False.
R (random-sheet) opens a new sheet instead of selecting random rows (reverting to former behavior).
za (addcol-empty) asks for column name
zd (delete-cell) moves value to clipboard ("cut", like other delete commands)

options

options can now be set on specific sheet types or even individual sheets. Shift+O opens options for the current sheet type, and g Shift+O opens the global options sheet.
See available colors by pressing Space and then typing the longname colors.

new safety options

Error messages are sorted before informational status messages, and colored by color_error and color_warning (thanks to @jsvine for suggestion)
options.quitguard (default False to keep old behavior) if True, will confirm before quitting last sheet.
The gS (sheets-graveyard) command opens a sheet that shows all discarded (but "precious") sheets. These are stored as weak references so they will be garbage collected eventually, but can be resurrected from the graveyard sheet until then.
options.safety_first (default False) makes loading/saving more robust, likely at the cost of performance which can become significant in large files.
- Currently, only removes NULs from csv input.
options.tsv_safe_char is split into tsv_safe_newline and tsv_safe_tab.

new power features

z; (addcol-sh) adds new columns for stdout/stderr of a bash command, which uses $colname to substitute values from other columns (whole arguments only, so far).
z| (select-expr) and z\ (unselect-expr) select/unselect by Python expression (thanks to @jsvine for suggestion).
z/ (search-expr) and z? (searchr-expr) to search forward/backward by Python expression.
gI (describe-all) describes all columns in all sheeets (like gC (columns-all)).

nice things

The g(, z(, and gz( variants of ( ('expand-column') are filled out.
z# sets type of current column to len.

new loaders

yaml loader (thanks to @robcarrington, @JKiely, @anjakefala at PyCon Sprints for making this happen)
pcap loader (thanks to @vbrown608 and @TemperedNetworks)
xml loader
jsonl saver
[json loader] no more incremental display (need a better json parser than the Python stdlib offers)
pandas adapter (thanks to @jjzmajic for issue #162)

minor changes

System clipboard command detection is more portable (thanks to @chocolateboy for the PR).
date supports adding a number of days (or like foo+6*hours, foo+9*months, etc).
Hidden columns are darkened on columns sheet.
Exceptions are rolled up properly.
options.motd_url now uses https by default (thanks to @jsvine for the warning).
[DirSheet] mode is editable (set to octal like 0o0644).
[internal dev] ProfileSheet is improved.

known issues

cmdlog replay with a Ctrl+S (save-sheet) to an existing file gets stuck in an infinite loop when options.confirm_overwrite is on.
After renaming a file on a DirSheet, Ctrl+R (reload-sheet) is required to refresh the ext column for that row.
n/N (next-search/prev-search) won't continue a previous search-expr and searchr-expr.
show-aggregate with mean errors on int columns.
Contracting (with )) a previously expanded column on a dup-ed (with ") sheet results it in disappearing on the source sheet.

v1.2.1

2018-07-06T00:00:00Z

v1.2.1 (2018-07-06)

@deinspanjer (issue #164) discovered that VisiData doesn't work with Python3.7 due to our use of the 'async' identifier, which is now off-limits as it is a formal keyword as of 3.7. The only change in 1.2.1 is changing 'async' to 'asyncthread' in order to work with Python 3.7.

Thanks to the illustrious @anjakefala for getting this release out quickly and without incident (knock on wood).

v1.2

2018-05-03T00:00:00Z

v1.2 (2018-05-03)

Here are the major feature enhancements for v1.2. Please see the CHANGELOG for the complete list.

Major features

DirSheet enhancements (modify file metadata, move/delete files)
multisave (single file multisave to html, md, and txt format, or into a directory for other formats)
prototype macro system with z^S on the commandlog
New conda package

New commands and options

T to push derived sheet with transposed rows/columns
zs/zt/zu to select/unselect/toggle rows from top of sheet to cursor (thanks @SteveJSteiner for the suggestion)
gzs/gzt/gzu to select/unselect/toggle rows from bottom to cursor
gv to unhide all columns
gM to melt into multiple value columns
g* to transform selected rows in place
z</`z>' to move up/down to next null cell
^A to execute a command by its longname
gD to open the directory at options.visidata_dir (default ~/.visidata)

options

options.cmdlog_histfile to specify a file to auto-append commandlog to (default empty means disabled)
options.tsv_safe_char to replace tabs and newlines when writing .tsv format (default empty means disabled, for faster saving)
options.error_is_null to count errors as null (default false)

New supported formats and sources

sas7bda (SAS; requires sas7bdat)
xpt (SAS; requires xport)
sav (SPSS; requires savReaderWriter)
dta (Stata; requires pandas)
bz2 and xz (LZMA) compression (thanks @jpgrayson)

v1.1

2018-03-06T00:00:00Z

v1.1 (2018-03-06)

This is the first release since 1.0. The major additions and changes:

All external loader dependencies have been removed from the PyPI, brew, and Debian packages. This will make for much faster initial installation.
- The json, csv, tsv, and sqlite loaders are still available with the base installation as they are supported by the Python standard library. Other loaders will need their dependencies to be installed manually. See requirements.txt for which external packages to install for each loader.
An experimental command menu is now available via Space. The goal is to make it easier for people to explore the available functionality, and to try commands without knowing their keybindings.
- Use the standard VisiData movement keys (h/l/Arrows, q to back out)
- The help strings are shown during navigation, along with the available keybindings, so this will hopefully help people learn the keybindings as they use commands, without having to break their flow to refer to the manpage.
- Commands are organized in a hierarchy according to their longnames. This hierarchy may change in future releases, so these longnames are not yet stable enough to use for command aliases or in cmdlog replay. The actual command keys are more stable and should be preferred for the time being.
- If you play with the menu system, please let me know what did or didn't work for you!
The Y command series was added to copy ("yank") to the system clipboard (with options.clipboard_copy_cmd, set to pbclip for MacOS by default) to conveniently paste data in any supported text output format.
- Y copies the current row, zY copies the current cell, and gY copies all selected rows (or all rows).
- This mirrors the existing y command series, which yanks to VisiData's internal clipboard.
- now works as a filename to specify stdin/stdout. Useful especially in batch mode to dump final sheet to stdout (-b -o -).

New supported formats:

markdown (md) is now supported for saving (but not loading, yet) to an org-mode compatible table format.
.png files can now be loaded and saved, and crudely viewed on the canvas with an overloaded .. The pixels can be edited on the source sheet like any other data.
.ttf and .otf (font) files can be loaded and viewed on the canvas. This is super useful for just about no one, but it was a great excuse to implement Canvas.qcurve().

These commands have been added or changed, and are expected to stay in future versions:

The za command adds an empty, editable column to any sheet. gza adds N new columns.
The ( and ) commands will expand/collapse list/dict columns (e.g. in nested json).
In the canvas, d deletes points from source sheet that are contained within the cursor. gd deletes all points shown on the screen.
The !@#$%-_ special actions on the Columns Sheet and Describe Sheet have been removed. They were sometimes convenient, but more often made it difficult to interact with the Columns Sheet itself.
- The g forms of these commands are still available and will operate on the source columns (with the exception of g_, which now works consistently on all sheets as expected).
The Shift+Arrows are aliased to HJKL (though these may not work in all environments).

These additions are more experimental and may not stay in future versions:

The Backspace command drops the current sheet (like q), and also scrubs its history from the cmdlog.
ENTER is now aliased to modify-edit-cell by default.

Other minor changes:

search and select with no input now uses the most recent input. n/N do this already for row search (as before), but the new behavior works more like standard vim/less/etc tools, and also applies to non-row search (like c).
Many sheets (pivot, describe, melt, and many loaders) have improvements and bugfixes to make them even better.

Finally, some other news:

VisiData has been accepted into Debian for the next release! It is currently available if you've added the unstable repo; install with apt install visidata.
Jeremy Singer-Vine has put together a great tutorial for people who want a smoother path to start using VisiData.

Thanks to everyone who contributed to this release! As always, feedback and suggestions are welcome and appreciated.

v1.0

2018-01-25T00:00:00Z

v1.0 (2018-01-25)

VisiData 1.0 has been officially released! Changes since the 0.99 release candidate:

a complete overhaul of the website and documentation;
a 2x across-the-board performance improvement for async threads (from disabling profiling by default);
removed support for .visidatarc in the current directory and via XDG; only $HOME/.visidatarc is used now;
many bugfixes, both functional and cosmetic;
removed the "visidata[full]" package from PyPI;
a homebrew package (so you can now do brew install saulpw/vd/visidata on MacOS), and an apt package that is under review for inclusion in Debian.

This is a huge milestone for VisiData. I devoted my sabbatical (the entire year of 2017) to creating an open-source tool that would be useful for myself and other terminal users, and it was very important for me to release a stable and lasting 1.0 so that it could be set aside when I resumed working.

We could have gotten away without certain features and with fewer supported formats, but there is such breadth and depth included in 1.0 (as shown by demos like this one at the PyCascades 2018 conference), that I'm hard-pressed to choose which features should have been omitted.

I owe a great deal to many people who have helped and supported me through this process. VisiData would not be what it is without them. The list of contributors includes everyone who has submitted to the repository, but there are some other groups to whom VisiData and I are eternally indebted:

the Recurse Center, for maintaining an awesome space and incredibly supportive community that I am lucky to have become a part of;
Office Nomads, my local co-working space where I could work without turning into Jack Torrance;
and the Python community, for creating such a broadly useful language and ecosystem, without which VisiData would not be nearly as powerful.

Finally, a very special thanks to Anja for her incredible help in putting together the website, documentation, tests, and various releases.

Share and enjoy!

v0.99

2017-12-22T00:00:00Z

v0.99 (2017-12-22)

This is a 1.0 release candidate.

No changes will be made on stable before 1.0 except for targeted bugfixes with minimal likelihood of regressing anything else. If there are any more bugfixes to be applied, they will be cherry-picked from continuing develop. Either v0.99 or v0.99.1 will become the formal 1.0 in a few weeks.

User-facing changes in this version:

tab completion for filename and python expressions
load .html table elements (requires lxml)
- http urls are now usable as sources (requires requests)
save as .json
^W to erase a word in the line editor
gC views all columns on all sheets
median aggregator
v now 'visibility toggle' (moved from w)
--version (thanks to @jsvine)
options.use_default_colors (thanks to @wavexx)

v0.98.1

2017-12-04T00:00:00Z

v0.98.1 (2017-12-04)

v0.98.1 is a patch release that fixes a couple of minor bugs. The primary change in this release, however, is that the 'visidata' package on PyPI no longer includes all of the loaders' dependencies by default.

This is a minor hassle for first-time users if they want to use certain formats, but since the goal is eventually supporting every possible data format, installing all dependencies for all users by default is not tenable. The base VisiData already includes support for tsv, csv, fixed width, sqlite, graphs and more. Most users will only need one or two additional dependencies.

To install VisiData with all dependencies for all loaders:

pip3 install "visidata[full]"

Of course, you can install just the dependencies you need. See "SUPPORTED SOURCES" in the manpage for which packages to install.

v0.98

2017-11-23T00:00:00Z

v0.98 (2017-11-23)

Title: VisiData v0.98, now with graphs and maps (experimental)

When I announced that v0.97 was "feature complete", I must have been talking about vdtui. vdtui has been pretty stable, even as VisiData has added a low-resolution pixel canvas (using Braille unicode characters) to draw graphs and maps. In fact, apart from a few bug fixes and small API changes, the only addition to vdtui in v0.98 is basic mouse support.

Here's a list of what's new in VisiData v0.98:

visidata.org revamp
[canvas] graphs and maps!
- . or g. to push a graph or a map from the current sheet (dot=plot)
- supports .shp and vector .mbtiles
- mouse left-click/drag to set cursor
- mouse right-click/drag to scroll canvas
- scrollwheel to zoom in/out on a canvas
- s/u to select/unselect rows at canvas cursor
- ENTER to push source sheet with only rows at canvas cursor
- 1-9 to toggle display of 'layers' (colors)
- _ to zoom out to full width
- disp_pixel_random option chooses pixel attrs at random (weighted), instead of most common
- +/- to zoom in/out via keyboard
Updates to commands
- Remove ` (backtick) command
- Remove most zscroll commands (zs/ze)
  - zz moves cursor to center, uncertain about the future of zt due to conflict with t for toggle
- ga adds N new rows
- gz= sets value for selected/all rows to a Python sequence in this column
- z_ sets column width to given value
- z- cuts column width in half
- P is now "paste before" (like vim); R now pushes a random sample
- ^Z now sends SIGSTOP; ^O "opens" the external $EDITOR (from builtin line editor)
- [ColumnsSheet] Added ~!@#$ commands back, to set type of source columns
- w is becoming a more universal "visibility toggle"
  - [TextSheet] w toggles wordwrap
  - [canvas] w toggles display of the labels
  - [pyobj] w toggles hidden properties and methods
Updates to command line args and options
- set initial row/col with +<row#>:<col#> (numeric only)
- --delimiter/-d option (separate from --csv-delimiter) sets delimiter for tsv filetype
- --replay-wait/-w renamed from --delay/-d
- disp_date_fmt option for date display format string (default is date-only)
- zero_is_null/empty_is_null/none_is_null/false_is_null set which values are considered null (previously was aggr_null_filter)
- --skiplines option renamed to --skip, and --headerlines to --header
Design improvements
- Add specific rowtype for each sheet (see right status)
- dates are a kind of numeric type (useful for graphing as the x-axis)
- use_default_colors (at behest of @wavexx)
- more robust Progress indicator
- populate DescribeSheet in async thread
- remove default names for unnamed columns
- history up/down in edit widget now feels right
API changes
- change main Column API to getter(col, row) and setter(col, row, val)
- move Path and subclasses out of vdtui
- TextSheet source is any iterable of strings
- Sheet.filetype provides default save filename extension

v0.97.1

2017-10-29T00:00:00Z

v0.97.1 (2017-10-29)

It's VisiData's 1st birthday! I started working on VisiData 1 year ago today (Oct 29).

v0.97.1 has only a few small patches:

Fixed help manpage on OS/X (man has no --local-file option)
Fixed Postgres (incomplete lazy import)
Fixed ENTER on SheetsSheet on SheetsSheet to be no-op
Fixed readthedocs redirect to visidata.org

v0.97

2017-10-06T00:00:00Z

[originally sent as TinyLetter #1]

v0.97 (2017-10-06)

Important If you like VisiData, sign up for the newsletter!

Community

I'm hanging out in #visidata on freenode! Come by and say hi if you use VisiData. I'd love to know how you're using it!
~~r/visidata (on reddit) is the forum for longer-form discussion.~~
See the new webpage at visidata.org! We migrated away from RTD, as it was too much hassle and limited our functionality.
We have some example tours generated from our automated tests. See visidata.org/tour. More will be coming with the next release!

v0.97 has been released

The main themes for this release are:

commandlog replay fully operational (now running both automated tests and generating tours)
a quick ref guide in man page format (available in visidata via F1, and also online at visidata.org/man
visidata.org is now the primary home page (we've transitioned away from readthedocs)

There are also the usual suspects: new loaders, new commands, new options, and too many improvements and bugfixes to name. It is getting ever easier to write a new command or loader in a few minutes and have it just work.

With this release, VisiData is feature complete. There will still be many reworkings, interface changes, added commands, tweaks, embellishments, arguments, and explanations, but as far as I can see, all of the functionality is now there. We are inching ever closer to a v1.0 that will hopefully stand the test of time.

The main goals for the next release (v0.98) are 1) a set of great tours, and 2) documentation of the internal architecture: design decisions, implementation guidelines, and API references.

Here are some more detailed descriptions of what comes with this release:

New Loaders

simple remote postgres loader (vd postgres://user:password@dbserver.com:6254/database)
fixed width column detection (ls -al | vd -f fixed --skiplines 1)

New Commands and Options

F1 launches man page quick ref (gF1 now opens the command sheet)
vd --diff A B shows B with changes from A in red
a Describe Sheet with 'I' shows basic stats for every column!
streamlined commandlog (previously called editlog) functionality
^D to quickly save the current cmdlog; vd -p cmdlog-1.vd to replay it
removed movement commands (use --replay-movement to reinsert movements)
player piano with --delay (used to make the tours on the website)
advanced editing, can now make new sheets from whole cloth!
'A' to add a new sheet with some number of columns
'a' to add a new empty row
'gz=' set this column in selected rows to values from a python list expression
'Del'/gDel to clear a cell (set a value to None)
'y' to yank/delete row; 'p' to paste
'zy' to yank (copy) cell contents; 'zp' to paste ('gzp' to paste to all selected rows)
'f' to fill null cells with the previous non-null value

v0.93

2017-07-30T00:00:00Z

v0.93 (2017-07-30)
Fix display/feel bugs in editText
Remove BACKSPACE for editlog undo
Fix colorizer API
Add ctrl-u command to toggle profiling of main thread
Fix Column statistics (options.col_stats still disabled by default)