visidata 2.11.1__py3-none-any.whl → 3.0__py3-none-any.whl

visidata/guide.py

@@ -0,0 +1,180 @@
+'''
+# A Guide to VisiData Guides
+Each guide shows you how to use a particular feature in VisiData. Gray guides have not been written yet. We love contributions: [:onclick https://visidata.org/docs/api/guides]https://visidata.org/docs/api/guides[/].
+
+- [:keystrokes]Up/Down[/] to move the row cursor
+- [:keystrokes]Enter[/] to view a topic
+'''
+import re
+
+from visidata import vd, BaseSheet, Sheet, ItemColumn, Column, VisiData, ENTER, RowColorizer, AttrDict, MissingAttrFormatter
+from visidata import wraptext
+
+guides_list = '''
+GuideIndex ("A Guide to VisiData Guides (you are here)")
+HelpGuide ("Where to Start and How to Quit")  # manpage; ask for patreon
+MenuGuide ("The VisiData Menu System")
+CommandsSheet ("How to find the command you want run")
+
+#  real barebones basics
+MovementGuide ("Movement and Search")
+SortGuide ("Sorting")
+TypesSheet ("The basic type system")
+CommandLog  ("Undo and Replay")
+
+#  rev this thing up
+
+SelectionGuide ("Selecting and filtering") # stu|, and variants; filtering with dup-sheet; g prefix often refers to selected rowset
+SheetsSheet  ("The Sheet Stack")
+ColumnsSheet ("Columns: the only way to fly")
+StatusesSheet ("Revisit old status messages")
+SidebarSheet ("Dive into the sidebar")
+SaversGuide ("Saving Data")  # talk about options.overwrite + ro here
+
+ErrorsSheet ("What was that error?")
+ModifyGuide ("Adding, Editing, Deleting Rows")
+
+# the varieties of data experience
+
+SlideGuide ("Sliding rows and columns around")
+ExprGuide ("Compute Python over every row")
+JoinGuide ("Joining multiple sheets together")
+DescribeSheet ("Basic Statistics (min/max/mode/median/mean)")
+AggregatorsSheet ("Aggregations like sum, mean, and distinct")
+FrequencyTable ("Frequency Tables are how you GROUP BY")
+PivotGuide ("Pivot Tables are just Frequency Tables with more columns")
+MeltGuide ("Melt is just Unpivot")
+JsonGuide ("Some special features for JSON") # with expand/contract, unfurl
+RegexGuide ("Matching and Transforming Strings with Regex")
+GraphSheet ("Basic scatterplots and other graphs")
+WindowFunctionGuide ("Perform operations on groups of rows")
+
+# for the frequent user
+OptionsSheet ("Options and Settings")
+ClipboardGuide ("Copy and Paste Data via the Clipboard")
+DirSheet ("Browsing the local filesystem")
+FormatsSheet ("What can you open with VisiData?")
+SplitpaneGuide ("Split VisiData into two panes")
+ThemesSheet ("Change Interface Theme")
+ColorSheet ("See available colors")
+MacrosSheet ("Recording macros")
+MemorySheet ("Making note of certain values")
+
+# advanced usage and developers
+
+ThreadsSheet ("Threads past and present")
+PyobjSheet ("Inspecting internal Python objects")
+
+#  appendices
+
+InputEditorGuide ("Using the builtin line editor")
+'''
+
+vd.guides = {}  # name -> guidecls
+
+@VisiData.api
+def addGuide(vd, name, guidecls):
+    vd.guides[name] = guidecls
+
+@VisiData.api
+class GuideIndex(Sheet):
+    guide = __doc__
+
+    rowtype = 'guides' # rowdef: list(guide number, guide name, topic description, points, max_points)
+    columns = [
+        ItemColumn('n', 0, type=int),
+        ItemColumn('name', 1, width=0),
+        ItemColumn('topic', 2, width=60),
+    ]
+    colorizers = [
+            RowColorizer(7, 'color_guide_unwritten', lambda s,c,r,v: r and r[1] not in vd.guides)
+            ]
+    def iterload(self):
+        i = 0
+        for line in guides_list.splitlines():
+            m = re.search(r'(\w+?) \("(.*)"\)', line)
+            if m:
+                yield [i] + list(m.groups())
+                i += 1
+
+    def openRow(self, row):
+        name = row[1]
+        return vd.getGuide(name)
+
+class OptionHelpGetter:
+    'For easy and consistent formatting in sidebars and helpstrings, use {vd.options.help.opt_name}.'
+    def __getattr__(self, optname):
+        opt = vd.options._get(optname, 'default')
+        return f'[:onclick options-sheet {optname}]`{optname}`[/]: to {opt.helpstr} (default: {opt.value})'
+
+
+class CommandHelpGetter:
+    'For easy and consistent formatting in sidebars and helpstrings, use {vd.commands.help.long_name}.'
+    def __init__(self, cls):
+        self.cls = cls
+        self.helpsheet = vd.HelpSheet()
+        self.helpsheet.ensureLoaded()
+
+    def __getattr__(self, k):
+        longname = k.replace('_', '-')
+        binding = self.helpsheet.revbinds.get(longname, [None])[0]
+        # cmddict has a SheetClass associated with each command
+        # go through all the parents of the Sheet type, to look for the command
+        for cls in self.cls.superclasses():
+            cmd = self.helpsheet.cmddict.get((cls.__name__, longname), None)
+            if cmd:
+                break
+        if not cmd:
+            return ''
+        if 'input' in cmd.execstr.lower():
+            inputtype = 'input'
+            m = re.search(r'type="(\w*)"', cmd.execstr, re.IGNORECASE)
+            if not m:
+                m = re.search(r'input(\w*)\("', cmd.execstr, re.IGNORECASE)
+            if m:
+                inputtype = m.groups()[0].lower()
+                binding += f'[:45] {inputtype}[/]'
+
+        helpstr = cmd.helpstr
+        return f'`{binding}` (`{longname}`) to {helpstr}'
+
+
+class GuideSheet(Sheet):
+    rowtype = 'lines'
+    filetype = 'guide'
+    columns = [
+            ItemColumn('linenum', 0, type=int, width=0),
+            ItemColumn('guide', 1, width=80, displayer='full'),
+            ]
+    precious = False
+    guide_text = ''
+    sheettype = Sheet
+
+    def iterload(self):
+        winWidth = 78
+        helper = AttrDict(commands=CommandHelpGetter(self.sheettype),
+                          options=OptionHelpGetter())
+        guidetext = MissingAttrFormatter().format(self.guide_text, help=helper, vd=vd)
+        for startingLine, text in enumerate(guidetext.splitlines()):
+            text = text.strip()
+            if text:
+                for i, (L, _) in enumerate(wraptext(str(text), width=winWidth)):
+                    yield [startingLine+i+1, L]
+            else:
+                yield [startingLine+1, text]
+
+
+
+@VisiData.api
+def getGuide(vd, name): # -> GuideSheet()
+    if name in vd.guides:
+        return vd.guides[name]()
+    vd.warning(f'no guide named {name}')
+
+BaseSheet.addCommand('', 'open-guide-index', 'vd.push(GuideIndex("VisiData_Guide"))', 'open VisiData guides table of contents')
+
+vd.addMenuItems('''
+        Help > VisiData Feature Guides > open-guide-index
+''')
+
+vd.addGlobals({'GuideSheet':GuideSheet, "CommandHelpGetter": CommandHelpGetter, "OptionHelpGetter": OptionHelpGetter})

