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

visidata/tests/test_cliptext.py

@@ -2,6 +2,7 @@ import pytest
 from unittest.mock import Mock, call
 
 import visidata
+from visidata import iterchars
 
 
 class TestClipText:
@@ -19,12 +20,175 @@ class TestClipText:
         (' jsonl', 5, ' jso…', 5),
         ('abcdで', 6, 'abcdで', 6),
         ('abcdで', 5, 'abcd…', 5),
+        ('a', 1, 'a', 1),
+        ('ab', 1, '…', 1),
+        ('abc', 2, 'a…', 2),
+        ('で', 1, '…', 1),
+        ('でで', 1, '…', 1),
+        ('でで', 2, '…', 1),
+        ('でで', 3, 'で…', 3),
+        ('ででで', 4, 'で…', 3),
+        ('ででで', 5, 'でで…', 5),
+        ('', 1, '', 0),
+        ('', None, '', 0),
+        ('abcdef', None, 'abcdef', 6),
+        ('ででで', None, 'ででで', 6),
+        ('で'*100, None, 'で'*100, 2*100),
+        (iterchars([1,2,3]), 4, '[3]…', 4),
+        (iterchars([1,2,3]), 7, '[3] 1;…', 7),
+        (iterchars([1,2,3]), 9, '[3] 1; 2…', 9),
+        (iterchars([1,2,3]), 11, '[3] 1; 2; 3', 11),
+        (iterchars([1,2,3]), 12, '[3] 1; 2; 3', 11),
+        (iterchars({'a':1, 'b':2, 'c':3}), 7, '{3} a=…', 7),
+        (iterchars({'a':1, 'b':2, 'c':3}), 15, '{3} a=1 b=2 c=3', 15),
+        (iterchars({'a':1, 'b':2, 'で':3}), 13, '{3} a=1 b=2 …', 13),
+        (iterchars({'a':1, 'b':2, 'で':3}), 16, '{3} a=1 b=2 で=3', 16),
     ])
     def test_clipstr(self, s, w, clippeds, clippedw):
         clips, clipw = visidata.clipstr(s, w)
         assert clips == clippeds
         assert clipw == clippedw
 
