visidata 3.0.2__py3-none-any.whl → 3.1.1__py3-none-any.whl

visidata/man/vd.1

@@ -1,4 +1,4 @@
-.Dd January 15, 2024
+.Dd October 13, 2024
 .Dt vd \&1 "Quick Reference Guide"
 .Os Linux/MacOS
 .
@@ -21,6 +21,10 @@
 .Op Ar options
 .Op Ar input No ...
 .
+.Nm visidata
+.Op Ar options
+.Op Ar input No ...
+.
 .Nm vd
 .Op Ar options
 .Cm --play Ar cmdlog
@@ -33,7 +37,7 @@
 .Nm vd
 .Op Ar options
 .Op Ar input No ...
-.Cm + Ns Ar toplevel Ns : Ns Ar subsheet Ns : Ns Ar col Ns : Ns Ar row
+.Cm + Ns Ar toplevel Ns : Ns Ar subsheet Ns : Ns Ar row Ns : Ns Ar col
 .
 .Sh DESCRIPTION
 .Nm VisiData No is an easy-to-use multipurpose tool to explore, clean, edit, and restructure data.
@@ -101,7 +105,7 @@ toggle sidebar
 .No redo the most recent undo ( requires enabled Sy options.undo Ns )
 .Pp
 .It Ic "Space" Ar longname
-.No open command palette; Sy Enter No to execute top command by its Ar longname
+.No open command palette; execute top command by its Ar longname
 .El
 .Ss "  Command Palette"
 .Bl -tag -width XXXXXXXXXXXXXXX -compact -offset XXX
@@ -137,9 +141,9 @@ scroll current row to center of screen
 jump to previous sheet (swaps with current sheet)
 .Pp
 .It Ic  " /   ?" Ar regex
-.No search for Ar regex No forward/backward in current column
+.No search for Ar regex No forward/backward in current column's displayed values
 .It Ic  "g/  g?" Ar regex
-.No search for Ar regex No forward/backward over all visible columns
+.No search for Ar regex No forward/backward over all visible columns' displayed values
 .It Ic  "z/  z?" Ar expr
 .No search by Python Ar expr No forward/backward in current column (with column names as variables)
 .It Ic  " n   N"
@@ -236,6 +240,7 @@ open a frozen copy of current sheet with all visible columns evaluated
 .It Ic "z'  gz'"
 add/reset cache for current/all visible column(s)
 .Pp
+.It Note that regex operations apply to the displayed value in a cell.
 .It Ic " \&:" Ar regex
 .No add new columns from Ar regex No split; number of columns determined by example row at cursor
 .It Ic " \&;" Ar regex
@@ -875,8 +880,8 @@ show/hide methods and hidden properties
 .Bl -tag -width XXXXXXXXXXXXXXXXXXXXXXXXXXX -compact
 .It Cm -P Ns = Ns Ar longname
 .No preplay Ar longname No before replay or regular launch; limited to Sy Base Sheet No bound commands
-.It Cm + Ns Ar toplevel Ns : Ns Ar subsheet Ns : Ns Ar col Ns : Ns Ar row
-.No launch vd with Ar subsheet No of Ar toplevel No at top-of-stack, and cursor at Ar col No and Ar row Ns ; all arguments are optional
+.It Cm + Ns Ar toplevel Ns : Ns Ar subsheet Ns : Ns Ar row Ns : Ns Ar col
+.No launch vd with Ar subsheet No of Ar toplevel No at top-of-stack, and cursor at Ar row No and Ar col Ns ; all arguments are optional
 .It Cm --overwrite Ns = Ns Ar c
 .No Overwrite with confirmation
 .It Cm --guides
@@ -915,14 +920,6 @@ exit on error and display stacktrace
 enable undo/redo
 .It Sy --col-cache-size Ns = Ns Ar "int        " No "0"
 max number of cache entries in each cached column