visidata/help.py

@@ -1,10 +1,35 @@
 import functools
 import collections
-from pkg_resources import resource_filename
 
-from visidata import *
+from visidata import VisiData, MetaSheet, ColumnAttr, Column, BaseSheet, VisiDataMetaSheet, SuspendCurses
+from visidata import vd, asyncthread, ENTER, drawcache, AttrDict
 
-vd.show_help = False
+vd.option('disp_help', 2, 'show help panel during input')
+
+@BaseSheet.api
+def hint_basichelp(sheet):
+    return 0, '`Alt+[:underline]H[/]` to open the [:underline]H[/]elp menu'
+
+
+@VisiData.api
+def iterMenuPaths(vd, item=None, menupath=[]):
+    'Generate (longname, menupath).'
+    if item is None:
+        item = vd.menus
+
+    if isinstance(item, (list, tuple)):
+        for m in item:
+            yield from vd.iterMenuPaths(m, menupath)
+    elif item.longname:
+        yield item.longname, ' > '.join(menupath+[item.title])
+    else:
+        yield from vd.iterMenuPaths(item.menus, menupath+[item.title])
+
+
+@VisiData.property
+@drawcache
+def menuPathsByLongname(vd):
+    return dict(vd.iterMenuPaths())
 
 
 @VisiData.api