+    @pytest.mark.parametrize('s, w, clippeds, clippedw', [
+        ('b to', 4, 'b to', 4),
+        ('abcde', 8, 'abcde', 5),
+        (' jsonl', 5, ' jsあ', 5),
+        ('abcdで', 6, 'abcdで', 6),
+        ('abcdで', 5, 'abcあ', 5),
+        ('a', 1, 'a', 1),
+        ('ab', 1, 'a', 1),
+        ('abc', 2, 'あ', 2),
+        ('で', 1, '', 0),
+        ('でで', 1, '', 0),
+        ('でで', 2, 'あ', 2),
+        ('でで', 3, 'あ', 2),
+        ('ででで', 4, 'であ', 4),
+        ('ででで', 5, 'であ', 4),
+        ('', 1, '', 0),
+        ('', None, '', 0),
+        ('abcdef', None, 'abcdef', 6),
+        ('ででで', None, 'ででで', 6),
+        ('で'*100, None, 'で'*100, 2*100),
+        (iterchars([1,2,3]), 1, '[', 1),
+        (iterchars({'a':1, 'b':2, 'c':3}), 1, '{', 1),
+    ])
+    def test_clipstr_wide_truncator(self, s, w, clippeds, clippedw):
+        clips, clipw = visidata.clipstr(s, w, truncator='あ')
+        assert clips == clippeds
+        assert clipw == clippedw
+
+    @pytest.mark.parametrize('s, w, clippeds, clippedw', [
+        ('b to', 4, 'b to', 4),
+        ('abcde', 8, 'abcde', 5),
+        (' jsonl', 5, ' json', 5),
+        ('abcdで', 6, 'abcdで', 6),
+        ('abcdで', 5, 'abcd', 4),
+        ('a', 1, 'a', 1),
+        ('ab', 1, 'a', 1),
+        ('abc', 2, 'ab', 2),
+        ('で', 1, '', 0),
+        ('でで', 1, '', 0),
+        ('でで', 2, 'で', 2),
+        ('でで', 3, 'で', 2),
+        ('ででで', 4, 'でで', 4),
+        ('ででで', 5, 'でで', 4),
+        ('', 1, '', 0),
+        ('', None, '', 0),
+        ('abcdef', None, 'abcdef', 6),
+        ('ででで', None, 'ででで', 6),
+        ('で'*100, None, 'で'*100, 2*100),
+    ])
+    def test_clipstr_empty_truncator(self, s, w, clippeds, clippedw):
+        clips, clipw = visidata.clipstr(s, w, truncator='')
+        assert clips == clippeds
+        assert clipw == clippedw
+
+    @pytest.mark.parametrize('s, w, truncator, clippeds, clippedw', [
+        ('first\nsecond\n\nthird\n\n\n', 22, '',  'first·second··third···', 22),
+        ('first\nsecond\n\nthird\n\n\n', 22, '…', 'first·second··third···', 22),
+        ('first\nsecond\n\nthird\n\n\n', 21, '',  'first·second··third··', 21),
+        ('first\nsecond\n\nthird\n\n\n', 21, '…', 'first·second··third·…', 21),
+        (''.join([chr(i) for i in range(256)]), 256, '',
+            '································ !"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~··································¡¢£¤¥¦§¨©ª«¬\xad®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖ×ØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ', 256),
+    ])
+    def test_clipstr_unprintable(self, s, w, truncator, clippeds, clippedw):
+        clips, clipw = visidata.clipstr(s, w, truncator=truncator, oddspace='·')
+        assert clips == clippeds
+        assert clipw == clippedw
+
+    @pytest.mark.parametrize('s, w, clippeds, clippedw', [
+        ('b to', 4, 'b to', 4),
+        ('abcde', 8, 'abcde', 5),
+        (' jsonl', 5, 'jsonl', 5),
+        ('abcdで', 6, 'abcdで', 6),
+        ('abcdで', 5, 'bcdで', 5),
+        ('でbcdで', 6, 'bcdで', 5),
+        ('でbcdefghiで', 10, 'bcdefghiで', 10),
+        ('でbcdefghiで', 3, 'iで', 3),
+        ('でbcdで', 2, 'で', 2),
+        ('でbcdで', 1, '', 0),
+        ('でbcdで', 0, '', 0),
+        ('でbcdで', -1, '', 0),
+    ])
+    def test_clipstr_start(self, s, w, clippeds, clippedw):
+        clips, clipw = visidata.clipstr_start(s, w)
+        assert clips == clippeds
+        assert clipw == clippedw
+
+    @pytest.mark.parametrize('s, w, clippeds, clippedw', [
+        ('aAbcで', 6, 'aAbcで', 6),
+        ('aAbcで', 7, 'aAbcで', 6),
+        ('aAbcで', 1000, 'aAbcで', 6),
+        ('aAbcで', 5, '…bcで', 5),
+        ('でbcで', 5, '…bcで', 5),
+        ('でででででbcで', 5, '…bcで', 5),
+        ('でbcで', 3, '…で', 3),
+        ('でbcで', 2, '…', 1),
+        ('でbcで', 1, '…', 1),
+        ('でbcで', 0, '', 0),
+        ('でbcで', -1, '', 0),
+    ])
+    def test_clipstr_start_truncator(self, s, w, clippeds, clippedw):
+        clips, clipw = visidata.clipstr_start(s, w, truncator='…')
+        assert clips == clippeds
+        assert clipw == clippedw
+
+    @pytest.mark.parametrize('s, w, clippeds, clippedw', [
+        ('1234567890', 6, '12…890', 6),
+        ('1234567890', 7, '123…890', 7),
+        ('1234567890', 8, '123…7890', 8),
+        ('1234567890', 9, '1234…7890', 9),
+        ('1234567890', 10, '1234567890', 10),
+        ('1234567890', 11, '1234567890', 10),
+        ('1234567890', 99, '1234567890', 10),
+        # all full-width characters
+        ('ででででで', 0,  '', 0),
+        ('ででででで', 1,  '…', 1),
+        ('ででででで', 2,  '…', 1),
+        ('ででででで', 3,  '…で', 3),
+        ('ででででで', 4,  '…で', 3),
+        ('ででででで', 5,  'で…で', 5),
+        ('ででででで', 6,  'で…で', 5),
+        ('ででででで', 7,  'で…でで', 7),
+        ('ででででで', 8,  'で…でで', 7),
+        ('ででででで', 9,  'でで…でで', 9),
+        ('ででででで', 10, 'ででででで', 10),
+        ('ででででで', 11, 'ででででで', 10),
+        ('ででででで', 99, 'ででででで', 10),
+        # odd string length, with mix of full-width characters
+        ('ででaaでa', 0,  '', 0),
+        ('ででaaでa', 1,  '…', 1),
+        ('ででaaでa', 2,  '…a', 2),
+        ('ででaaででa', 3,  '…a', 2),
+        ('ででaaででa', 4,  '…でa', 4),
+        ('ででaaででa', 5,  'で…a', 4),
+        ('ででaaででa', 6,  'で…でa', 6),
+    ])
+    def test_clipstr_middle(self, s, w, clippeds, clippedw):
+        clips, clipw = visidata.clipstr_middle(s, w)
+        assert clips == clippeds
+        assert clipw == clippedw
+
     def test_clipdraw_chunks(self):
         prechunks = [
             ('', 'x'),

visidata/tests/test_commands.py

@@ -30,6 +30,7 @@ nonTested = (
         'breakpoint',
         'redraw',
         'menu',
+        'sysedit',
         'sysopen',
         'open-memusage',
         )
@@ -67,6 +68,7 @@ inputLines = { 'save-sheet': 'jetsam.csv',  # save to some tmp file
                  'addcol-incr-step': '2',
                  'setcol-incr-step': '2',
                  'setcol-iter': 'range(1, 100)',
+                 'addcol-iter': 'range(1, 100)',
                  'setcol-format-enum': '1=cat',
                  'open-ping': 'github.com',
                  'setcol-input': '5',
@@ -116,6 +118,7 @@ inputLines = { 'save-sheet': 'jetsam.csv',  # save to some tmp file
                  'sheet': '',
                  'col': 'Units',
                  'row': '5',
+                 'addcol-aggregate': 'max',
               }
 
 @pytest.mark.usefixtures('curses_setup')
@@ -156,7 +159,8 @@ class TestCommands:
         # cleanup
         for f in ['flotsam.csv', 'debris.csv', 'jetsam.csv', 'lagan.csv', 'test_commands.vdj']:
             pf = Path(f)
-            if pf.exists: pf.unlink()
+            if pf.exists:
+                pf.unlink(missing_ok=True)
 
 
     def runOneTest(self, mock_screen, longname):
@@ -172,7 +176,7 @@ class TestCommands:
             vd.getkeystroke = Mock(side_effect=['^J'])
 
         sample_file = vd.pkg_resources_files(visidata) / 'tests/sample.tsv'
-        vs = visidata.TsvSheet('test_commands', source=visidata.Path(sample_file))
+        vs = visidata.TsvSheet('sample', source=visidata.Path(sample_file))
         cmd = vs.getCommand(longname)
         if not cmd:
             vd.warning(f'command cannot be tested on TsvSheet, skipping:  {longname}')

visidata/tests/test_menu.py

@@ -5,7 +5,7 @@ import pytest
 
 class TestMenu:
     def test_menuitems(self):
-        vd.addMenuItems('''Column > Add column > foobar > hello-world''')
+        vd.addMenuItems('''Column > Add column > foobar > addcol-sparkline''')
 
         m = TableSheet().getMenuItem(['Column', 'Add column', 'foobar'])
         assert m

visidata/textsheet.py

@@ -1,4 +1,5 @@
 import textwrap
+import re
 
 from visidata import vd, BaseSheet, options, Sheet, ColumnItem, asyncthread
 from visidata import Column, vlen
@@ -59,9 +60,33 @@ class ErrorSheet(TextSheet):
         ColumnItem('linenum', 0, type=int, width=0),
         ColumnItem('error', 1),
     ]
-    guide = '''# Error Sheet'''
+    guide = '''
+        # Error Sheet
+This is the traceback for an error.
+- move cursor then {help.commands.sysopen_error}
+- `q` to quit this error sheet.
+    '''
     precious = False
 
+    def sysopen_error(self, col, row):
+        '''Open an external editor for the file relevant to the cursor line
+        in the Error Sheet. If the cursor is on the first line, use the file
+        mentioned at the end of the stack trace'''
+        if self.rows and self.cursorRowIndex == 0:
+            searchidx = len(self.rows) - 1
+        else:
+            searchidx = self.cursorRowIndex
+        pat = re.compile(r'^ +File "(.*)", line (\d+), in ')
+        for _, text in self.rows[searchidx::-1]: # rowdef: [linenum, text]
+            match = pat.search(text)
+            if match:
+                vd.launchEditor(match.group(1), f'+{match.group(2)}')
+                return
+
+    def reload(self):
+        src = self.source or (vd.lastErrors[-1] if vd.lastErrors else [])
+        self.rows = list(enumerate(src))
+
 class ErrorCellSheet(ErrorSheet):
     columns = [
         ColumnItem('linenum', 0, type=int, width=0),
@@ -69,6 +94,7 @@ class ErrorCellSheet(ErrorSheet):
     ]
     guide = '''# Error Cell Sheet
 This sheet shows the error that occurred when calculating a cell.
+- move cursor then {help.commands.sysopen_error}
 - `q` to quit this error sheet.
 '''
 
@@ -79,29 +105,29 @@ class ErrorsSheet(Sheet):
         ColumnItem('lastline', -1)
     ]
     def reload(self):
