visidata 3.0.1__py3-none-any.whl → 3.1__py3-none-any.whl

visidata/guides/FrequencyTable.md

@@ -0,0 +1,42 @@
+# Frequency Tables are how you GROUP BY
+
+Frequency Tables group rows into bins by column value, and includes summary columns for source columns with aggregators.
+
+Set `--numeric-binning` to bin numeric rows into ranges instead of discrete values.
+
+- {help.commands.freq_col}
+
+- {help.commands.freq_keys}
+
+- {help.commands.freq_summary} 
+
+## Aggregators
+
+A **Frequency Table** contains a summary columns for each aggregator added to a source column.
+These aggregators need to be added before creating the Frequency Table.
+Examples of aggregators include min, max, sum, distinct, count, and list.
+
+- {help.commands.aggregate-col}
+
+Note: set an appropriate type for the aggregator target column, for example {help.commands.type_float}.
+
+## Explore the data
+
+Dive into a group to see the underlying row(s) using the **Frequency Table**:
+
+- {help.commands.open_row}
+- {help.commands.dive_selected}
+
+Select a group to select all of its underlying rows in the source sheet.
+
+## Using Split Panes with Frequency Tables
+
+Press `Shift+Z` to open a split pane, and then `Shift+F` to create a **Frequency Table**. The **Frequency Table** will automatically open in the other pane.
+
+See the `SplitpanesGuide` for more.
+
+#### Options
+
+- {help.options.disp_histogram}
+- {help.options.histogram_bins}
+- {help.options.numeric_binning}

visidata/guides/GrepSheet.md

@@ -0,0 +1,28 @@
+---
+sheettype: GrepSheet
+---
+
+# Using grep sheet
+
+The **GrepSheet** allows you to examine output of grep-like tools for line search.
+The typical way to use it would be:
+    grep -H -n pat file1 file2 | vd -f grep
+You can also load from a saved file ending in .grep:
+    grep -H -n pat file1 file2 > out.grep; vd -f grep out.grep
+
+**GrepSheet** works with other grep-like searchers, like the best-in-class ripgrep:
+    rg --sort path --json pat file1 file2 | vd -f grep
+or git-grep:
+    git grep -n class | vd -f grep
+
+## Editing files by pressing Enter
+
+- {help.commands.sysopen_row}
+
+If the file path is relative to a different directory from the current
+directory, use [:code]options.grep_base_dir[/] to specify the base directory
+for all relative paths. `$EDITOR` is a set environment variable.
+
+## Options to control GrepSheet behavior
+
+- {help.options.grep_base_dir}

visidata/guides/JsonSheet.md

@@ -0,0 +1,38 @@
+# Some special features for JSON
+
+## Working with nested data
+
+VisiData uses these conventions to display nested data:
+
+- {{2}} indicates a nested object with 2 keys
+- [3] indicates a nested array with 3 elements
+
+[:note_type]Expanding[/] unpacks nested data column-wise, often useful for nested objects:
+
+- {help.commands.expand-col}
+- {help.commands.expand-col-depth}
+- {help.commands.expand-cols}
+- {help.commands.expand-cols-depth}
+
+To revert earlier `expand-` operations:
+
+- {help.commands.contract-col}
+- {help.commands.contract-col-depth}
+- {help.commands.contract-cols}
+- {help.commands.contract-cols-depth}
+
+[:note_type]Unfurling[/] unpacks nested data row-wise, often useful for nested arrays:
+
+- {help.commands.unfurl-col}
+
+Note that `unfurl-col` creates a new sheet with `_unfurled` appended to the name. There is no command to revert an unfurl; instead, quit the unfurled sheet.
+
+For particularly deep or complex nested data, it can be helpful to open an individual cell as a new sheet:
+
+- {help.commands.open-cell}
+
+## Options to control JSON save behavior
+
+- {help.options.json_indent}
+- {help.options.json_sort_keys}
+- {help.options.json_ensure_ascii}

visidata/guides/MacrosSheet.md