@@ -16,10 +41,12 @@ class HelpSheet(MetaSheet):
 
     columns = [
         ColumnAttr('sheet'),
+        ColumnAttr('module'),
         ColumnAttr('longname'),
+        Column('menupath', width=0, cache=True, getter=lambda col,row: vd.menuPathsByLongname[row.longname]),
         Column('keystrokes', getter=lambda col,row: col.sheet.revbinds.get(row.longname, [None])[0]),
-        Column('all_bindings', width=0, getter=lambda col,row: list(set(col.sheet.revbinds.get(row.longname, [])))),
-        Column('description', getter=lambda col,row: col.sheet.cmddict[(row.sheet, row.longname)].helpstr),
+        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),
         ColumnAttr('execstr', width=0),
         Column('logged', width=0, getter=lambda col,row: vd.isLoggableCommand(row.longname)),
     ]
@@ -54,73 +81,69 @@ class HelpSheet(MetaSheet):
         return revbinds
 
 
-@VisiData.api
-@asyncthread
-def help_search(vd, sheet, regex):
-    vs = HelpSheet(source=None)
-    vs.rows = []  # do not trigger push reload
-    vd.push(vs)   # push first, then reload
-    vd.sync(vs.reload())
-
-    # find rows matching regex on original HelpSheet
-    rowidxs = list(vd.searchRegex(vs, regex=regex, columns="visibleCols"))
-
-    # add only matching rows
-    allrows = vs.rows
-    vs.rows = []
-    for rowidx in rowidxs:
-        vs.addRow(allrows[rowidx])
-
-
 class HelpPane:
     def __init__(self, name):
+        import visidata
         self.name = name
         self.scr = None
         self.parentscr = None
         self.amgr = visidata.AnimationMgr()
 
-    def draw(self, scr, x=None, y=None):
+    @property
+    def width(self):
+        return self.amgr.maxWidth
+
+    @property
+    def height(self):
+        return self.amgr.maxHeight
+
+    def draw(self, scr, x=None, y=None, **kwargs):
         if not scr: return
-        if not vd.show_help:
-            if self.scr:
-                self.scr.erase()
-                self.scr.refresh()
-                self.scr = None
-            return
+#        if vd.options.disp_help <= 0:
+#            if self.scr:
+#                self.scr.erase()
+#                self.scr.refresh()
+#                self.scr = None
+#            return
         if y is None: y=0  # show at top of screen by default
         if x is None: x=0
+        hneeded = self.amgr.maxHeight+3
+        wneeded = self.amgr.maxWidth+4
+        scrh, scrw = scr.getmaxyx()
         if not self.scr or scr is not self.parentscr:  # (re)allocate help pane scr
             if y >= 0:
-                if y+self.amgr.maxHeight+3 < scr.getmaxyx()[0]:
+                if y+hneeded < scrh:
                     yhelp = y+1
                 else:
-                    yhelp = y-self.amgr.maxHeight-3
+                    hneeded = max(0, min(hneeded, y-1))
+                    yhelp = y-hneeded
             else:  # y<0
-                yhelp = scr.getmaxyx()[0]-self.amgr.maxHeight-4
+                yhelp = max(0, scrh-hneeded-1)
 
             if x >= 0:
-                if x+self.amgr.maxWidth+4 < scr.getmaxyx()[1]:
+                if x+wneeded < scrw:
                     xhelp = x+1
                 else:
-                    xhelp = x-self.amgr.maxWidth-4
+                    wneeded = max(0, min(wneeded, x-1))
+                    xhelp = x-wneeded
             else:  # x<0