-        self.rows = self.source
+        self.rows = self.source or vd.lastErrors
 
     def openRow(self, row):
         return ErrorSheet(source=self.cursorRow)
 
-@VisiData.property
+@VisiData.lazy_property
 def allErrorsSheet(self):
-    return ErrorsSheet("errors_all", source=vd.lastErrors)
+    return ErrorsSheet("errors_all")
 
-@VisiData.property
+@VisiData.lazy_property
 def recentErrorsSheet(self):
-    error = vd.lastErrors[-1] if vd.lastErrors else ''
-    return ErrorSheet("errors_recent", source=error)
+    return ErrorSheet("errors_recent")
 
 
 
-BaseSheet.addCommand('^E', 'error-recent', 'vd.lastErrors and vd.push(recentErrorsSheet) or status("no error")', 'view traceback for most recent error')
+BaseSheet.addCommand('^E', 'error-recent', 'recentErrorsSheet.reload(); vd.push(recentErrorsSheet) if vd.lastErrors else status("no error")', 'view traceback for most recent error')
 BaseSheet.addCommand('g^E', 'errors-all', 'vd.push(vd.allErrorsSheet)', 'view traceback for most recent errors')
 
 Sheet.addCommand('z^E', 'error-cell', 'vd.push(ErrorCellSheet(sheet.name+"_cell_error", sourceSheet=sheet, source=getattr(cursorCell, "error", None) or fail("no error this cell")))', 'view traceback for error in current cell')
 
 TextSheet.addCommand('^O', 'sysopen-sheet', 'sheet.sysopen(sheet.cursorRowIndex)', 'open copy of text sheet in $EDITOR and reload on exit')
 