-.It Sy --note-pending Ns = Ns Ar "str          " No "\[u231B]"
-note to display for pending cells
-.It Sy --note-format-exc Ns = Ns Ar "str       " No "?"
-cell note for an exception during formatting
-.It Sy --note-getter-exc Ns = Ns Ar "str       " No "!"
-cell note for an exception during computation
-.It Sy --note-type-exc Ns = Ns Ar "str         " No "!"
-cell note for an exception during type conversion
 .It Sy --scroll-incr Ns = Ns Ar "int           " No "-3"
 amount to scroll with scrollwheel
 .It Sy --force-256-colors No "          False"
@@ -933,12 +930,12 @@ confirm before quitting modified sheet
 default column width
 .It Sy --default-height Ns = Ns Ar "int        " No "4"
 default column height
-.It Sy --textwrap-cells Ns = Ns Ar "bool       " No "True"
-wordwrap text for multiline rows
 .It Sy --name-joiner Ns = Ns Ar "str           " No "_"
 string to join sheet or column names
 .It Sy --value-joiner Ns = Ns Ar "str          " No " "
 string to join display values
+.It Sy --max-rows Ns = Ns Ar "int              " No "1000000000"
+number of rows to load from source
 .It Sy --wrap No "                      False"
 wrap text to fit window width on TextSheet
 .It Sy --save-filetype Ns = Ns Ar "str         " No "tsv"
@@ -1024,7 +1021,7 @@ source of randomized startup messages
 folder recursion depth on DirSheet
 .It Sy --dir-hidden No "                False"
 load hidden files on DirSheet
-.It Sy --config Ns = Ns Ar "Path               " No "~/.visidatarc"
+.It Sy --config Ns = Ns Ar "Path               " No "/home/saul/.visidatarc"
 config file to exec in Python
 .It Sy --play Ns = Ns Ar "str                  " No ""
 file.vdj to replay
@@ -1058,7 +1055,7 @@ device ID associated with matrix login
 client_id for reddit api
 .It Sy --reddit-client-secret Ns = Ns Ar "str  " No ""
 client_secret for reddit api
-.It Sy --reddit-user-agent Ns = Ns Ar "str     " No "3.0.2"
+.It Sy --reddit-user-agent Ns = Ns Ar "str     " No "3.1dev"
 user_agent for reddit api
 .It Sy --zulip-batch-size Ns = Ns Ar "int      " No "-100"
 number of messages to fetch per call (<0 to fetch before anchor)
@@ -1074,8 +1071,12 @@ Email for use with Zulip API key
 dialect passed to csv.reader
 .It Sy --csv-delimiter Ns = Ns Ar "str         " No ","
 delimiter passed to csv.reader
