docs: Updated docs and added col width test

table2ascii/table_to_ascii.py

@@ -327,7 +327,7 @@ def table2ascii(
         footer (:class:`Optional[List[Any]]`): List of column values in the table's footer row
         first_col_heading (:class:`bool`): Whether to add a header column separator after the first column
         last_col_heading (:class:`bool`): Whether to add a header column separator before the last column
-        column_widths (:class:`List[int]`): List of widths in characters for each column (defaults to auto-sizing)
+        column_widths (:class:`Optional[List[int]]`): List of widths in characters for each column (``None`` for auto-sizing)
         alignments (:class:`List[Alignment]`): List of alignments (ex. `[Alignment.LEFT, Alignment.CENTER, Alignment.RIGHT]`)
         style (:class:`TableStyle`): Table style to use for styling (preset styles can be imported)
 

tests/test_column_widths.py

@@ -25,6 +25,28 @@ def test_column_widths():
     assert text == expected
 
 
+def test_column_widths_none():
+    text = t2a(
+        header=["#", "G", "H", "R", "S"],
+        body=[["1", "30", "40", "35", "30"], ["2", "30", "40", "35", "30"]],
+        footer=["TOTL", "130", "140", "135", "130"],
+        first_col_heading=True,
+        last_col_heading=True,
+        column_widths=None,
+    )
+    expected = (
+        "╔══════╦═════════════════╦═════╗\n"
+        "║  #   ║  G     H     R  ║  S  ║\n"
+        "╟──────╫─────────────────╫─────╢\n"
+        "║  1   ║ 30    40    35  ║ 30  ║\n"
+        "║  2   ║ 30    40    35  ║ 30  ║\n"
+        "╟──────╫─────────────────╫─────╢\n"
+        "║ TOTL ║ 130   140   135 ║ 130 ║\n"
+        "╚══════╩═════════════════╩═════╝"
+    )
+    assert text == expected
+
+
 def test_wrong_number_column_widths():
     with pytest.raises(ValueError):
         t2a(