+ErrorSheet.addCommand('Enter', 'sysopen-error', 'sysopen_error(cursorCol, cursorRow)', 'open traceback line in $EDITOR')
 
 TextSheet.options.save_filetype = 'txt'
 

visidata/themes/ascii8.py

@@ -82,6 +82,6 @@ vd.themes['ascii8'] = dict(
     disp_menu_fmt='7-bit ASCII 3-bit color',
     plot_colors = 'white',
     disp_histogram='*',
-    disp_graph_lines_x_charset='||||',
-    disp_graph_lines_y_charset='----'
+    disp_graph_reflines_x_charset='||||',
+    disp_graph_reflines_y_charset='----'
 )

visidata/themes/light.py

@@ -4,9 +4,14 @@ from visidata import vd
 
 vd.themes['light'] = dict(
         color_default      = 'black on white',  # the default fg and bg colors
+        color_default_hdr  = 'bold black on white',
+        color_bottom_hdr   = 'underline black on white',
+        color_current_col  = 'bold on white',
+        color_column_sep   = 'black on white',
         color_key_col      = '20 blue',   # color of key columns
         color_edit_cell    = '234 black',     # cell color to use when editing cell
         color_selected_row = '164 magenta',  # color of selected rows
+        color_selected_col = 'bold on white',
         color_note_row     = '164 magenta',  # color of row note on left edge
         color_note_type    = '88 red',  # color of cell note for non-str types in anytype columns
         color_warning      = '202 11 yellow',

visidata/threads.py

@@ -270,6 +270,27 @@ def asyncsingle(func):
     _execAsync.searchThread = None
     return _execAsync
 
+def asyncsingle_queue(func):
+    '''Function decorator like `@asyncthread` but as a singleton.  When called, `func(...)` spawns a new thread, and waits for the end of any previous thread still running *func*.
+    ``vd.sync()`` does wait for unfinished asyncsingle_queue threads, which is an important difference from asyncsingle.
+    '''
+    @functools.wraps(func)
+    def _execAsync(*args, **kwargs):
+        def _func(*args, **kwargs):
+            func(*args, **kwargs)
+            _execAsync.searchThread = None
+            # end of thread
+
+        # cancel previous thread if running
+        if _execAsync.searchThread:
+            vd.sync(_execAsync.searchThread)
+
+        _func.__name__ = func.__name__ # otherwise, the the thread's name is '_func'
+
+        _execAsync.searchThread = vd.execAsync(_func, *args, **kwargs)
+    _execAsync.searchThread = None
+    return _execAsync
+
 @VisiData.property
 def unfinishedThreads(self):
     'A list of unfinished threads (those without a recorded `endTime`).'
@@ -319,13 +340,14 @@ def open_pyprof(vd, p):
 @VisiData.api
 def toggleProfiling(vd):
     t = threading.current_thread()
-    if not t.profile:
-        t.profile = cProfile.Profile()
+    if not vd.options.profile:
+        if not t.profile:
+            t.profile = cProfile.Profile()
         t.profile.enable()
-        if not vd.options.profile:
-            vd.options.set('profile', True)
+        vd.options.set('profile', True)
     else:
-        t.profile.disable()
+        if t.profile:
+            t.profile.disable()
         vd.options.set('profile', False)
     vd.status('profiling ' + ('ON' if vd.options.profile else 'OFF'))
 
@@ -337,7 +359,10 @@ class ThreadProfiler:
 
     def __enter__(self):
         if vd.options.profile:
-            self.thread.profile.enable()
+            try:
+                self.thread.profile.enable()
+            except ValueError: #"ValueError: Another profiling tool is already active"
+                pass
         return self
 
     def __exit__(self, exc_type, exc_val, tb):
@@ -381,6 +406,7 @@ class ProfileSheet(Sheet):
     ]
 
     nKeys=3
