[dev] prep for v3.1

saulpw · Oct 14, 2024 · a079ab0 · a079ab0
1 parent 329b7bc
commit a079ab0
Show file tree

Hide file tree

Showing 8 changed files with 62 additions and 30 deletions.
diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
-# VisiData v3.0
+# VisiData v3.1
 
 [![Tests](https://github.com/saulpw/visidata/workflows/visidata-ci-build/badge.svg)](https://github.com/saulpw/visidata/actions/workflows/main.yml)
 [![Gitpod ready-to-code](https://img.shields.io/badge/Gitpod-ready--to--code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/saulpw/visidata)

diff --git a/dev/checklists/release.md b/dev/checklists/release.md
@@ -11,10 +11,6 @@
     c. visidata.org; (formats?)
         - remember to check the tables with prettier: https://github.com/saulpw/visidata/pull/2056
 
-3. Verify that VisiData is up-to-date:
-    * help menu
-    * plugins.jsonl
-
 3. Ensure `develop` automated tests run correctly with dev/test.sh
 
 4. Go through the manual tests checklist

diff --git a/docs/man.md b/docs/man.md
@@ -587,7 +587,7 @@ vd(1)
      <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">menu</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">more</span>      »                   command submenu indicator
      <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">menu</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">push</span>      ⎘                   indicator if command pushes sheet onto sheet stack
      <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">menu</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">input</span>     …                   indicator if input required for command
-     <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">menu</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">fmt</span>       | VisiData {vd.version} | Alt+H for help menu
+     <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">menu</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">fmt</span>       | VisiData {vd.version} | {vd.hintStatus}
                                              right-side menu format string
      <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">float</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">fmt</span>      {:.02f}             default fmtstr to format float values
      <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">int</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">fmt</span>        {:d}                default fmtstr to format int values
@@ -630,7 +630,7 @@ vd(1)
      <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">bottom</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">hdr</span>    underline white on black
                                              color of the bottom header row
      <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">current</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">row</span>   reverse             color of the cursor row
-     <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">current</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">col</span>   bold                color of the cursor column
+     <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">current</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">col</span>   bold on 232         color of the cursor column
      <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">current</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">cell</span>                      color of current cell, if different from color_current_row+color_current_col
      <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">current</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">hdr</span>   bold reverse        color of the header for the cursor column
      <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">column</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">sep</span>    white on black      color of column separators
@@ -646,7 +646,9 @@ vd(1)
      <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">wrap</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">break</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">long</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">words</span> False        break words longer than column width in multiline
      <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">wrap</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">replace</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">whitespace</span> False      replace whitespace with spaces in multiline
      <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">wrap</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">placeholder</span> …                 multiline string to indicate truncation
-     <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">multiline</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">focus</span> False              only expand cursor row for multiline view
+     <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">multiline</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">focus</span> True               only multiline cursor row
+     <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">aggregator</span>    bold 255 white on 234 black
+                                             color of aggregator summary on bottom row
      <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">rstatus</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">fmt</span>    {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
      <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">status</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">fmt</span>     {sheet.sheetlist}|
@@ -685,7 +687,11 @@ vd(1)
      <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">graph</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">selected</span> bold               color of selected graph points
      <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">graph</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">axis</span>    bold                color for graph axis labels
      <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">graph</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">tick</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">x</span>   ╵                   character for graph x-axis ticks
-     <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">expert</span>         2                   max level of options and columns to include
+     <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">graph</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">refline</span>                     color for graph reference value lines
+     <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">graph</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">reflines</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">x</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">charset</span> ▏││▕      charset to render vertical reference lines on graph
+     <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">graph</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">reflines</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">y</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">charset</span> ▔──▁      charset to render horizontal reference lines on graph
+     <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">graph</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">multiple</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">reflines</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">char</span> ▒     char to render multiple parallel reflines
+     <span style="font-weight:bold;">disp</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">expert</span>         0                   max level of options and columns to include
      <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">add</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">pending</span>   green               color for rows pending add
      <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">change</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">pending</span> reverse yellow     color for cells pending modification
      <span style="font-weight:bold;">color</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">delete</span><span style="text-decoration:underline;">_</span><span style="font-weight:bold;">pending</span> red                color for rows pending delete
@@ -802,5 +808,5 @@ vd(1)
 <span style="font-weight:bold;">AUTHOR</span>
      <span style="font-weight:bold;">VisiData</span> was made by Saul Pwanson &lt;<span style="text-decoration:underline;">[email protected]</span>&gt;.
 
-Linux/MacOS                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    December 29, 2023                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Linux/MacOS
+Linux/MacOS                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     October 13, 2024                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Linux/MacOS
 </pre></section>
diff --git a/visidata/main.py b/visidata/main.py
@@ -2,7 +2,7 @@
 # Usage: $0 [<options>] [<input> ...]
 #        $0 [<options>] --play <cmdlog> [--batch] [-w <waitsecs>] [-o <output>] [field=value ...]
 
-__version__ = '3.1dev'
+__version__ = '3.1'
 __version_info__ = 'saul.pw/VisiData v' + __version__
 
 from copy import copy

diff --git a/visidata/man/vd.1 b/visidata/man/vd.1
@@ -1,4 +1,4 @@
-.Dd December 29, 2023
+.Dd October 13, 2024
 .Dt vd \&1 "Quick Reference Guide"
 .Os Linux/MacOS
 .
@@ -1193,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
@@ -1273,7 +1273,7 @@ color of the column headers
 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
@@ -1303,8 +1303,10 @@ break words longer than column width in multiline
 replace whitespace with spaces in multiline
 .It Sy "disp_wrap_placeholder" No "\[u2026]"
 multiline string to indicate truncation
-.It Sy "disp_multiline_focus" No "False"
-only expand cursor row for multiline view
+.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 "{sheet.sheetlist}| "
@@ -1375,7 +1377,15 @@ 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_expert        " No "2"
+.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

diff --git a/visidata/man/vd.inc b/visidata/man/vd.inc
@@ -1,4 +1,4 @@
-.Dd December 29, 2023
+.Dd October 13, 2024
 .Dt vd \&1 "Quick Reference Guide"
 .Os Linux/MacOS
 .