+.It Sy --csv-doublequote Ns = Ns Ar "bool      " No "True"
+quote-doubling setting passed to csv.reader
 .It Sy --csv-quotechar Ns = Ns Ar "str         " No """
 quotechar passed to csv.reader
+.It Sy --csv-quoting Ns = Ns Ar "int           " No "0"
+quoting style passed to csv.reader and csv.writer
 .It Sy --csv-skipinitialspace Ns = Ns Ar "bool " No "True"
 skipinitialspace passed to csv.reader
 .It Sy --csv-escapechar Ns = Ns Ar "NoneType   " No "None"
@@ -1097,6 +1098,8 @@ number of rows to check for fixed width columns
 max number of fixed-width columns to create (0 is no max)
 .It Sy --graphviz-edge-labels Ns = Ns Ar "bool " No "True"
 whether to include edge labels on graphviz diagrams
+.It Sy --grep-base-dir Ns = Ns Ar "NoneType    " No "None"
+base directory for relative paths opened with sysopen-row
 .It Sy --html-title Ns = Ns Ar "str            " No "<h2>{sheet.name}</h2>"
 table header when saving to html
 .It Sy --http-max-next Ns = Ns Ar "int         " No "0"
@@ -1123,6 +1126,8 @@ show all object versions in a versioned bucket
 sqlite statement to execute after opening a connection
 .It Sy --xlsx-meta-columns No "         False"
 include columns for cell objects, font colors, and fill colors
+.It Sy --xlsx-color-cells Ns = Ns Ar "bool     " No "True"
+color cells based on xlsx source
 .It Sy --xml-parser-huge-tree Ns = Ns Ar "bool " No "True"
 allow very deep trees and very long text content
 .It Sy --plt-marker Ns = Ns Ar "str            " No "."
@@ -1188,7 +1193,7 @@ command submenu indicator
 indicator if command pushes sheet onto sheet stack
 .It Sy "disp_menu_input    " No "\[u2026]"
 indicator if input required for command
-.It Sy "disp_menu_fmt      " No "| VisiData {vd.version} | Alt+H for help menu"
+.It Sy "disp_menu_fmt      " No "| VisiData {vd.version} | {vd.hintStatus}"
 right-side menu format string
 .It Sy "disp_float_fmt     " No "{:.02f}"
 default fmtstr to format float values
@@ -1216,7 +1221,15 @@ displayed contents for computation exception
 width to use for unicode chars marked ambiguous
 .It Sy "disp_pending       " No ""
 string to display in pending cells
-.It Sy "color_note_pending " No "bold magenta"
+.It Sy "disp_note_pending  " No ":"
+note to display for pending cells
+.It Sy "disp_note_fmtexc   " No "?"
+cell note for an exception during formatting
+.It Sy "disp_note_getexc   " No "!"
+cell note for an exception during computation
+.It Sy "disp_note_typeexc  " No "!"
+cell note for an exception during type conversion
+.It Sy "color_note_pending " No "bold green"
 color of note in pending cells
 .It Sy "color_note_type    " No "226 yellow"
 color of cell note for non-str types in anytype columns
@@ -1254,19 +1267,19 @@ characters for ascending sort
 characters for descending sort
 .It Sy "color_default      " No "white on black"
 the default fg and bg colors
-.It Sy "color_default_hdr  " No "bold"
+.It Sy "color_default_hdr  " No "bold white on black"
 color of the column headers
-.It Sy "color_bottom_hdr   " No "underline"
+.It Sy "color_bottom_hdr   " No "underline white on black"
 color of the bottom header row
 .It Sy "color_current_row  " No "reverse"
 color of the cursor row
-.It Sy "color_current_col  " No "bold"
+.It Sy "color_current_col  " No "bold on 232"
 color of the cursor column
 .It Sy "color_current_cell " No ""
 color of current cell, if different from color_current_row+color_current_col
 .It Sy "color_current_hdr  " No "bold reverse"
 color of the header for the cursor column
-.It Sy "color_column_sep   " No "246 blue"
+.It Sy "color_column_sep   " No "white on black"
 color of column separators
 .It Sy "color_key_col      " No "81 cyan"
 color of key columns
@@ -1274,27 +1287,41 @@ color of key columns
 color of hidden columns on metasheets
 .It Sy "color_selected_row " No "215 yellow"
 color of selected rows
-.It Sy "color_clickable    " No "underline"
+.It Sy "color_clickable    " No "bold"
 color of internally clickable item
 .It Sy "color_code         " No "bold white on 237"
 color of code sample
-.It Sy "color_heading      " No "bold 200"
+.It Sy "color_heading      " No "bold black on yellow"
 color of header
 .It Sy "color_guide_unwritten" No "243 on black"
 color of unwritten guides in GuideGuide
-.It Sy "disp_rstatus_fmt   " No "{sheet.threadStatus} {sheet.keystrokeStatus}   [:longname]{sheet.longname}[/]  {sheet.nRows:9d} {sheet.rowtype} {sheet.modifiedStatus}{sheet.selectedStatus}{vd.replayStatus}"
+.It Sy "disp_wrap_max_lines" No "3"
+max lines for multiline view
+.It Sy "disp_wrap_break_long_words" No "False"
+break words longer than column width in multiline
+.It Sy "disp_wrap_replace_whitespace" No "False"
+replace whitespace with spaces in multiline
+.It Sy "disp_wrap_placeholder" No "\[u2026]"
+multiline string to indicate truncation
+.It Sy "disp_multiline_focus" No "True"
+only multiline cursor row
+.It Sy "color_aggregator   " No "bold 255 white on 234 black"
+color of aggregator summary on bottom row
+.It Sy "disp_rstatus_fmt   " No "{sheet.threadStatus} {sheet.keystrokeStatus}   [:longname_status]{sheet.longname}[/]  {sheet.nRows:9d} {sheet.rowtype} {sheet.modifiedStatus}{sheet.selectedStatus}{vd.replayStatus}{vd.sidebarStatus}"
 right-side status format string
-.It Sy "disp_status_fmt    " No "[:onclick sheets-stack]{sheet.shortcut}\[u203A] {sheet.name}[/]| "
-status line prefix
+.It Sy "disp_status_fmt    " No "{sheet.sheetlist}| "
+left-side status format string
 .It Sy "disp_lstatus_max   " No "0"
 maximum length of left status line
 .It Sy "disp_status_sep    " No "\[u2502]"
 separator between statuses
 .It Sy "color_keystrokes   " No "bold white on 237"
 color of input keystrokes
-.It Sy "color_longname     " No "bold 52 on 114 green"
+.It Sy "color_longname_guide" No "237"
 color of command longnames
-.It Sy "color_keys         " No "bold"
+.It Sy "color_longname_status" No "white"
+color of command longnames
+.It Sy "color_keys         " No "bold reverse"
 color of keystrokes in help
 .It Sy "color_status       " No "bold on 238"
 status line color
@@ -1328,6 +1355,8 @@ default fmtstr to format for currency values
 color for negative values in currency displayer
 .It Sy "disp_replay_play   " No "\[u25B6]"
 status indicator for active replay
+.It Sy "disp_replay_record " No "\[u23FA]"
+status indicator for macro record
 .It Sy "color_status_replay" No "green"
 color of replay status indicator
 .It Sy "disp_histogram     " No "\[u25A0]"
@@ -1348,8 +1377,16 @@ color of selected graph points
 color for graph axis labels
 .It Sy "disp_graph_tick_x  " No "\[u2575]"
 character for graph x-axis ticks
-.It Sy "disp_help          " No "2"
-show help panel during input
+.It Sy "color_graph_refline" No ""
+color for graph reference value lines
+.It Sy "disp_graph_reflines_x_charset" No "\[u258F]\[u2502]\[u2502]\[u2595]"
+charset to render vertical reference lines on graph
+.It Sy "disp_graph_reflines_y_charset" No "\[u2594]\[u2500]\[u2500]\[u2581]"
+charset to render horizontal reference lines on graph
+.It Sy "disp_graph_multiple_reflines_char" No "\[u2592]"
+char to render multiple parallel reflines
+.It Sy "disp_expert        " No "0"
+max level of options and columns to include
 .It Sy "color_add_pending  " No "green"
 color for rows pending add
 .It Sy "color_change_pending" No "reverse yellow"
@@ -1358,7 +1395,7 @@ color for cells pending modification
 color for rows pending delete
 .It Sy "disp_sidebar       " No "True"
 whether to display sidebar
-.It Sy "disp_sidebar_fmt   " No "{guide}"
+.It Sy "disp_sidebar_fmt   " No ""
 format string for default sidebar
 .It Sy "disp_sidebar_width " No "0"
 max width for sidebar
@@ -1394,10 +1431,6 @@ color of active clue
 base color of command palette
 .It Sy "disp_cmdpal_max    " No "10"
 max number of suggestions for command palette
-.It Sy "color_shellcmd     " No "21 on 114 green"
-
-.It Sy "color_colname      " No "underline"
-
 .It Sy "disp_scroll_context" No "0"
 minimum number of lines to keep visible above/below cursor when scrolling
 .It Sy "disp_sparkline     " No "\[u2581]\[u2582]\[u2583]\[u2584]\[u2585]\[u2586]\[u2587]"

visidata/man/vd.txt

@@ -5,9 +5,10 @@ NAME
 
 SYNOPSIS
      vd [options] [input ...]
+     visidata [options] [input ...]
      vd [options] --play cmdlog [-w waitsecs] [--batch] [-i] [-o output]
         [field=value]
-     vd [options] [input ...] +toplevel:subsheet:col:row
+     vd [options] [input ...] +toplevel:subsheet:row:col
 
 DESCRIPTION
      VisiData is an easy-to-use multipurpose tool to explore, clean, edit, and
@@ -53,8 +54,8 @@ DESCRIPTION
        R              redo the most recent undo (requires enabled
                       options.undo)
 
-     Space longname   open command palette; Enter to execute top command by
-                      its longname
+     Space longname   open command palette; execute top command by its
+                      longname
 
      Command Palette
         Tab              Move to command palette, and cycle through commands
@@ -73,9 +74,10 @@ DESCRIPTION
 
      ^^ (Ctrl+^)      jump to previous sheet (swaps with current sheet)
 
-      /   ? regex     search for regex forward/backward in current column
+      /   ? regex     search for regex forward/backward in current column's
+                      displayed values
      g/  g? regex     search for regex forward/backward over all visible
-                      columns
+                      columns' displayed values
      z/  z? expr      search by Python expr forward/backward in current column
                       (with column names as variables)
       n   N           go to next/previous match from last regex search
@@ -143,6 +145,7 @@ DESCRIPTION
                       columns evaluated
      z'  gz'          add/reset cache for current/all visible column(s)
 
+     Note that regex operations apply to the displayed value in a cell.
       : regex         add new columns from regex split; number of columns
                       determined by example row at cursor
       ; regex         add new columns from capture groups of regex (also
@@ -563,8 +566,8 @@ COMMANDLINE OPTIONS
 
      -P=longname                  preplay longname before replay or regular
                                   launch; limited to Base Sheet bound commands
-     +toplevel:subsheet:col:row   launch vd with subsheet of toplevel at
-                                  top-of-stack, and cursor at col and row; all
+     +toplevel:subsheet:row:col   launch vd with subsheet of toplevel at
+                                  top-of-stack, and cursor at row and col; all
                                   arguments are optional
      --overwrite=c                Overwrite with confirmation
      --guides                     open Guide Index
@@ -587,15 +590,6 @@ COMMANDLINE OPTIONS
      --col-cache-size=int         0                  max number of cache en‐
                                                      tries in each cached col‐
                                                      umn
-     --note-pending=str           ⌛                 note to display for pend‐
-                                                     ing cells
-     --note-format-exc=str        ?                  cell note for an excep‐
-                                                     tion during formatting
-     --note-getter-exc=str        !                  cell note for an excep‐
-                                                     tion during computation
-     --note-type-exc=str          !                  cell note for an excep‐
-                                                     tion during type conver‐
-                                                     sion
      --scroll-incr=int            -3                 amount to scroll with
                                                      scrollwheel
      --force-256-colors           False              use 256 colors even if
@@ -604,12 +598,12 @@ COMMANDLINE OPTIONS
                                                      modified sheet
      --default-width=int          20                 default column width
      --default-height=int         4                  default column height
-     --textwrap-cells=bool        True               wordwrap text for multi‐
-                                                     line rows
      --name-joiner=str            _                  string to join sheet or
                                                      column names
      --value-joiner=str                              string to join display
                                                      values
+     --max-rows=int               1000000000         number of rows to load
+                                                     from source
      --wrap                       False              wrap text to fit window
                                                      width on TextSheet
      --save-filetype=str          tsv                specify default file type
@@ -708,7 +702,7 @@ COMMANDLINE OPTIONS
                                                      DirSheet
      --dir-hidden                 False              load hidden files on
                                                      DirSheet
-     --config=Path                ~/.visidatarc
+     --config=Path                /home/saul/.visidatarc
                                                      config file to exec in
                                                      Python
      --play=str                                      file.vdj to replay
@@ -745,7 +739,7 @@ COMMANDLINE OPTIONS
      --reddit-client-id=str                          client_id for reddit api
      --reddit-client-secret=str                      client_secret for reddit
                                                      api
-     --reddit-user-agent=str      3.0.2              user_agent for reddit api
+     --reddit-user-agent=str      3.1dev             user_agent for reddit api
      --zulip-batch-size=int       -100               number of messages to
                                                      fetch per call (<0 to
                                                      fetch before anchor)
@@ -761,8 +755,12 @@ COMMANDLINE OPTIONS
                                                      csv.reader
      --csv-delimiter=str          ,                  delimiter passed to
                                                      csv.reader
+     --csv-doublequote=bool       True               quote-doubling setting
+                                                     passed to csv.reader
      --csv-quotechar=str          "                  quotechar passed to
                                                      csv.reader
+     --csv-quoting=int            0                  quoting style passed to
+                                                     csv.reader and csv.writer
      --csv-skipinitialspace=bool  True               skipinitialspace passed
                                                      to csv.reader
      --csv-escapechar=NoneType    None               escapechar passed to
@@ -798,6 +796,9 @@ COMMANDLINE OPTIONS
      --graphviz-edge-labels=bool  True               whether to include edge
                                                      labels on graphviz dia‐
                                                      grams
+     --grep-base-dir=NoneType     None               base directory for rela‐
+                                                     tive paths opened with
+                                                     sysopen-row
      --html-title=str             <h2>{sheet.name}</h2>
                                                      table header when saving
                                                      to html
@@ -832,6 +833,8 @@ COMMANDLINE OPTIONS
      --xlsx-meta-columns          False              include columns for cell
                                                      objects, font colors, and
                                                      fill colors
+     --xlsx-color-cells=bool      True               color cells based on xlsx
+                                                     source
      --xml-parser-huge-tree=bool  True               allow very deep trees and
                                                      very long text content
      --plt-marker=str             .                  matplotlib.markers
@@ -894,7 +897,7 @@ COMMANDLINE OPTIONS
                                              onto sheet stack
      disp_menu_input     …                   indicator if input required for
                                              command
-     disp_menu_fmt       | VisiData {vd.version} | Alt+H for help menu
+     disp_menu_fmt       | VisiData {vd.version} | {vd.hintStatus}
                                              right-side menu format string
      disp_float_fmt      {:.02f}             default fmtstr to format float
                                              values
@@ -922,7 +925,14 @@ COMMANDLINE OPTIONS
                                              marked ambiguous
      disp_pending                            string to display in pending
                                              cells
-     color_note_pending  bold magenta        color of note in pending cells
+     disp_note_pending   :                   note to display for pending cells
+     disp_note_fmtexc    ?                   cell note for an exception during
+                                             formatting
+     disp_note_getexc    !                   cell note for an exception during
+                                             computation
+     disp_note_typeexc   !                   cell note for an exception during
+                                             type conversion
+     color_note_pending  bold green          color of note in pending cells
      color_note_type     226 yellow          color of cell note for non-str
                                              types in anytype columns
      color_note_row      220 yellow          color of row note on left edge
@@ -943,41 +953,54 @@ COMMANDLINE OPTIONS
      disp_sort_asc       ↑↟⇞⇡⇧⇑              characters for ascending sort
      disp_sort_desc      ↓↡⇟⇣⇩⇓              characters for descending sort
      color_default       white on black      the default fg and bg colors
-     color_default_hdr   bold                color of the column headers
-     color_bottom_hdr    underline           color of the bottom header row
+     color_default_hdr   bold white on black
+                                             color of the column headers
+     color_bottom_hdr    underline white on black
+                                             color of the bottom header row
      color_current_row   reverse             color of the cursor row
-     color_current_col   bold                color of the cursor column
+     color_current_col   bold on 232         color of the cursor column
      color_current_cell                      color of current cell, if differ‐
                                              ent from color_cur‐
                                              rent_row+color_current_col
      color_current_hdr   bold reverse        color of the header for the cur‐
                                              sor column
-     color_column_sep    246 blue            color of column separators
+     color_column_sep    white on black      color of column separators
      color_key_col       81 cyan             color of key columns
      color_hidden_col    8                   color of hidden columns on
                                              metasheets
      color_selected_row  215 yellow          color of selected rows
-     color_clickable     underline           color of internally clickable
+     color_clickable     bold                color of internally clickable
                                              item
      color_code          bold white on 237   color of code sample
-     color_heading       bold 200            color of header
+     color_heading       bold black on yellow
+                                             color of header
      color_guide_unwritten 243 on black      color of unwritten guides in
                                              GuideGuide
+     disp_wrap_max_lines 3                   max lines for multiline view
+     disp_wrap_break_long_words False        break words longer than column
+                                             width in multiline
+     disp_wrap_replace_whitespace False      replace whitespace with spaces in
+                                             multiline
+     disp_wrap_placeholder …                 multiline string to indicate
+                                             truncation
+     disp_multiline_focus True               only multiline cursor row
+     color_aggregator    bold 255 white on 234 black
+                                             color of aggregator summary on
+                                             bottom row
      disp_rstatus_fmt    {sheet.threadStatus} {sheet.keystrokeStatus}
-                                             [:longname]{sheet.longname}[/]
+                                             [:longname_status]{sheet.longname}[/]
                                              {sheet.nRows:9d} {sheet.rowtype}
-                                             {sheet.modifiedStatus}{sheet.selectedStatus}{vd.replayStatus}
+                                             {sheet.modifiedStatus}{sheet.selectedStatus}{vd.replayStatus}{vd.sidebarStatus}
                                              right-side status format string
-     disp_status_fmt     [:onclick sheets-stack]{sheet.shortcut}›
-                                             {sheet.name}[/]|
-                                             status line prefix
+     disp_status_fmt     {sheet.sheetlist}|
+                                             left-side status format string
      disp_lstatus_max    0                   maximum length of left status
                                              line
      disp_status_sep     │                   separator between statuses
      color_keystrokes    bold white on 237   color of input keystrokes
-     color_longname      bold 52 on 114 green
-                                             color of command longnames
-     color_keys          bold                color of keystrokes in help
+     color_longname_guide 237                color of command longnames
+     color_longname_status white             color of command longnames
+     color_keys          bold reverse        color of keystrokes in help
      color_status        bold on 238         status line color
      color_error         202 1               error message color
      color_warning       166 15              warning message color
@@ -1002,6 +1025,7 @@ COMMANDLINE OPTIONS
                                              rency displayer
      disp_replay_play    ▶                   status indicator for active re‐
                                              play
+     disp_replay_record  ⏺                   status indicator for macro record
      color_status_replay green               color of replay status indicator
      disp_histogram      ■                   histogram element character
      disp_graph_labels   True                show axes and legend on graph
@@ -1018,13 +1042,22 @@ COMMANDLINE OPTIONS
      color_graph_selected bold               color of selected graph points
      color_graph_axis    bold                color for graph axis labels
      disp_graph_tick_x   ╵                   character for graph x-axis ticks
-     disp_help           2                   show help panel during input
+     color_graph_refline                     color for graph reference value
+                                             lines
+     disp_graph_reflines_x_charset ▏││▕      charset to render vertical refer‐
+                                             ence lines on graph
+     disp_graph_reflines_y_charset ▔──▁      charset to render horizontal ref‐
+                                             erence lines on graph
+     disp_graph_multiple_reflines_char ▒     char to render multiple parallel
+                                             reflines
+     disp_expert         0                   max level of options and columns
+                                             to include
      color_add_pending   green               color for rows pending add
      color_change_pending reverse yellow     color for cells pending modifica‐
                                              tion
      color_delete_pending red                color for rows pending delete
      disp_sidebar        True                whether to display sidebar
-     disp_sidebar_fmt    {guide}             format string for default sidebar
+     disp_sidebar_fmt                        format string for default sidebar
      disp_sidebar_width  0                   max width for sidebar
      disp_sidebar_height 0                   max height for sidebar
      color_sidebar       black on 114 blue   base color of sidebar
@@ -1046,8 +1079,6 @@ COMMANDLINE OPTIONS
      color_cmdpalette    black on 72         base color of command palette
      disp_cmdpal_max     10                  max number of suggestions for
                                              command palette
-     color_shellcmd      21 on 114 green
-     color_colname       underline
      disp_scroll_context 0                   minimum number of lines to keep
                                              visible above/below cursor when
                                              scrolling
@@ -1158,4 +1189,4 @@ SUPPORTED SOURCES
 AUTHOR
      VisiData was made by Saul Pwanson <vd@saul.pw>.
 
-Linux/MacOS                    January 15, 2024                    Linux/MacOS
+Linux/MacOS                    October 13, 2024                    Linux/MacOS

visidata/memory.py

@@ -5,9 +5,9 @@ vd.contexts += [vd.memory]
 
 
 @VisiData.api
-def memo(vd, name, col, row):
-    vd.memory[name] = col.getTypedValue(row)
-    vd.status('memo %s=%s' % (name, col.getDisplayValue(row)))
+def memoValue(vd, name, value, dispvalue):
+    vd.memory[name] = value
+    vd.status(f'memo {name}={dispvalue}')
 
 
 class MemorySheet(Sheet):
@@ -31,5 +31,16 @@ def memosSheet(vd):
     return MemorySheet('memos')
 
 
+@VisiData.api
+def inputMemoName(vd, value):
+    value_params = dict(prompt="assign value: ", value=value)
+    name_params = dict(prompt="to memo name: ")
+    r = vd.inputMultiple(memo_name=name_params, memo_value=value_params)
+    name = r['memo_name']
+    if not name:
+        vd.fail('memo name cannot be blank')
+    return name
+
+
 Sheet.addCommand('Alt+Shift+M', 'open-memos', 'vd.push(vd.memosSheet)', 'open the Memory Sheet')
-Sheet.addCommand('Alt+m', 'memo-cell', r'vd.memory[input("assign \""+cursorCol.getDisplayValue(cursorRow)+"\" to: ")] = cursorCol.getTypedValue(cursorRow)', 'store value in current cell in Memory Sheet')
+Sheet.addCommand('Alt+m', 'memo-cell', 'vd.memoValue(inputMemoName(cursorDisplay), cursorTypedValue, cursorDisplay)', 'store value in current cell to Memory Sheet')

visidata/menu.py

@@ -1,5 +1,6 @@
 import string
 import textwrap
+import time
 import curses
 
 from typing import List, Union
@@ -17,11 +18,21 @@ vd.theme_option('disp_menu_boxchars', '││──┌┐└┘├┤', 'box cha
 vd.theme_option('disp_menu_more', '»', 'command submenu indicator')
 vd.theme_option('disp_menu_push', '⎘', 'indicator if command pushes sheet onto sheet stack')
 vd.theme_option('disp_menu_input', '…', 'indicator if input required for command')
-vd.option('disp_menu_fmt', '| VisiData {vd.version} | Alt+H for help menu', 'right-side menu format string', max_help=0)
+vd.option('disp_menu_fmt', '| VisiData {vd.version} | {vd.hintStatus}', 'right-side menu format string')
 
 BaseSheet.init('activeMenuItems', list)
 vd.menuRunning = False
 
+@VisiData.property
+def hintStatus(vd):
+    if vd.options.disp_expert <= 0:
+        if int(time.time()/60) % 2 == 0:
+            return 'Alt+H for help menu'
+        else:
+            return 'Ctrl+G to cycle help sidebar'
+
+    return vd.sheet.getHint()
+
 def menudraw(*args):
     return clipdraw(*args, truncator='')
 
@@ -439,7 +450,7 @@ def runMenu(vd):
         else:
             nEscapes = 0
 
-        if k in ['^C', '^Q', 'q']:
+        if k in ['^C', '^Q', 'q', '^H', 'KEY_BACKSPACE']:
             return
 
         elif k in ['KEY_MOUSE']:
@@ -499,7 +510,7 @@ BaseSheet.addCommand('Alt+r', 'menu-row', 'pressMenu("Row")', '')
 BaseSheet.addCommand('Alt+d', 'menu-data', 'pressMenu("Data")', '')
 BaseSheet.addCommand('Alt+p', 'menu-plot', 'pressMenu("Plot")', '')
 BaseSheet.addCommand('Alt+s', 'menu-system', 'pressMenu("System")', '')
-BaseSheet.addCommand('Alt+h', 'menu-help', 'pressMenu("Help")', '')
+BaseSheet.addCommand('Alt+h', 'menu-help', 'pressMenu("Help")', 'open the Help menu')
 BaseSheet.bindkey('Ctrl+H', 'menu-help')
 BaseSheet.bindkey('KEY_BACKSPACE', 'menu-help')