+    _ordering = [('inlinetime_us', True)]  # initially sort by inlinetime descending
 
     def reload(self):
         if isinstance(self.source, cProfile.Profile):
@@ -388,7 +414,6 @@ class ProfileSheet(Sheet):
         else:
             self.rows = self.source
 
-        self.orderBy(None, self.column('inlinetime_us'), reverse=True)
         self.callers = collections.defaultdict(list)  # [row.code] -> list(code)
 
         for r in self.rows:
@@ -435,6 +460,10 @@ def codestr(code):
     return code.co_name
 
 
+@VisiData.lazy_property
+def allThreadsSheet(self):
+    return ThreadsSheet("threads", source=vd.threads)
+
 ThreadsSheet.addCommand('^C', 'cancel-thread', 'cancelThread(cursorRow)', 'abort thread at current row')
 ThreadsSheet.addCommand('g^C', 'cancel-all', 'cancelThread(*sheet.rows)', 'abort all threads on this threads sheet')
 ThreadsSheet.addCommand(None, 'add-row', 'fail("cannot add new rows on Threads Sheet")', 'invalid command')
@@ -449,7 +478,7 @@ BaseSheet.addCommand('^C', 'cancel-sheet', 'cancelThread(*sheet.currentThreads o
 BaseSheet.addCommand('g^C', 'cancel-all', 'liveThreads=list(t for vs in vd.sheets for t in vs.currentThreads); cancelThread(*liveThreads); status("canceled %s threads" % len(liveThreads))', 'abort all spawned threads')
 
 
-BaseSheet.addCommand('^T', 'threads-all', 'vd.push(ThreadsSheet("threads", source=vd.threads))', 'open Threads for all sheets')
+BaseSheet.addCommand('^T', 'threads-all', 'vd.push(vd.allThreadsSheet)', 'open Threads for all sheets')
 BaseSheet.addCommand('z^T', 'threads-sheet', 'vd.push(ThreadsSheet("threads", source=sheet.currentThreads))', 'open Threads for this sheet')
 
 vd.addGlobals({
@@ -457,6 +486,7 @@ vd.addGlobals({
     'Progress': Progress,
     'asynccache': asynccache,
     'asyncsingle': asyncsingle,
+    'asyncsingle_queue': asyncsingle_queue,
     'asyncignore': asyncignore,
 })
 

visidata/utils.py

@@ -5,7 +5,7 @@ import re
 
 'Various helper classes and functions.'
 
-__all__ = ['AlwaysDict', 'AttrDict', 'DefaultAttrDict', 'moveListItem', 'namedlist', 'classproperty', 'MissingAttrFormatter', 'getitem', 'setitem', 'getitemdef', 'getitemdeep', 'setitemdeep', 'getattrdeep', 'setattrdeep', 'ExplodingMock', 'ScopedSetattr']
+__all__ = ['AlwaysDict', 'AttrDict', 'DefaultAttrDict', 'moveListItem', 'namedlist', 'classproperty', 'MissingAttrFormatter', 'getitem', 'setitem', 'getitemdef', 'getitemdeep', 'setitemdeep', 'getattrdeep', 'setattrdeep', 'ExplodingMock', 'ScopedSetattr', 'colname_letters']
 
 
 class AlwaysDict(dict):
@@ -215,3 +215,17 @@ def ScopedSetattr(obj, attrname, val):
         yield
     finally:
         setattr(obj, attrname, oldval)
+
+def colname_letters(num):
+    '''*num* is a 1-based integer: 1, 2, 3... gives A B C .. Z AA AB .. ZZ AAA .. to infinity; *num* of 0 returns the empty string'''
+    # credit to https://stackoverflow.com/questions/48983939/convert-a-number-to-excel-s-base-26/48984697#48984697
+    def divmod_excel(n):
+        a, b = divmod(n, 26)
+        if b == 0:
+            return a - 1, b + 26
+        return a, b
+    chars = []
+    while num > 0:
+        num, d = divmod_excel(num)
+        chars.append('-ABCDEFGHIJKLMNOPQRSTUVWXYZ'[d])
+    return ''.join(reversed(chars))

{visidata-3.1.1.data → visidata-3.3.data}/data/share/man/man1/vd.1

@@ -1,4 +1,4 @@
-.Dd October 13, 2024
+.Dd June 13, 2025
 .Dt vd \&1 "Quick Reference Guide"
 .Os Linux/MacOS
 .
@@ -193,6 +193,8 @@ adjust widths of all visible columns to Ar number
 .Pp
 .It Ic " -" Ns " (hyphen)"
 hide current column
+.It Ic "g-" Ns " (hyphen)"
+hide any column that has multiple rows but only one distinct value
 .It Ic "z-" Ns
 reduce width of current column by half
 .It Ic "gv" Ns
@@ -247,10 +249,10 @@ add/reset cache for current/all visible column(s)
 .No add new columns from capture groups of Ar regex No (also requires example row)
 .It Ic "z" Ns Ic "\&;" Ar expr
 .No create new column from bash Ar expr Ns , with Sy $ Ns columnNames as variables
-.It Ic " *" Ar regex Ns Sy / Ns Ar subst
-.No add column derived from current column, replacing Ar regex No with Ar subst No (may include Sy \e1 No backrefs)
-.It Ic "g*  gz*" Ar regex Ns Sy / Ns Ar subst
-.No modify selected rows in current/all visible column(s), replacing Ar regex No with Ar subst No (may include Sy \e1 No backrefs)
+.It Ic " *" Ar search No Sy Tab No Ar replace
+.No add column derived from current column, replacing Ar search No regex with Ar replace No (may include Sy \e1 No backrefs)
+.It Ic "g*  gz*" Ar search No Sy Tab No Ar replace
+.No modify selected rows in current/all visible column(s), replacing Ar search No with Ar replace No (may include Sy \e1 No backrefs)
 .Pp
 .It Ic " (   g("
 .No expand current/all visible column(s) of lists (e.g. Sy [3] Ns ) or dicts (e.g. Sy {3} Ns ) one level
@@ -300,7 +302,7 @@ sort ascending/descending by current column; replace any existing sort criteria
 .It Ic " g[   g]"
 sort ascending/descending by all key columns; replace any existing sort criteria
 .It Ic " z[   z]"
-sort ascending/descending by current column; add to existing sort criteria
+sort ascending/descending by current column; keep higher priority sort criteria
 .It Ic "gz[  gz]"
 sort ascending/descending by all key columns; add to existing sort criteria
 .It Ic " \&""
@@ -316,6 +318,8 @@ open duplicate sheet with deepcopy of selected rows
 The rows in these duplicated sheets (except deepcopy) are references to rows on the original source sheets, and so edits to the filtered rows will naturally be reflected in the original rows.  Use
 .Ic "g'"
 to freeze sheet contents in a deliberate copy.
+.Ic "z'"
+replace current column with a frozen copy, with all cells evaluated
 .
 .Ss Editing Rows and Cells
 .
@@ -352,6 +356,8 @@ fill null cells in current column with contents of non-null cells up the current
 .
 .It Ic "  e" Ar text
 edit contents of current cell
+.It Ic " ^O"
+.No edit contents of current cell in external Sy EDITOR
 .It Ic " ge" Ar text
 .No set contents of current column for selected rows to Ar text
 .
@@ -443,6 +449,8 @@ increase/decrease zoom level, centered on cursor
 zoom to fit full extent
 .It Ic "z_" No (underbar)
 set aspect ratio
+.It Ic "g_" No (underbar)
+Zoom y-axis to fit all visible data points
 .It Ic " x" Ar xmin xmax
 .No set Ar xmin Ns / Ns Ar xmax No on graph
 .It Ic " y" Ar ymin ymax
@@ -782,7 +790,7 @@ abort replay
 .It Ic  ^T
 .No open global Sy Threads Sheet No for all asynchronous threads running
 .It Ic z^T
-.No open current sheet's Sy Threads Sheet No
+.No open current sheet's Sy Threads Sheet
 .El
 .Bl -inset -compact
 .It (sheet-specific commands)
@@ -791,7 +799,7 @@ abort replay
 .It Ic " ^C"
 abort thread at current row
 .It Ic "g^C"
-.No abort all threads on current Sy Threads Sheet No
+.No abort all threads on current Sy Threads Sheet
 .El
 .
 .Ss DERIVED SHEETS
@@ -912,7 +920,7 @@ disable loading .visidatarc and plugin addons
 .
 .El
 .Bl -tag -width XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -compact
-.It Sy --visidata-dir Ns = Ns Ar "str          " No "~/.visidata/"
+.It Sy --visidata-dir Ns = Ns Ar "str          " No "/home/anja/.config/visidata"
 directory to load and store additional files
 .It Sy --debug No "                     False"
 exit on error and display stacktrace
@@ -1021,7 +1029,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 "/home/saul/.visidatarc"
+.It Sy --config Ns = Ns Ar "Path               " No "/home/anja/.visidatarc"
 config file to exec in Python
 .It Sy --play Ns = Ns Ar "str                  " No ""
 file.vdj to replay
@@ -1055,7 +1063,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.1dev"
+.It Sy --reddit-user-agent Ns = Ns Ar "str     " No "3.3"
 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)
@@ -1100,6 +1108,8 @@ max number of fixed-width columns to create (0 is no max)
 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 --hdf5-matrix-enumerate No "     False"
+enumerate matrix rows and columns
 .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"
@@ -1110,6 +1120,8 @@ http headers to send to requests
 verify host and certificates for https
 .It Sy --npy-allow-pickle No "          False"
 numpy allow unpickling objects (unsafe)
+.It Sy --npy-matrix-enumerate No "      False"
+enumerate matrix rows and columns
 .It Sy --pcap-internet Ns = Ns Ar "str         " No "n"
 (y/s/n) if save_dot includes all internet hosts separately (y), combined (s), or does not include the internet (n)
 .It Sy --pdf-tables No "                False"
@@ -1144,8 +1156,6 @@ API Key for api.apilayer.com/fixer
 Cache days for currency conversions
 .It Sy --describe-aggrs Ns = Ns Ar "str        " No "mean stdev"
 numeric aggregators to calculate on Describe sheet
-.It Sy --hello-world Ns = Ns Ar "str           " No "\[u00A1]Hola mundo!"
-shown by the hello-world command
 .It Sy --incr-base Ns = Ns Ar "float           " No "1.0"
 start value for column increments
 .It Sy --ping-count Ns = Ns Ar "int            " No "3"
@@ -1193,7 +1203,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} | {vd.hintStatus}"
+.It Sy "disp_menu_fmt      " No "| VisiData {vd.version} | {vd.motd}"
 right-side menu format string
 .It Sy "disp_float_fmt     " No "{:.02f}"
 default fmtstr to format float values
@@ -1305,6 +1315,8 @@ replace whitespace with spaces in multiline
 multiline string to indicate truncation
 .It Sy "disp_multiline_focus" No "True"
 only multiline cursor row
+.It Sy "color_multiline_bottom" No ""
+color of bottom line of multiline rows
 .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}"