-                xhelp = scr.getmaxyx()[1]-self.amgr.maxWidth-5
+                xhelp = max(0, scrh-wneeded-1)
 
-            self.scr = scr.derwin(self.amgr.maxHeight+3, self.amgr.maxWidth+4, yhelp, xhelp)
+            self.scr = vd.subwindow(scr, xhelp, yhelp, wneeded, hneeded)
             self.parentscr = scr
 
         self.scr.erase()
         self.scr.box()
-        self.amgr.draw(self.scr, y=1, x=2)
+        self.amgr.draw(self.scr, y=1, x=2, **kwargs)
         self.scr.refresh()
 
 
 @VisiData.api
 @functools.lru_cache(maxsize=None)
-def getHelpPane(vd, name, module='vdplus'):
+def getHelpPane(vd, name, module='visidata') -> HelpPane:
     ret = HelpPane(name)
     try:
-        ret.amgr.load(name, Path(resource_filename(module,'ddw/'+name+'.ddw')).open_text(encoding='utf-8'))
+        ret.amgr.load(name, (vd.pkg_resources_files(module)/f'ddw/{name}.ddw').open(encoding='utf-8'))
         ret.amgr.trigger(name, loop=True)
     except FileNotFoundError as e:
         vd.debug(str(e))
@@ -135,23 +158,31 @@ def getHelpPane(vd, name, module='vdplus'):
 def openManPage(vd):
     import os
     with SuspendCurses():
-        if os.system(' '.join(['man', resource_filename(__name__, 'man/vd.1')])) != 0:
-            vd.push(TextSheet('man_vd', source=Path(resource_filename(__name__, 'man/vd.txt'))))
+        module_path = vd.pkg_resources_files(__name__.split('.')[0])
+        if os.system(' '.join(['man', str(module_path/'man/vd.1')])) != 0:
+            vd.push(TextSheet('man_vd', source=module_path/'man/vd.txt'))
 
 
 # in VisiData, g^H refers to the man page
 BaseSheet.addCommand('g^H', 'sysopen-help', 'openManPage()', 'Show the UNIX man page for VisiData')
 BaseSheet.addCommand('z^H', 'help-commands', 'vd.push(HelpSheet(name + "_commands", source=sheet, revbinds={}))', 'list commands and keybindings available on current sheet')
 BaseSheet.addCommand('gz^H', 'help-commands-all', 'vd.push(HelpSheet("all_commands", source=None, revbinds={}))', 'list commands and keybindings for all sheet types')
-BaseSheet.addCommand(None, 'help-search', 'help_search(sheet, input("help: "))', 'search through command longnames with search terms')
 
 BaseSheet.bindkey('KEY_F(1)', 'sysopen-help')
 BaseSheet.bindkey('zKEY_F(1)', 'help-commands')
 BaseSheet.bindkey('zKEY_BACKSPACE', 'help-commands')
+BaseSheet.bindkey('gKEY_BACKSPACE', 'sysopen-help')
 
-HelpSheet.addCommand(ENTER, 'exec-command', 'quit(sheet); draw_all(); activeStack[0].execCommand(cursorRow.longname)', 'execute command on undersheet')
+HelpSheet.addCommand(None, 'exec-command', 'quit(sheet); draw_all(); activeStack[0].execCommand(cursorRow.longname)', 'execute command on undersheet')
 BaseSheet.addCommand(None, 'open-tutorial-visidata', 'launchBrowser("https://jsvine.github.io/intro-to-visidata/")', 'open https://jsvine.github.io/intro-to-visidata/')
 
 vd.addMenuItem("Help", "VisiData tutorial", 'open-tutorial-visidata')
 vd.addMenuItem("Help", 'Sheet commands', 'help-commands')
 vd.addMenuItem("Help", 'All commands', 'help-commands-all')
+
+vd.addGlobals(HelpSheet=HelpSheet)
+
+vd.addMenuItems('''
+    Help > Quick reference > sysopen-help
+    Help > Command list > help-commands
+''')

visidata/hint.py

