Configurable numeric alignment in tabular output

changelog.md

@@ -1,3 +1,11 @@
+TBD
+==============
+
+Features
+--------
+* Right-align numeric columns, and make the behavior configurable.
+
+
 1.47.0 (2026/01/24)
 ==============
 

mycli/main.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from collections import defaultdict, namedtuple
+from decimal import Decimal
 from io import TextIOWrapper
 import logging
 import os
@@ -160,6 +161,7 @@ def __init__(
         self.login_path_as_host = c["main"].as_bool("login_path_as_host")
         self.post_redirect_command = c['main'].get('post_redirect_command')
         self.null_string = c['main'].get('null_string')
+        self.numeric_alignment = c['main'].get('numeric_alignment', 'right')
 
         # set ssl_mode if a valid option is provided in a config file, otherwise None
         ssl_mode = c["main"].get("ssl_mode", None)
@@ -831,6 +833,7 @@ def output_res(results: Generator[SQLResult], start: float) -> None:
                     special.is_expanded_output(),
                     special.is_redirected(),
                     self.null_string,
+                    self.numeric_alignment,
                     max_width,
                 )
 
@@ -868,6 +871,7 @@ def output_res(results: Generator[SQLResult], start: float) -> None:
                             special.is_expanded_output(),
                             special.is_redirected(),
                             self.null_string,
+                            self.numeric_alignment,
                             max_width,
                         )
                         self.echo("")
@@ -1345,6 +1349,7 @@ def run_query(
                 special.is_expanded_output(),
                 special.is_redirected(),
                 self.null_string,
+                self.numeric_alignment,
             )
             for line in output:
                 self.log_output(line)
@@ -1364,6 +1369,7 @@ def run_query(
                         special.is_expanded_output(),
                         special.is_redirected(),
                         self.null_string,
+                        self.numeric_alignment,
                     )
                     for line in output:
                         click.echo(line, nl=new_line)
@@ -1379,6 +1385,7 @@ def format_output(
         expanded: bool = False,
         is_redirected: bool = False,
         null_string: str | None = None,
+        numeric_alignment: str = 'right',
         max_width: int | None = None,
     ) -> itertools.chain[str]:
         if is_redirected:
@@ -1408,13 +1415,15 @@ def format_output(
 
         if headers or (cur and title):
             column_types = None
+            colalign = None
             if isinstance(cur, Cursor):
 
                 def get_col_type(col) -> type:
                     col_type = FIELD_TYPES.get(col[1], str)
                     return col_type if type(col_type) is type else str
 
                 column_types = [get_col_type(tup) for tup in cur.description]
+                colalign = [numeric_alignment if x in (int, float, Decimal) else 'left' for x in column_types]
 
             if max_width is not None and isinstance(cur, Cursor):
                 cur = list(cur)
@@ -1424,6 +1433,7 @@ def get_col_type(col) -> type:
                 headers,
                 format_name="vertical" if expanded else None,
                 column_types=column_types,
+                colalign=colalign,
                 **output_kwargs,
             )
 

mycli/myclirc

@@ -73,6 +73,9 @@ redirect_format = csv
 # empty string, and JSON formats use native nulls.
 null_string = <null>
 
+# How to align numeric data in tabular output: right or left.
+numeric_alignment = right
+
 # A command to run after a successful output redirect, with {} to be replaced
 # with the escaped filename.  Mac example: echo {} | pbcopy.  Escaping is not
 # reliable/safe on Windows.

pyproject.toml

@@ -17,7 +17,7 @@ dependencies = [
     "sqlparse>=0.3.0,<0.6.0",
     "sqlglot[rs] == 27.*",
     "configobj >= 5.0.5",
-    "cli_helpers[styles] >= 2.7.0",
+    "cli_helpers[styles] >= 2.8.0",
     "pyperclip >= 1.8.1",
     "pycryptodomex",
     "pyfzf >= 0.3.1",

test/myclirc

@@ -71,6 +71,9 @@ redirect_format = csv
 # empty string, and JSON formats use native nulls.
 null_string = <nope>
 
+# How to align numeric data in tabular output: right or left.
+numeric_alignment = right
+
 # A command to run after a successful output redirect, with {} to be replaced
 # with the escaped filename.  Mac example: echo {} | pbcopy.  Escaping is not
 # reliable/safe on Windows.

test/test_main.py

@@ -438,7 +438,7 @@ def test_batch_mode_table(executor):
         +----------+
         | count(*) |
         +----------+
-        | 3        |
+        |        3 |
         +----------+
         +-----+
         | a   |