@@ -1365,7 +1377,7 @@ histogram element character
 show axes and legend on graph
 .It Sy "disp_canvas_charset" No "\[u2800]\[u2801]\[u2802]\[u2803]\[u2804]\[u2805]\[u2806]\[u2807]\[u2808]\[u2809]\[u280A]\[u280B]\[u280C]\[u280D]\[u280E]\[u280F]\[u2810]\[u2811]\[u2812]\[u2813]\[u2814]\[u2815]\[u2816]\[u2817]\[u2818]\[u2819]\[u281A]\[u281B]\[u281C]\[u281D]\[u281E]\[u281F]\[u2820]\[u2821]\[u2822]\[u2823]\[u2824]\[u2825]\[u2826]\[u2827]\[u2828]\[u2829]\[u282A]\[u282B]\[u282C]\[u282D]\[u282E]\[u282F]\[u2830]\[u2831]\[u2832]\[u2833]\[u2834]\[u2835]\[u2836]\[u2837]\[u2838]\[u2839]\[u283A]\[u283B]\[u283C]\[u283D]\[u283E]\[u283F]\[u2840]\[u2841]\[u2842]\[u2843]\[u2844]\[u2845]\[u2846]\[u2847]\[u2848]\[u2849]\[u284A]\[u284B]\[u284C]\[u284D]\[u284E]\[u284F]\[u2850]\[u2851]\[u2852]\[u2853]\[u2854]\[u2855]\[u2856]\[u2857]\[u2858]\[u2859]\[u285A]\[u285B]\[u285C]\[u285D]\[u285E]\[u285F]\[u2860]\[u2861]\[u2862]\[u2863]\[u2864]\[u2865]\[u2866]\[u2867]\[u2868]\[u2869]\[u286A]\[u286B]\[u286C]\[u286D]\[u286E]\[u286F]\[u2870]\[u2871]\[u2872]\[u2873]\[u2874]\[u2875]\[u2876]\[u2877]\[u2878]\[u2879]\[u287A]\[u287B]\[u287C]\[u287D]\[u287E]\[u287F]\[u2880]\[u2881]\[u2882]\[u2883]\[u2884]\[u2885]\[u2886]\[u2887]\[u2888]\[u2889]\[u288A]\[u288B]\[u288C]\[u288D]\[u288E]\[u288F]\[u2890]\[u2891]\[u2892]\[u2893]\[u2894]\[u2895]\[u2896]\[u2897]\[u2898]\[u2899]\[u289A]\[u289B]\[u289C]\[u289D]\[u289E]\[u289F]\[u28A0]\[u28A1]\[u28A2]\[u28A3]\[u28A4]\[u28A5]\[u28A6]\[u28A7]\[u28A8]\[u28A9]\[u28AA]\[u28AB]\[u28AC]\[u28AD]\[u28AE]\[u28AF]\[u28B0]\[u28B1]\[u28B2]\[u28B3]\[u28B4]\[u28B5]\[u28B6]\[u28B7]\[u28B8]\[u28B9]\[u28BA]\[u28BB]\[u28BC]\[u28BD]\[u28BE]\[u28BF]\[u28C0]\[u28C1]\[u28C2]\[u28C3]\[u28C4]\[u28C5]\[u28C6]\[u28C7]\[u28C8]\[u28C9]\[u28CA]\[u28CB]\[u28CC]\[u28CD]\[u28CE]\[u28CF]\[u28D0]\[u28D1]\[u28D2]\[u28D3]\[u28D4]\[u28D5]\[u28D6]\[u28D7]\[u28D8]\[u28D9]\[u28DA]\[u28DB]\[u28DC]\[u28DD]\[u28DE]\[u28DF]\[u28E0]\[u28E1]\[u28E2]\[u28E3]\[u28E4]\[u28E5]\[u28E6]\[u28E7]\[u28E8]\[u28E9]\[u28EA]\[u28EB]\[u28EC]\[u28ED]\[u28EE]\[u28EF]\[u28F0]\[u28F1]\[u28F2]\[u28F3]\[u28F4]\[u28F5]\[u28F6]\[u28F7]\[u28F8]\[u28F9]\[u28FA]\[u28FB]\[u28FC]\[u28FD]\[u28FE]\[u28FF]"
 charset to render 2x4 blocks on canvas
-.It Sy "disp_pixel_random  " No "False"
+.It Sy "disp_graph_pixel_random" No "False"
 randomly choose attr from set of pixels instead of most common
 .It Sy "disp_zoom_incr     " No "2.0"
 amount to multiply current zoomlevel when zooming
@@ -1385,8 +1397,17 @@ charset to render vertical reference lines on graph
 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 "disp_help_flags    " No "cmdpalette guides help hints inputfield inputkeys nometacols sidebar"
+list of helper features to enable (space-separated):
+    - "cmdpalette": exec-longname suggestions
+    - "guides": guides in sidebar
+    - "help": help sidebar collapsed by default
+    - "hints": context-sensitive hints on menu line
+    - "inputfield": context-sensitive help for each input field
+    - "inputkeys": input quick reference in sidebar
+    - "nometacols": hide expert columns on metasheets
+    - "sidebar": context-sensitive sheet help in sidebar
+    - "all": enable all helper features
 .It Sy "color_add_pending  " No "green"
 color for rows pending add
 .It Sy "color_change_pending" No "reverse yellow"