@@ -0,0 +1,39 @@
+import collections
+
+from visidata import vd, BaseSheet
+
+
+@BaseSheet.lazy_property
+def prevHints(sheet):
+    return collections.defaultdict(int)
+
+
+@BaseSheet.api
+def getHint(sheet, *args, **kwargs) -> str:
+    funcs = [getattr(sheet, x) for x in dir(sheet) if x.startswith('hint_')]
+    results = []
+    hints = sheet.prevHints
+    for f in funcs:
+        try:
+            r = f(*args, **kwargs)
+            if r:
+                if isinstance(r, dict):
+                    n = r.get('_relevance', 1)
+                    v = r
+                elif isinstance(r, tuple):
+                    n, v = r
+                else:
+                    n = 1
+                    v = r
+
+                if v not in sheet.prevHints:
+                    results.append((n, v))
+                    sheet.prevHints[v] += 1
+        except Exception as e:
+            vd.debug(f'{f.__name__}: {e}')
+
+    if results:
+        return sorted(results, reverse=True)[0][1]
+
+
+vd.addCommand('', 'help-hint', 'status(getHint() or pressMenu("Help"))', 'get context-dependent hint on what to do next')

visidata/indexsheet.py

@@ -0,0 +1,109 @@
+from visidata import vd, VisiData, BaseSheet, Sheet, Column, AttrColumn, ItemColumn, setitem, asyncthread
+
+
+class IndexSheet(Sheet):
+    'Base class for tabular sheets with rows that are Sheets.'
+    guide = '''
+    # Index Sheet
+    This is a list of sheets from `{sheet.source}`.
+
+    - `Enter` to open {sheet.cursorRow}
+    - `g Enter` to open all selected sheets
+    '''
+    rowtype = 'sheets'  # rowdef: Sheet
+
+    columns = [
+        Column('name', getter=lambda c,r: r.names[-1], setter=lambda c,r,v: setitem(r.names, -1, v)),
+        AttrColumn('rows', 'nRows', type=int, width=9),
+        AttrColumn('cols', 'nCols', type=int),
+        AttrColumn('keys', 'keyColNames'),
+        AttrColumn('source'),
+    ]
+    nKeys = 1
+
+    def newRow(self):
+        return Sheet('', columns=[ItemColumn('', 0)], rows=[])
+
+    def openRow(self, row):
+        return row  # rowdef is Sheet
+
+    def getSheet(self, k):
+        for vs in self.rows:
+            if vs.name == k:
+                return vs
+
+    def addRow(self, sheet, **kwargs):
+        super().addRow(sheet, **kwargs)
+        if not self.options.load_lazy and not sheet.options.load_lazy:
+            sheet.ensureLoaded()
+
+    @asyncthread
+    def reloadSheets(self, sheets):
+        for vs in vd.Progress(sheets):
+            vs.reload()
+
+
+class SheetsSheet(IndexSheet):
+    columns = [
+        AttrColumn('name'),
+        AttrColumn('type', '__class__.__name__'),
+        AttrColumn('pane', type=int),
+        Column('shortcut', getter=lambda c,r: getattr(r, 'shortcut'), setter=lambda c,r,v: setattr(r, '_shortcut', v)),
+        AttrColumn('nRows', type=int),
+        AttrColumn('nCols', type=int),
+        AttrColumn('nVisibleCols', type=int),
+        AttrColumn('cursorDisplay'),
+        AttrColumn('keyColNames'),
+        AttrColumn('source'),
+        AttrColumn('progressPct'),
+#        AttrColumn('threads', 'currentThreads', type=vlen),
+    ]
+    precious = False
+    nKeys = 1
+    def reload(self):
+        self.rows = self.source
+
+    def sort(self):
+        self.rows[1:] = sorted(self.rows[1:], key=self.sortkey)
+
+
+class GlobalSheetsSheet(SheetsSheet):  #1620
+    def sort(self):
+        IndexSheet.sort(self)
+
+
+@VisiData.lazy_property
+def sheetsSheet(vd):
+    return SheetsSheet("sheets", source=vd.sheets)
+
+
+@VisiData.lazy_property
+def allSheetsSheet(vd):
+    return GlobalSheetsSheet("sheets_all", source=vd.allSheets)
+
+
+
+@Sheet.api
+def nextRow(sheet, n=1):
+    sheet.cursorRowIndex += n
+    sheet.checkCursor()
+    return sheet.rows[sheet.cursorRowIndex]  # cursorRow itself might be cached
+
+
+vd.addCommand('S', 'sheets-stack', 'vd.push(vd.sheetsSheet)', 'open Sheets Stack: join or jump between the active sheets on the current stack')
+vd.addCommand('gS', 'sheets-all', 'vd.push(vd.allSheetsSheet)', 'open Sheets Sheet: join or jump between all sheets from current session')
+
+BaseSheet.addCommand('g>', 'open-source-next', 'vd.replace(openSource(source.nextRow())) if isinstance(source, IndexSheet) else fail("parent sheet must be Index Sheet")', 'open next sheet on parent index sheet')
+BaseSheet.addCommand('g<', 'open-source-prev', 'vd.replace(openSource(source.nextRow(-1))) if isinstance(source, IndexSheet) else fail("parent sheet must be Index Sheet")', 'open prev sheet on parent index sheet')
+
+IndexSheet.addCommand('g^R', 'reload-selected', 'reloadSheets(selectedRows or rows)', 'reload all selected sheets')
+
+# 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')
+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,
+              SheetsSheet=SheetsSheet,
+              GlobalSheetsSheet=GlobalSheetsSheet)

