tableio 0.8__tar.gz → 1.0__tar.gz

{tableio-0.8/tableio.egg-info → tableio-1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tableio
-Version: 0.8
+Version: 1.0
 Summary: Uniform way to write table data to and read from different file formats
 Author: Tom Björkholm
 Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
@@ -17,8 +17,8 @@ Requires-Dist: build>=1.5.0
 Requires-Dist: wheel>=0.47.0
 Requires-Dist: mformat-ext>=0.6
 Requires-Dist: openpyxl>=3.1.5
-Requires-Dist: types-openpyxl>=3.1.5.20260402
-Requires-Dist: odfdo>=3.22.7
+Requires-Dist: types-openpyxl>=3.1.5.20260518
+Requires-Dist: odfdo>=3.22.8
 Requires-Dist: xlsxwriter>=3.2.9
 Requires-Dist: pylightxl>=1.61
 Dynamic: author
@@ -137,9 +137,9 @@ a better start by reading the examples.
 
 ## Test summary
 
-- Test result: 1311 passed in 19s
+- Test result: 1347 passed in 22s
 - No flake8 warnings.
 - No mypy errors found.
 - No python layout warnings.
-- Built version(s): 0.8
-- Build and test using Python 3.14.4
+- Built version(s): 1.0
+- Build and test using Python 3.14.5

{tableio-0.8 → tableio-1.0}/README.md

@@ -93,9 +93,9 @@ information about the build system. This README can also be viewed at
 
 ## Test summary
 
-- Test result: 1311 passed in 19s
+- Test result: 1347 passed in 22s
 - No flake8 warnings.
 - No mypy errors found.
 - No python layout warnings.
-- Built version(s): 0.8
-- Build and test using Python 3.14.4
+- Built version(s): 1.0
+- Build and test using Python 3.14.5

{tableio-0.8 → tableio-1.0}/README_pypi.md

@@ -109,9 +109,9 @@ a better start by reading the examples.
 
 ## Test summary
 
-- Test result: 1311 passed in 19s
+- Test result: 1347 passed in 22s
 - No flake8 warnings.
 - No mypy errors found.
 - No python layout warnings.
-- Built version(s): 0.8
-- Build and test using Python 3.14.4
+- Built version(s): 1.0
+- Build and test using Python 3.14.5

{tableio-0.8 → tableio-1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tableio"
-version = "0.8"
+version = "1.0"
 authors = [
   { name="Tom Björkholm", email="klausuler_linnet0q@icloud.com" },
 ]

{tableio-0.8 → tableio-1.0}/setup.py

@@ -5,7 +5,7 @@ from setuptools import setup
 
 setup(
   name='tableio',
-  version='0.8',
+  version='1.0',
   description='Uniform way to write table data to and read from different ' \
     'file formats',
   author='Tom Björkholm',
@@ -21,8 +21,8 @@ setup(
     'wheel >= 0.47.0',
     'mformat-ext >= 0.6',
     'openpyxl >= 3.1.5',
-    'types-openpyxl >= 3.1.5.20260402',
-    'odfdo >= 3.22.7',
+    'types-openpyxl >= 3.1.5.20260518',
+    'odfdo >= 3.22.8',
     'xlsxwriter >= 3.2.9',
     'pylightxl >= 1.61'
   ]

{tableio-0.8 → tableio-1.0}/src/tableio/access_capability.py

@@ -4,16 +4,22 @@
 # Copyright (c) 2026 Tom Björkholm
 # MIT License
 
-import os
+from enum import Enum, auto
 from typing import NoReturn, TextIO
 
 from tableio.capability import CAP_NEEDED, Capabilities
 from tableio.tableio_types import FileAccess
 
 
-# pylint: disable-next=consider-using-with
-NO_ERROR_OUTPUT: TextIO = open(os.devnull, 'w', encoding='utf-8')
-"""Text stream used when helper errors should not be printed."""
+class NoErrorOutput(Enum):
+    """Text stream marker when helper errors should not be printed."""
+
+    NO_OUTPUT = auto()
+    """Text stream marker when helper errors should not be printed."""
+
+
+NO_ERROR_OUTPUT = NoErrorOutput.NO_OUTPUT
+"""Text stream marker used when helper errors should not be printed."""
 
 
 class InsufficientCapabilities(ValueError):
@@ -32,13 +38,17 @@ class InsufficientCapabilities(ValueError):
         super().__init__(message)
 
 
-def _raise_error(error_file: TextIO, error: Exception) -> NoReturn:
+def _raise_error(error_file: TextIO | NoErrorOutput,
+                 error: Exception) -> NoReturn:
     """Write an error message and raise the error."""
+    if isinstance(error_file, NoErrorOutput):
+        raise error
     error_file.write(str(error) + '\n')
     raise error
 
 
-def _check_access_value(file_access: FileAccess, error_file: TextIO) -> None:
+def _check_access_value(file_access: FileAccess,
+                        error_file: TextIO | NoErrorOutput) -> None:
     """Raise if file access is not a supported FileAccess value."""
     if not isinstance(file_access, FileAccess):
         error = TypeError('file_access must be a FileAccess value.')
@@ -50,7 +60,7 @@ def _check_access_value(file_access: FileAccess, error_file: TextIO) -> None:
 
 
 def _check_capabilities_value(capabilities: Capabilities,
-                              error_file: TextIO) -> None:
+                              error_file: TextIO | NoErrorOutput) -> None:
     """Raise if capabilities is not a Capabilities object."""
     if not isinstance(capabilities, Capabilities):
         error = TypeError('capabilities must be a Capabilities object.')
@@ -58,7 +68,8 @@ def _check_capabilities_value(capabilities: Capabilities,
 
 
 def access_capabilities(file_access: FileAccess,
-                        error_file: TextIO = NO_ERROR_OUTPUT) -> Capabilities:
+                        error_file: TextIO | NoErrorOutput =
+                        NO_ERROR_OUTPUT) -> Capabilities:
     """Return the capabilities implied by a file access mode.
 
     Args:
@@ -80,7 +91,8 @@ def access_capabilities(file_access: FileAccess,
 
 def add_access_capabilities(file_access: FileAccess,
                             capabilities: Capabilities,
-                            error_file: TextIO = NO_ERROR_OUTPUT) \
+                            error_file: TextIO | NoErrorOutput =
+                            NO_ERROR_OUTPUT) \
         -> Capabilities:
     """Return capabilities with file access requirements added.
 
@@ -135,7 +147,8 @@ def _access_error_message(file_access: FileAccess) -> str:
 
 def check_access_capabilities(file_access: FileAccess,
                               capabilities: Capabilities,
-                              error_file: TextIO = NO_ERROR_OUTPUT) -> None:
+                              error_file: TextIO | NoErrorOutput =
+                              NO_ERROR_OUTPUT) -> None:
     """Raise if capabilities are not enough for requested access mode.
 
     Args:

{tableio-0.8 → tableio-1.0}/src/tableio/config_data_apply.py

@@ -4,7 +4,7 @@
 # Copyright (c) 2026 Tom Björkholm
 # MIT License
 
-from typing import Callable, Optional, TypeVar, cast
+from typing import Callable, NoReturn, Optional, TypeVar, cast
 
 from mformat.mformat import PathLike
 from tableio.access_capability import add_access_capabilities
@@ -24,15 +24,14 @@ _FORMAT_PRIORITY = ('excel', 'ods', 'csv')
 _ValueT = TypeVar('_ValueT')
 
 
-def _config_error(name: str, message: str) -> None:
+def _config_error(name: str, message: str) -> NoReturn:
     """Raise one structured configuration error."""
     raise ConfigError((ConfigIssue(name, message),))
 
 
 def _check_default_input(capabilities: Capabilities, file_access: FileAccess,
                          format_name: Optional[str],
-                         implementation: Optional[str],
-                         include_all_options: bool) -> None:
+                         implementation: Optional[str]) -> None:
     """Validate runtime values used for default selection."""
     if not isinstance(capabilities, Capabilities):
         _config_error('capabilities', 'must be a Capabilities object.')
@@ -42,8 +41,15 @@ def _check_default_input(capabilities: Capabilities, file_access: FileAccess,
         _config_error('format_name', 'must be a string or None.')
     if implementation is not None and not isinstance(implementation, str):
         _config_error('implementation', 'must be a string or None.')
+
+
+def _check_default_flags(include_all_options: bool,
+                         impl_in_cfg: Optional[bool]) -> None:
+    """Validate flags used for default selection."""
     if not isinstance(include_all_options, bool):
         _config_error('include_all_options', 'must be a bool.')
+    if impl_in_cfg is not None and not isinstance(impl_in_cfg, bool):
+        _config_error('impl_in_cfg', 'must be a bool or None.')
 
 
 def _registered_formats_by_lower() -> dict[str, str]:
@@ -103,7 +109,6 @@ def _best_default_names(capabilities: Capabilities, format_name: Optional[str],
         return selected_format, selected_impl
     name = 'implementation' if implementation is not None else 'format_name'
     _config_error(name, 'does not match registered TableIO backends.')
-    raise AssertionError('Unreachable default selection failure.')
 
 
 def _base_arg_items(config: ConfigData) -> list[tuple[str, str, object]]:
@@ -184,7 +189,8 @@ def _filtered_args(config: ConfigData, capabilities: Optional[Capabilities],
     return filtered
 
 
-def _all_option_config(format_name: str, implementation: str) -> ConfigData:
+def _all_option_config(format_name: str,
+                       implementation: Optional[str]) -> ConfigData:
     """Return a configuration object with all options visible."""
     csv = CsvConfigData(dialect=CsvDialect.UNIX, delimiter=',', quoting='all',
                         quotechar='"', lineterminator='\n', escapechar='\\')
@@ -198,10 +204,21 @@ def _all_option_config(format_name: str, implementation: str) -> ConfigData:
                       html=html, latex=latex)
 
 
-def tio_config_default(capabilities: Capabilities, file_access: FileAccess,
+def _include_default_impl(implementation: Optional[str],
+                          include_all_options: bool,
+                          impl_in_cfg: Optional[bool]) -> bool:
+    """Return true if the default config should pin implementation."""
+    if impl_in_cfg is not None:
+        return impl_in_cfg
+    return implementation is not None or include_all_options
+
+
+# pylint: disable-next=too-many-arguments
+def tio_config_default(capabilities: Capabilities, file_access: FileAccess, *,
                        format_name: Optional[str] = None,
                        implementation: Optional[str] = None,
-                       include_all_options: bool = False) -> ConfigData:
+                       include_all_options: bool = False,
+                       impl_in_cfg: Optional[bool] = None) -> ConfigData:
     """Return recommended default configuration data.
 
     Default format and implementation selection first prefers implementations
@@ -211,6 +228,17 @@ def tio_config_default(capabilities: Capabilities, file_access: FileAccess,
     If several implementations of the selected format match equally well,
     their TableIO implementation priority is used.
 
+    Usually it is better to not include the implementation name in the
+    configuration, as that allows the TableIO library to choose the best
+    implementation based on the capabilities and file access at runtime.
+    If you want to include the implementation name in the configuration,
+    you can set the impl_in_cfg parameter to True. If you set it to False,
+    the implementation name will always be omitted from the configuration.
+    If you set it to None, the implementation name will normally be omitted
+    from the configuration, but if include_all_options is True or if
+    implementation was explicitly provided, the implementation name will be
+    included.
+
     Args:
         capabilities: Runtime capabilities the application intends to use.
         file_access: Runtime file access requested by the application.
@@ -218,12 +246,21 @@ def tio_config_default(capabilities: Capabilities, file_access: FileAccess,
         implementation: Optional preferred implementation name.
         include_all_options: Include visible non-None values for all
             configuration options, for teaching and configuration templates.
+        impl_in_cfg: Optional flag to include the implementation name in the
+            configuration. If None, the implementation name will normally be
+            omitted from the configuration, but if include_all_options is True
+            or if implementation was explicitly provided, the implementation
+            name will be included. If True, the implementation name will be
+            included in the configuration. If False, the implementation name
+            will always be omitted from the configuration.
     Returns:
         A configuration object containing durable user choices only.
     """
     _check_default_input(capabilities, file_access, format_name,
-                         implementation, include_all_options)
+                         implementation)
+    _check_default_flags(include_all_options, impl_in_cfg)
     match_caps = add_access_capabilities(file_access, capabilities)
+    selected_impl: Optional[str] = None
     selected_format, selected_impl = _best_default_names(match_caps,
                                                          format_name,
                                                          implementation)
@@ -231,6 +268,9 @@ def tio_config_default(capabilities: Capabilities, file_access: FileAccess,
         selected_format = format_name
     if implementation is not None:
         selected_impl = implementation
+    if not _include_default_impl(implementation, include_all_options,
+                                 impl_in_cfg):
+        selected_impl = None
     if include_all_options:
         config = _all_option_config(selected_format, selected_impl)
     else:
@@ -341,9 +381,9 @@ def tio_config_trim(config: ConfigData,
                                        filtered_names),
                       line_length=_kept(config.line_length, 'line_length',
                                         filtered_names),
-                      table_max_line_length=_kept(
-                          config.table_max_line_length,
-                          'table_max_line_length', filtered_names),
+                      table_max_line_length=_kept(config.table_max_line_length,
+                                                  'table_max_line_length',
+                                                  filtered_names),
                       table_alignment=_kept(config.table_alignment,
                                             'table_alignment', filtered_names),
                       csv=csv, html=html, latex=latex)

{tableio-0.8 → tableio-1.0}/src/tableio/tableio_spreadsheetbased.py

@@ -50,6 +50,16 @@ class _ScanResult(NamedTuple):
     next_read_row: int
 
 
+class _ReadLimits(NamedTuple):
+    """Resolved row and column limits for one section read."""
+
+    left: int
+    top: int
+    bottom: int
+    scan_right: int
+    fixed_right: Optional[int]
+
+
 class _SheetState(NamedTuple):
     """Sequential state tracked for one sheet during an open session."""
 
@@ -295,8 +305,7 @@ class TableIOSpreadsheetBased(TableIO):
                 if read_sheet is not write_sheet:
                     self._write_value_to_sheet(read_sheet, row, column, None)
 
-    def _read_limits(
-            self, box: Optional[Box]) -> tuple[int, int, int, Optional[int]]:
+    def _read_limits(self, box: Optional[Box]) -> _ReadLimits:
         """Return the row and column limits for a read operation."""
         read_sheet = self._read_sheet()
         left = 0 if box is None else box.left
@@ -304,8 +313,10 @@ class TableIOSpreadsheetBased(TableIO):
         bottom = box.bottom if box is not None and \
             box.bottom is not None else self._scan_limit_bottom(read_sheet,
                                                                 top)
-        right = box.right if box is not None else None
-        return left, top, bottom, right
+        fixed_right = box.right if box is not None else None
+        scan_right = self._scan_limit_right(read_sheet, left, fixed_right)
+        return _ReadLimits(left=left, top=top, bottom=bottom,
+                           scan_right=scan_right, fixed_right=fixed_right)
 
     def _scan_limit_bottom(self, sheet: object, top: int) -> int:
         """Return the exclusive bottom limit used when scanning rows."""
@@ -353,20 +364,26 @@ class TableIOSpreadsheetBased(TableIO):
     def _scan_section(self, box: Optional[Box]) -> _ScanResult:
         """Scan the next readable section on the active sheet."""
         sheet = self._read_sheet()
-        left, top, bottom, right = self._read_limits(box)
-        row = top
-        last_read_row = top - 1
-        while row < bottom and self._row_is_empty(sheet, row, left, right):
+        limits = self._read_limits(box)
+        left = limits.left
+        bottom = limits.bottom
+        scan_right = limits.scan_right
+        fixed_right = limits.fixed_right
+        row = limits.top
+        last_read_row = limits.top - 1
+        while row < bottom and self._row_is_empty(sheet, row, left,
+                                                  scan_right):
             last_read_row = row
             row += 1
         headings: list[str] = []
-        while row < bottom and self._row_is_heading(sheet, row, left, right,
-                                                    bottom):
-            heading = self._cell_value(sheet, row, left)
-            headings.append(value_to_str(heading, none_is_empty=True))
+        while row < bottom and self._row_is_heading(sheet, row, left,
+                                                    scan_right, bottom):
+            headings.append(value_to_str(self._cell_value(sheet, row, left),
+                                         none_is_empty=True))
             last_read_row = row
             row += 1
-            while row < bottom and self._row_is_empty(sheet, row, left, right):
+            while row < bottom and self._row_is_empty(sheet, row, left,
+                                                      scan_right):
                 last_read_row = row
                 row += 1
         table_top = row
@@ -374,17 +391,17 @@ class TableIOSpreadsheetBased(TableIO):
         table_right = left
         while row < bottom:
             nonempty_columns = self._row_nonempty_columns(sheet, row, left,
-                                                          right)
+                                                          scan_right)
             if not nonempty_columns:
                 last_read_row = row
                 row += 1
                 break
             last_read_row = row
             table_bottom = row + 1
-            if right is None:
+            if fixed_right is None:
                 table_right = max(table_right, max(nonempty_columns) + 1)
             else:
-                table_right = right
+                table_right = fixed_right
             row += 1
         return _ScanResult(headings=headings, table_top=table_top,
                            table_bottom=table_bottom, table_left=left,

{tableio-0.8 → tableio-1.0/tableio.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tableio
-Version: 0.8
+Version: 1.0
 Summary: Uniform way to write table data to and read from different file formats
 Author: Tom Björkholm
 Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
@@ -17,8 +17,8 @@ Requires-Dist: build>=1.5.0
 Requires-Dist: wheel>=0.47.0
 Requires-Dist: mformat-ext>=0.6
 Requires-Dist: openpyxl>=3.1.5
-Requires-Dist: types-openpyxl>=3.1.5.20260402
-Requires-Dist: odfdo>=3.22.7
+Requires-Dist: types-openpyxl>=3.1.5.20260518
+Requires-Dist: odfdo>=3.22.8
 Requires-Dist: xlsxwriter>=3.2.9
 Requires-Dist: pylightxl>=1.61
 Dynamic: author
@@ -137,9 +137,9 @@ a better start by reading the examples.
 
 ## Test summary
 
-- Test result: 1311 passed in 19s
+- Test result: 1347 passed in 22s
 - No flake8 warnings.
 - No mypy errors found.
 - No python layout warnings.
-- Built version(s): 0.8
-- Build and test using Python 3.14.4
+- Built version(s): 1.0
+- Build and test using Python 3.14.5

{tableio-0.8 → tableio-1.0}/tableio.egg-info/requires.txt

@@ -4,7 +4,7 @@ build>=1.5.0
 wheel>=0.47.0
 mformat-ext>=0.6
 openpyxl>=3.1.5
-types-openpyxl>=3.1.5.20260402
-odfdo>=3.22.7
+types-openpyxl>=3.1.5.20260518
+odfdo>=3.22.8
 xlsxwriter>=3.2.9
 pylightxl>=1.61