Add type hints to xlsx2csv API and update changelog

- Add backwards-compatible type hints to main Xlsx2csv class methods
- Include type hints for __init__, convert, getSheetIdByName, and context manager methods
- Add type hints to convert_recursive function
- Add typing imports with fallback for Python 2.4+ compatibility
- Update changelog with PR #298 fix

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: dilshod

CHANGELOG

@@ -1,6 +1,7 @@
 version 0.8.4 (2025-Oct-1):
  * Add --continue-on-error option for batch processing to continue when individual files fail
  * Fix ResourceWarning by adding context manager support and proper file handle cleanup
+ * Fix invalid name value - Excel uses #NAME? not #NAME! (#298)
 
 version 0.8.3 (2024-Jul-29):
  * Fix bug when missing workbook relationship

xlsx2csv.py

@@ -42,6 +42,21 @@
     # python2.4
     from optparse import OptionParser
 
+try:
+    from typing import Union, Optional, Dict, Any, IO, List, TextIO, BinaryIO
+    from types import TracebackType
+except ImportError:
+    # python2.4 or older versions without typing
+    Union = None
+    Optional = None
+    Dict = None
+    Any = None
+    IO = None
+    List = None
+    TextIO = None
+    BinaryIO = None
+    TracebackType = None
+
 # see also ruby-roo lib at: http://github.com/hmcgowan/roo
 FORMATS = {
     'general': 'float',
@@ -183,6 +198,7 @@ class Xlsx2csv:
     """
 
     def __init__(self, xlsxfile, **options):
+        # type: (Union[str, IO[bytes]], **Any) -> None
         options.setdefault("delimiter", ",")
         options.setdefault("quoting", csv.QUOTE_MINIMAL)
         options.setdefault("sheetdelimiter", "--------")
@@ -239,28 +255,33 @@ def __init__(self, xlsxfile, **options):
             self.shared_strings.escape_strings()
 
     def __enter__(self):
+        # type: () -> Xlsx2csv
         return self
 
     def __exit__(self, exc_type, exc_val, exc_tb):
+        # type: (Optional[type], Optional[Exception], Optional[TracebackType]) -> None
         self.close()
 
     def __del__(self):
         # Fallback cleanup, but prefer explicit close() or using as context manager
         self.close()
 
     def close(self):
+        # type: () -> None
         """Explicitly close the underlying zip file handle."""
         if self.ziphandle:
             self.ziphandle.close()
             self.ziphandle = None
 
     def getSheetIdByName(self, name):
+        # type: (str) -> Optional[int]
         for s in self.workbook.sheets:
             if s['name'] == name:
                 return s['index']
         return None
 
     def convert(self, outfile, sheetid=1, sheetname=None):
+        # type: (Union[str, TextIO], int, Optional[str]) -> None
         """outfile - path to file or filehandle"""
         if sheetname:
             sheetid = self.getSheetIdByName(sheetname)
@@ -1091,6 +1112,7 @@ def _range(self, rangeStr):
 
 
 def convert_recursive(path, sheetid, outfile, kwargs, continue_on_error=False):
+    # type: (str, int, Union[str, TextIO], Dict[str, Any], bool) -> None
     for name in os.listdir(path):
         fullpath = os.path.join(path, name)
         if os.path.isdir(fullpath):