visidata/input_history.py

@@ -0,0 +1,55 @@
+from visidata import vd, VisiData, Sheet, ItemColumn, asyncthread
+
+
+vd._inputHistoryList = vd.StoredList(name='input_history')
+vd.inputHistory = {}   # [input_type][input] -> anything
+
+
+@VisiData.api
+def addInputHistory(vd, input:str, type:str=''):
+    r = vd.processInputHistory(input, type)
+    if r:
+        vd._inputHistoryList.append(r)
+
+
+@VisiData.api
+def processInputHistory(vd, input:str, type:str=''):
+    hist = list(vd.inputHistory.setdefault(type, {}).keys())
+    if hist and hist[-1] == input:
+        return
+    if input in vd.inputHistory[type]:
+        n = vd.inputHistory[type][input].get('n', 0)
+        del vd.inputHistory[type][input]  # make it the most recent entry
+    else:
+        n = 0
+
+    r = dict(type=type, input=input, n=n+1)
+    vd.inputHistory[type][input] = r
+    return r
+
+
+class InputHistorySheet(Sheet):
+    # rowdef: dict(type=, input=, n=)
+    # .source=vd.inputHistory
+    columns = [
+        ItemColumn('type'),
+        ItemColumn('input'),
+    ]
+    def iterload(self):
+        yield from vd._inputHistoryList
+
+
+@VisiData.before
+@asyncthread
+def run(vd, *args, **kwargs):
+    vd._inputHistoryList.reload()
+    for x in vd._inputHistoryList:
+        vd.processInputHistory(x.input, x.type)
+
+
+@VisiData.property
+def inputHistorySheet(vd):
+    return InputHistorySheet('input_history', source=vd._inputHistoryList.path)
+
+
+vd.addCommand(None, 'open-input-history', 'vd.push(inputHistorySheet)', 'open sheet with previous inputs')

visidata/interface.py