@@ -0,0 +1,19 @@
+# Macros
+Macros allow you to bind a command sequence to a keystroke or longname, to replay when that keystroke is pressed or the command is executed by longname.
+
+The basic usage is:
+    1. {help.commands.macro_record}.
+    2. Execute a series of commands.
+    3. `m` again to complete the recording, and prompt for the keystroke or longname to bind it to.
+
+The macro will then be executed everytime the provided keystroke or longname are used. Note: the Alt+keys and the function keys are left unbound; overriding other keys may conflict with existing bindings, now or in the future.
+
+Executing a macro will the series of commands starting on the current row and column on the current sheet.
+
+# The Macros Sheet
+
+- {help.commands.macro_sheet}
+
+- `d` (`delete-row`) to mark macros for deletion
+- {help.commands.commit_sheet}
+- `Enter` (`open-row`) to open the macro in the current row, and view the series of commands composing it'''

visidata/guides/MeltGuide.md

@@ -0,0 +1,52 @@
+---
+sheettype: Sheet
+---
+# Melt is just unpivot
+
+Melt collapses the pivoted columns back into "Variable" and "Value" columns, converting from "wide" format into "long" format. After a melt, there is one row for each value in the pivot table.
+
+1. [Optional] remove a column from the output by hiding it: [:keys]-[/]
+2. [Optional] set key columns to keep them unmelted: [:keys]![/]
+
+3a. {help.commands.melt}
+
+A regex melt partially melts the pivoted columns. Provide a regular expression to separate the key column from other columns.
+
+3b. {help.commands.melt_regex}
+
+## Examples
+
+Start with a pivot table, created by pivoting a table with columns `R`,`B`, and key column `date`. There are two aggregators `sum` and `mean`:
+
+   date        sum_R  mean_R  sum_B  mean_B
+   ----------  -----  ------  -----  ------
+   2024-09-01  30     30      0
+   2024-09-02  0              28     28
+   2024-09-03  100    100     132    66
+
+Press `Shift+M` for a standard melt:
+
+   date        Variable  Value
+   ----------  --------  -----
+   2024-09-01  sum_R     30
+   2024-09-01  mean_R    30
+   2024-09-01  sum_B     0
+   2024-09-02  sum_R     0
+   2024-09-02  sum_B     28
+   2024-09-02  mean_B    28
+   2024-09-03  sum_R     100
+   2024-09-03  mean_R    100
+   2024-09-03  sum_B     132
+   2024-09-03  mean_B    66
+
+Or press `gShift+M` and then type a `regex` of `(\w+)_(\w)` to separate the aggregator from the column. Only the aggregator will be fully melted. The columns `R` and `B` will remain:
+
+   date        Variable  B    R
+   ----------  --------  ---  ---
+   2024-09-01  sum       0    30
+   2024-09-01  mean           30
+   2024-09-02  sum       28   0
+   2024-09-02  mean      28
+   2024-09-03  sum       132  100
+   2024-09-03  mean      66   100
+

visidata/guides/MemorySheet.md

@@ -0,0 +1,7 @@
+# The Memory Sheet 
+
+The **MemorySheet** provides a place to manually save cell values for later reference. It also automatically stores clipboard data when rows, cells or columns are copied.
+
+- {help.commands.memo_cell}
+- {help.commands.memo_aggregate}
+- {help.commands.open_memos}

visidata/guides/MenuGuide.md

@@ -0,0 +1,26 @@
+# The Menu System
+
+The menu (on the first row of the window) contains most commands, organized within a tree of submenus.
+
+Click on menu items to navigate the menu like a GUI.
+
+With the keyboard:
+
+- {help.commands.menu_help}
+- [:keys]Arrow[/] keys to move between submenus
+
+Additionally, each top-level menu name has a single letter underlined. [:keys]Alt+<underlined letter>[/] to open that menu. For example, [:keys]Alt+F[/] to open the **File** menu.
+
+Each non-submenu item is a command. It shows the description of the current command, along with the command name and its keyboard shortcut (if available). Click on the item or [:keys]Enter[/] to execute it.
+
+Indicators:
+
+- {help.options.disp_menu_more}
+- {help.options.disp_menu_push}
+- {help.options.disp_menu_input}
+
+Some commands are only available on a specific sheet type, and appear [:color_menu_spec]highlighted[/] in the menu when the current sheet is that type. If the command is not available, it will not appear at all.
+
+## Options
+
+- {help.options.disp_menu}

visidata/guides/ModifyGuide.md

@@ -0,0 +1,38 @@
+# Adding, Editing, Deleting Rows
+
+In addition to cutting and pasting (see **Clipboard Guide**), rows can be created from scratch, edited and deleted.
+
+- {help.commands.add-row}
+- {help.commands.add-rows}
+
+- {help.commands.delete-row}
+- {help.commands.delete-selected}
+
+- {help.commands.sysedit-selected}
+- {help.commands.edit_cell}
+
+While editing a cell, press `Ctrl+G` to cycle through the sidebar guides to see the **Input Keystroke Help**.
+
+A sample of available commands:
+    - [:code]Ctrl+O[/] to edit the cell in a text editor.
+    - [:code]Tab[/] to finish editing and go to the next cell
+    - [:code]Shift+Tab[/] to finish editing and go to the previous cell
+
+Modifying a sheet displays a `[M]` in the lower right status.
+
+## Deferred Sheets
+
+Some sheet types support *deferred* saving. Examples include **SQLiteSheet** and **Dir Sheet**. Changes are colored for [:add_pending]added rows[/], [:delete_pending]deleted rows[/], [:change_pending]modified cells[/].
+
+Commit the sheet to reflect changes on the filesystem.
+
+- {help.commands.commit_sheet}
+
+### Relevant options
+
+- {help.options.quitguard}
+
+- {help.options.color_add_pending}
+- {help.options.color_delete_pending}
+- {help.options.color_change_pending}
+

visidata/guides/PivotGuide.md

@@ -0,0 +1,71 @@
+---
+sheet: PivotSheet
+---
+# Pivot Tables are just Frequency Tables with more columns
+
+Pivot Tables group rows by key columns, summarizing aggregated columns for each distinct value in the current column.
+
+See the **MeltGuide** to unpivot.
+
+## Create a Pivot Table
+
+1. Set the primary column(s) as *key columns*. The values in this column will appear along the left side as row headings, and will be the values the dataset is grouped by.
+
+- {help.commands.key_col}
+
+2. (OPTIONAL) The default aggregation method for pivot cells is `count`. Add other aggregations to columns before building the pivot table. Each aggregation adds a column for every pivot column. See **Examples** below.
+
+Note: Custom aggregations replace the default `count` aggregation.
+
+- {help.commands.aggregate_col}
+
+3. Move the cursor to the column containing the pivot values to be aggregated for each group.
+
+4. Create the pivot table:
+
+- {help.commands.pivot}
+
+## Pivot Sheet
+
+Each cell in the pivot table, as in a **Frequency Table**, links to the underlying rows. Dive into a row to open a new sheet containing the linked rows.
+
+- {help.commands.open-row}
+
+## Examples
+
+Sample input sheet **sales**:
+
+   date        color  price
+   ----------  -----  -----
+   2024-09-01  R      30
+   2024-09-02  B      28
+   2024-09-03  R      100
+   2024-09-03  B      33
+   2024-09-03  B      99
+
+
+1. [:keys]![/] (`key-col`) on the **date** column to set it as a key column.
+2. [:keys]Shift+W[/] (`pivot`) on the **color** column to open a **Pivot Table** grouped by **date**, and summarizing **color**.
+
+   date        R  B
+   ----------  -  -
+   2024-09-01  1  0
+   2024-09-02  0  1
+   2024-09-03  1  2
+
+Note that each cell contains the row count because of the default `count` aggregation.
+
+3. [:keys]q[/] (`quit-sheet`) to return to the original **sales** sheet.
+4. [:keys]#[/] (`type-float`) on the **price** column to set its type to float.
+5. [:keys]+[/] (`aggregate-col`) to add a `sum` aggregate to the **price** column.
+6. [:keys]+[/] (`aggregate-col`) to add an `avg` aggregate to the **price** column.
+7. [:keys]Shift+W[/] (`pivot`) on the **color** column to create the **PivotSheet**.
+
+This generates each aggregation for all of the pivot columns. As mentioned above, any custom aggregations replace the default `count` aggregation:
+
+
+   date        sum_R   avg_R   sum_B   avg_B
+   ----------  ------  ------  ------  -----
+   2024-09-01   30.00   30.00    0.00
+   2024-09-02    0.00           28.00  28.00
+   2024-09-03  100.00  100.00  132.00  66.00

visidata/guides/RegexGuide.md

@@ -0,0 +1,107 @@
+---
+sheet: Sheet
+---
+# Matching and Transforming Strings with Regex
+
+Some commands for selecting, searching, and transforming data, accept a regular expression as input.
+
+## Select Rows
+
+- {help.commands.select-col-regex}
+- {help.commands.select-cols-regex}
+
+- {help.commands.unselect-col-regex}
+- {help.commands.unselect-cols-regex}
+
+## Search
+
+- {help.commands.go-col-regex}
+
+- {help.commands.search-col}
+- {help.commands.search-cols}
+
+- {help.commands.searchr-col}
+- {help.commands.searchr-cols}
+
+- {help.commands.search-next}
+- {help.commands.searchr-next}
+
+- {help.commands.search-keys}
+
+## Substitution
+
+- {help.commands.setcol-regex-subst}
+- {help.commands.setcol-regex-subst-all}
+
+`Tab` to move between `search` and `replace` inputs.
+An empty `replace` removes the matching string.
+
+# Column Creation
+
+- {help.commands.addcol-regex-subst}
+- {help.commands.addcol-split}
+- {help.commands.addcol-capture}
+
+## Examples
+
+### Split
+
+Sample input sheet **sales**:
+
+    date        price
+    ----------  -----
+    2024-09-01  30
+    2024-09-02  28
+    2024-09-03  100
+
+1. [:code]:[/] (`addcol-split`) on **date** column, followed by `-` to split on hyphens.
+
+    date        date_re             price
+    ----------  ----------------    -----
+    2024-09-01  [3] 2024; 09; 01    30
+    2024-09-02  [3] 2024; 09; 02    28
+    2024-09-03  [3] 2024; 09; 03    100
+
+Note that the results in the `date_re` column are lists of length 3.
+
+2. [:code]([/] (`expand-col`) to expand a column with lists into multiple columns with the list elements.
+
+    date        date_re[0]  date_re[1]  date_re[2]  price
+    ----------  ----------  ----------  ----------  -----
+    2024-09-01  2024        09          01          30
+    2024-09-02  2024        09          02          28
+    2024-09-03  2024        09          03          100
+
+### Substitution
+
+1. On the **date** column, [:code]*[/] (`addcol-regex-subst`) and type `-`, then `Tab` to "replace" and type `,`.  Then `Enter` to replace all `-` with `,`.
+
+    date        date_re     price
+    ----------  ----------  -----
+    2024-09-01  2024,09,01  30
+    2024-09-02  2024,09,02  28
+    2024-09-03  2024,09,03  100
+
+### Capture
+
+1. On the **date** column, [:code];[/] (`addcol-capture`) and type `(\d\d\d\d)` to capture and pull out the year.
+
+    date        date_re     price
+    ----------  --------    -----
+    2024-09-01  [1] 2024    30
+    2024-09-02  [1] 2024    28
+    2024-09-03  [1] 2024    100
+
+Note that the results in the `date_re` column are lists of length 1.
+
+2. [:code]([/] (`expand-col`) to expand a column with lists into multiple columns with the list elements.
+
+    date        date_re[0]  price
+    ----------  ----------  -----
+    2024-09-01  2024        30
+    2024-09-02  2024        28
+    2024-09-03  2024        100
+
+#### Options
+
+- {help.options.regex_maxsplit}

visidata/guides/SelectionGuide.md

@@ -0,0 +1,44 @@
+# Selecting and filtering
+
+Some commands operate only on "selected rows".  For instance, a common command to filter is {help.commands.dup_selected}.
+
+Many g-prefixed commands are like this. For example, use {help.commands.edit_cell}, but use {help.commands.setcol_input}.  Search for "selected rows" in the [:onclick help-commands-all]commands list[/] or the [:onclick sysopen-help]manpage[/] for a full list.
+
+Rows on the **Frequency Table** or **Pivot Table** reference a group of rows from the source sheet.  Selecting a row on those sheets also selects the referenced rows on the underlying source sheet.
+
+Select and unselect rows with these commands:
+
+## One row at a time
+
+- {help.commands.select_row}
+- {help.commands.unselect_row}
+- {help.commands.stoggle_row}
+
+## All rows at the same time
+
+- {help.commands.select_rows}
+- {help.commands.unselect_rows}
+- {help.commands.stoggle_rows}
+
+## By matching patterns
+
+- {help.commands.select_col_regex}
+- {help.commands.unselect_col_regex}
+- {help.commands.select_cols_regex}
+- {help.commands.unselect_cols_regex}
+
+- {help.commands.select_equal_cell}
+- {help.commands.select_equal_row}
+
+## Select by Python expression
+
+Python expressions can use a column value by the column name, if the
+column name is a valid Python identifier (with only letters, digits, and underscores).
+
+- {help.commands.select_expr}
+- {help.commands.unselect_expr}
+
+## Options
+
+- {help.options.bulk_select_clear}
+- {help.options.some_selected_rows}

visidata/guides/SlideGuide.md

@@ -0,0 +1,26 @@
+# The Slide Guide
+
+The key bindings are based on the vi movement keys (hjkl).
+
+## How to move columns
+
+- {help.commands.slide_left}
+- {help.commands.slide_right}
+
+- {help.commands.slide_leftmost}
+- {help.commands.slide_rightmost}
+
+- {help.commands.slide_left_n}
+- {help.commands.slide_right_n}
+
+## How to move rows
+
+- {help.commands.slide_down}
+- {help.commands.slide_up}
+
+- {help.commands.slide_bottom}
+- {help.commands.slide_top}
+
+- {help.commands.slide_down_n}
+- {help.commands.slide_up_n}
+

visidata/guides/SplitpaneGuide.md

@@ -0,0 +1,15 @@
+# Split VisiData into two panes
+
+Use split panes to view two sheets at once.
+
+## Open and Close a new split
+
+- {help.commands.splitwin_half}
+- {help.commands.splitwin_close}
+- {help.commands.splitwin_input}
+
+## Modify the split plane view
+
+- {help.commands.splitwin_swap}
+- Additionally, click on the inactive pane with the mouse to jump to it.
+- {help.commands.splitwin_swap_pane}

visidata/guides/TypesSheet.md

@@ -0,0 +1,43 @@
+# Types
+
+Columns usually begin as untyped (`anytype`), but can be set to specific types.
+
+- {help.commands.type-any}
+- {help.commands.type-currency}
+- {help.commands.type-date}
+- {help.commands.type-float}
+- {help.commands.type-int}
+- {help.commands.type-len}
+- {help.commands.type-string}
+
+## Type formatting
+
+VisiData pre-set defaults for formatting types:
+
+- `currency` removes non-numeric characters and parses the remainder as `float`.
+- `date` parses dates into date object (shown as ISO8601).
+- `vlen` formats the cell value to the length of the content
+- `float` uses the decimal seperator, keeping two significant digits.
+
+Change float precision with:
+- {help.commands.setcol-precision-less}
+- {help.commands.setcol-precision-more}
+
+To change the default fmtstr for a type:
+
+- {help.options.disp_currency_fmt}
+- {help.options.color_currency_neg}
+- {help.options.disp_date_fmt}
+- {help.options.disp_float_fmt}
+- {help.options.disp_int_fmt}
+
+
+## Importance of typing
+
+Certain commands behave differently depending on how the column is typed.
+
+Grouping by a numeric column in a Frequency table can result in numeric range binning. Grouping by a string results in categorical binning.
+
+Un-typed columns (`anytype`) often default to `string`-like behaviour. Errors when working with numerical or datetime data is often due to values being considered as strings.
+
+For example. [:code]addcol-expr col1+col2[/] results in a concatenation of the two columns when they are `anytype`, and addition when they are numerical.

visidata/guides/XsvGuide.md

@@ -0,0 +1,36 @@
+CSV/TSV options
+
+## `tsv` (Tab Separated Values), as simple as it gets
+
+- {help.options.delimiter}
+- {help.options.row_delimiter}
+- {help.options.tsv_safe_newline}
+- {help.options.tsv_safe_tab}
+
+Use `-f usv` for Unicode separators U+241F and U+241E.
+Use `-f lsv` for awk-like records.
+Use `--delimiter=` (an empty string) to make '\0' the value separator.
+Use `--row-delimiter=` to make '\0' the row separator.
+
+## `csv` (Comma Separated Values) for maximum computibility
+
+.csv files are a scourge upon the earth, and still regrettably common.
+All csv_* options are passed unchanged into csv.reader() and csv.writer().
+
+- {help.options.csv_dialect}
+   - Accepted dialects are `excel-tab`, `unix`, and `excel`.
+- {help.options.csv_delimiter}
+- {help.options.csv_quotechar}
+- {help.options.csv_skipinitialspace}
+- {help.options.csv_escapechar}
+- {help.options.csv_lineterminator}
+
+## Saving TSV/CSV files
+
+- {help.options.save_filetype}
+- {help.options.safety_first}
+
+## Useful options for text formats in general
+
+- {help.options.regex_skip}
+- {help.options.save_encoding}

visidata/help.py

@@ -2,13 +2,13 @@ import functools
 import collections
 
 from visidata import VisiData, MetaSheet, ColumnAttr, Column, BaseSheet, VisiDataMetaSheet, SuspendCurses
-from visidata import vd, asyncthread, ENTER, drawcache, AttrDict
+from visidata import vd, asyncthread, ENTER, drawcache, AttrDict, TextSheet
 
-vd.option('disp_help', 2, 'show help panel during input')
+vd.option('disp_expert', 0, 'max level of options and columns to include')
 
 @BaseSheet.api
 def hint_basichelp(sheet):
-    return 0, '`Alt+[:underline]H[/]` to open the [:underline]H[/]elp menu'
+    return 0, 'Alt+H to open the [:underline]H[/]elp menu'
 
 
 @VisiData.api
@@ -43,12 +43,12 @@ class HelpSheet(MetaSheet):
         ColumnAttr('sheet'),
         ColumnAttr('module'),
         ColumnAttr('longname'),
-        Column('menupath', width=0, cache=True, getter=lambda col,row: vd.menuPathsByLongname[row.longname]),
+        Column('menupath', width=0, cache=True, getter=lambda col,row: vd.menuPathsByLongname.get(row.longname, None)),
         Column('keystrokes', getter=lambda col,row: col.sheet.revbinds.get(row.longname, [None])[0]),
         Column('all_bindings', width=0, cache=True, getter=lambda col,row: list(set(col.sheet.revbinds.get(row.longname, [])))),
-        Column('description', width=40, getter=lambda col,row: col.sheet.cmddict[(row.sheet, row.longname)].helpstr),
+        Column('description', width=70, getter=lambda col,row: col.sheet.cmddict[(row.sheet, row.longname)].helpstr),
         ColumnAttr('execstr', width=0),
-        Column('logged', width=0, getter=lambda col,row: vd.isLoggableCommand(row.longname)),
+        Column('logged', width=0, getter=lambda col,row: vd.isLoggableCommand(row)),
     ]
     nKeys = 2
 

visidata/hint.py

@@ -26,8 +26,8 @@ def getHint(sheet, *args, **kwargs) -> str:
                     n = 1
                     v = r
 
+                results.append((n, v))
                 if v not in sheet.prevHints:
-                    results.append((n, v))
                     sheet.prevHints[v] += 1
         except Exception as e:
             vd.debug(f'{f.__name__}: {e}')
@@ -35,5 +35,6 @@ def getHint(sheet, *args, **kwargs) -> str:
     if results:
         return sorted(results, reverse=True)[0][1]
 
+    return ''
 
 vd.addCommand('', 'help-hint', 'status(getHint() or pressMenu("Help"))', 'get context-dependent hint on what to do next')

visidata/indexsheet.py

@@ -100,8 +100,8 @@ IndexSheet.addCommand('g^R', 'reload-selected', 'reloadSheets(selectedRows or ro
 
 # when diving into a sheet, remove the index unless it is precious
 SheetsSheet.addCommand('gC', 'columns-selected', 'vd.push(ColumnsSheet("all_columns", source=selectedRows))', 'open Columns Sheet with all visible columns from selected sheets')
-SheetsSheet.addCommand('z^C', 'cancel-row', 'cancelThread(*cursorRow.currentThreads)', 'abort async thread for current sheet')
-SheetsSheet.addCommand('gz^C', 'cancel-rows', 'for vs in selectedRows: cancelThread(*vs.currentThreads)', 'abort async threads for selected sheets')
+IndexSheet.addCommand('^C', 'cancel-row', 'cancelThread(*cursorRow.currentThreads)', 'abort async thread for current sheet')
+IndexSheet.addCommand('gz^C', 'cancel-rows', 'for vs in selectedRows: cancelThread(*vs.currentThreads)', 'abort async threads for selected sheets')
 SheetsSheet.addCommand('Enter', 'open-row', 'dest=cursorRow; vd.sheets.remove(sheet) if not sheet.precious else None; vd.push(openRow(dest))', 'open sheet referenced in current row')
 
 vd.addGlobals(IndexSheet=IndexSheet,