@@ -0,0 +1,58 @@
+from visidata import VisiData, vd
+
+vd.theme_option('disp_splitwin_pct', 0, 'height of second sheet on screen')
+vd.theme_option('disp_note_none', '⌀',  'visible contents of a cell whose value is None')
+vd.theme_option('disp_truncator', '…', 'indicator that the contents are only partially visible')
+vd.theme_option('disp_oddspace', '\u00b7', 'displayable character for odd whitespace')
+vd.theme_option('disp_more_left', '<', 'header note indicating more columns to the left')
+vd.theme_option('disp_more_right', '>', 'header note indicating more columns to the right')
+vd.theme_option('disp_error_val', '', 'displayed contents for computation exception')
+vd.theme_option('disp_ambig_width', 1, 'width to use for unicode chars marked ambiguous')
+
+vd.theme_option('disp_pending', '', 'string to display in pending cells')
+vd.theme_option('note_pending', '⌛', 'note to display for pending cells')
+vd.theme_option('note_format_exc', '?', 'cell note for an exception during formatting')
+vd.theme_option('note_getter_exc', '!', 'cell note for an exception during computation')
+vd.theme_option('note_type_exc', '!', 'cell note for an exception during type conversion')
+
+vd.theme_option('color_note_pending', 'bold magenta', 'color of note in pending cells')
+vd.theme_option('color_note_type', '226 yellow', 'color of cell note for non-str types in anytype columns')
+vd.theme_option('color_note_row', '220 yellow', 'color of row note on left edge')
+vd.option('scroll_incr', -3, 'amount to scroll with scrollwheel')
+vd.theme_option('disp_column_sep', '│', 'separator between columns')
+vd.theme_option('disp_keycol_sep', '║', 'separator between key columns and rest of columns')
+vd.theme_option('disp_rowtop_sep', '│', '') # ╷│┬╽⌜⌐▇
+vd.theme_option('disp_rowmid_sep', '⁝', '') # ┃┊│█
+vd.theme_option('disp_rowbot_sep', '⁝', '') # ┊┴╿⌞█⍿╵⎢┴⌊  ⋮⁝
+vd.theme_option('disp_rowend_sep', '║', '') # ┊┴╿⌞█⍿╵⎢┴⌊
+vd.theme_option('disp_keytop_sep', '║', '') # ╽╿┃╖╟
+vd.theme_option('disp_keymid_sep', '║', '') # ╽╿┃
+vd.theme_option('disp_keybot_sep', '║', '') # ╽╿┃╜‖
+vd.theme_option('disp_endtop_sep', '║', '') # ╽╿┃╖╢
+vd.theme_option('disp_endmid_sep', '║', '') # ╽╿┃
+vd.theme_option('disp_endbot_sep', '║', '') # ╽╿┃╜‖
+vd.theme_option('disp_selected_note', '•', '') #
+vd.theme_option('disp_sort_asc', '↑↟⇞⇡⇧⇑', 'characters for ascending sort') # ↑▲↟↥↾↿⇞⇡⇧⇈⤉⤒⥔⥘⥜⥠⍏˄ˆ
+vd.theme_option('disp_sort_desc', '↓↡⇟⇣⇩⇓', 'characters for descending sort') # ↓▼↡↧⇂⇃⇟⇣⇩⇊⤈⤓⥕⥙⥝⥡⍖˅ˇ
+vd.theme_option('color_default', 'white on black', 'the default fg and bg colors')
+vd.theme_option('color_default_hdr', 'bold', 'color of the column headers')
+vd.theme_option('color_bottom_hdr', 'underline', 'color of the bottom header row')
+vd.theme_option('color_current_row', 'reverse', 'color of the cursor row')
+vd.theme_option('color_current_col', 'bold', 'color of the cursor column')
+vd.theme_option('color_current_cell', '', 'color of current cell, if different from color_current_row+color_current_col')
+vd.theme_option('color_current_hdr', 'bold reverse', 'color of the header for the cursor column')
+vd.theme_option('color_column_sep', '246 blue', 'color of column separators')
+vd.theme_option('color_key_col', '81 cyan', 'color of key columns')
+vd.theme_option('color_hidden_col', '8', 'color of hidden columns on metasheets')
+vd.theme_option('color_selected_row', '215 yellow', 'color of selected rows')
+vd.theme_option('color_clickable', 'underline', 'color of internally clickable item')
+vd.theme_option('color_code', 'bold white on 237', 'color of code sample')
+vd.theme_option('color_heading', 'bold 200', 'color of header')
+vd.theme_option('color_guide_unwritten', '243 on black', 'color of unwritten guides in GuideGuide')
+
+vd.theme_option('force_256_colors', False, 'use 256 colors even if curses reports fewer')
+
+vd.option('quitguard', False, 'confirm before quitting modified sheet')
+vd.option('default_width', 20, 'default column width', replay=True, max_help=1)   # TODO: make not replay and remove from markdown saver
+vd.option('default_height', 4, 'default column height', max_help=-1)
+vd.option('textwrap_cells', True, 'wordwrap text for multiline rows', max_help=1)