shortcutxl 0.2.19 → 0.2.21

package/xll/modules/shortcut_xl/api/worksheet.py

@@ -48,8 +48,8 @@ class Worksheet:
         ur = self._ws.UsedRange
         if ur is None:
             return ''
-        r = ur.Row       # 1-based
-        c = ur.Column     # 1-based
+        r = ur.Row  # 1-based
+        c = ur.Column  # 1-based
         rows = ur.Rows.Count
         cols = ur.Columns.Count
         if rows == 0 or cols == 0:
@@ -58,7 +58,7 @@ class Worksheet:
         end = index_to_address(r - 1 + rows - 1, c - 1 + cols - 1)
         if start == end:
             return start
-        return f"{start}:{end}"
+        return f'{start}:{end}'
 
     def _used_range_bounds(self) -> tuple[int, int, int, int] | None:
         """Return (start_row, start_col, end_row, end_col) 0-based, or None."""
@@ -86,7 +86,7 @@ class Worksheet:
         - Style as JSON dict if present and include_style is True.
         """
         if ':' in address:
-            raise ValueError(f"getCell expects a single cell address, got range: {address}")
+            raise ValueError(f'getCell expects a single cell address, got range: {address}')
         cell = self._ws.Range(address)
         text = cell.Text
         raw = cell.Value
@@ -103,12 +103,12 @@ class Worksheet:
 
         formula = cell.Formula
         if formula and isinstance(formula, str) and formula.startswith('='):
-            result = f"{text}({formula})"
+            result = f'{text}({formula})'
 
         if include_style:
             style = read_style(cell)
             if style:
-                result = f"{result} ({json.dumps(style)})"
+                result = f'{result} ({json.dumps(style)})'
 
         return result
 
@@ -155,17 +155,13 @@ class Worksheet:
     # Single cell write
     # ------------------------------------------------------------------
 
-    def setCell(self, address: str, value: Any,
-                number_format: str | None = None,
-                note: str | None = None) -> None:
+    def setCell(self, address: str, value: Any, number_format: str | None = None, note: str | None = None) -> None:
         """Write a value (or formula) to a single cell.
 
         Strings starting with '=' are treated as formulas.
         """
         if isinstance(value, str) and len(value) > 32767:
-            raise ValueError(
-                f"Cell value exceeds Excel's 32,767 character limit ({len(value)} chars)"
-            )
+            raise ValueError(f"Cell value exceeds Excel's 32,767 character limit ({len(value)} chars)")
         cell = self._ws.Range(address)
         if value is None or value == '':
             cell.Value = None
@@ -203,8 +199,7 @@ class Worksheet:
             pass
         cell.AddComment(text)
 
-    def setCellRange(self, range_addr: str, values: list[list],
-                     number_format: str | None = None) -> None:
+    def setCellRange(self, range_addr: str, values: list[list], number_format: str | None = None) -> None:
         """Bulk write values to a range. Formulas detected by leading '='.
 
         ``values`` is a 2D list matching range dimensions.
@@ -215,22 +210,15 @@ class Worksheet:
         cols = ec - sc + 1
 
         if len(values) != rows:
-            raise ValueError(
-                f"Row count mismatch: range has {rows} rows, got {len(values)}"
-            )
+            raise ValueError(f'Row count mismatch: range has {rows} rows, got {len(values)}')
         for i, row in enumerate(values):
             if len(row) != cols:
-                raise ValueError(
-                    f"Col count mismatch in row {i}: range has {cols} cols, got {len(row)}"
-                )
+                raise ValueError(f'Col count mismatch in row {i}: range has {cols} cols, got {len(row)}')
 
         rng = make_range(self._ws, sr, sc, er, ec)
         data = tuple(tuple(row) for row in values)
 
-        has_formula = any(
-            isinstance(v, str) and v.startswith('=')
-            for row in values for v in row
-        )
+        has_formula = any(isinstance(v, str) and v.startswith('=') for row in values for v in row)
 
         # COM Range.Formula handles the mix — formulas start with '=',
         # everything else is treated as a value. Bulk assign either way.
@@ -246,21 +234,20 @@ class Worksheet:
     # Search
     # ------------------------------------------------------------------
 
-    def regexSearch(self, patterns: list[str],
-                    match_case: bool = False) -> list[dict]:
+    def regexSearch(self, patterns: list[str], match_case: bool = False) -> list[dict]:
         """Search used range with regex patterns.
 
         Returns list of ``{"address": "A1", "value": <raw>}`` dicts,
         matching SpreadJS SearchDelegate.regexSearch output.
         """
         if not isinstance(patterns, list) or len(patterns) == 0:
-            raise ValueError("patterns must be a non-empty list")
+            raise ValueError('patterns must be a non-empty list')
 
         flags = 0 if match_case else re.IGNORECASE
         compiled = []
         for p in patterns:
             if not isinstance(p, str):
-                raise ValueError(f"Invalid pattern type: expected str, got {type(p).__name__}")
+                raise ValueError(f'Invalid pattern type: expected str, got {type(p).__name__}')
             try:
                 compiled.append(re.compile(p, flags))
             except re.error as e:
@@ -288,16 +275,16 @@ class Worksheet:
                     continue
                 if any(rx.search(text) for rx in compiled):
                     addr = index_to_address(sr + r, sc + c)
-                    results.append({"address": addr, "value": text})
+                    results.append({'address': addr, 'value': text})
         return results
 
     # ------------------------------------------------------------------
     # IB Text Colors
     # ------------------------------------------------------------------
 
-    def setIBTextColors(self, range_addr: str,
-                        ignored_constants: list[int] | None = None,
-                        colors: dict | None = None) -> None:
+    def setIBTextColors(
+        self, range_addr: str, ignored_constants: list[int] | None = None, colors: dict | None = None
+    ) -> None:
         """Apply Investment Banking (IB) text color conventions.
 
         Colors numeric inputs vs formulas vs cross-sheet references.
@@ -309,9 +296,9 @@ class Worksheet:
         Text strings and booleans are left untouched.
         """
         colors = colors or {}
-        blue = colors.get('inputColor', 16711680)     # 0xFF0000 BGR = blue
-        black = colors.get('formulaColor', 0)          # black
-        green = colors.get('crossSheetColor', 32768)   # 0x008000 BGR = green
+        blue = colors.get('inputColor', 16711680)  # 0xFF0000 BGR = blue
+        black = colors.get('formulaColor', 0)  # black
+        green = colors.get('crossSheetColor', 32768)  # 0x008000 BGR = green
         ignored = set(ignored_constants or [])
 
         sr, sc, er, ec = parse_range(range_addr)
@@ -327,7 +314,7 @@ class Worksheet:
                 val = all_values[r][c]
                 formula = all_formulas[r][c]
 
-                has_formula = (isinstance(formula, str) and formula.startswith('='))
+                has_formula = isinstance(formula, str) and formula.startswith('=')
 
                 if not has_formula and (isinstance(val, bool) or not isinstance(val, NUMERIC_TYPES)):
                     continue
@@ -374,7 +361,7 @@ class Worksheet:
                         props.append('highlightLastCol')
                     parts.append(f'  - {t.Name} [{t.Range.Address}] [{", ".join(props)}]')
         except Exception as e:
-            xl_log(f"getSheetSummary: Tables failed: {e}")
+            xl_log(f'getSheetSummary: Tables failed: {e}')
 
         # Pivot tables — with range addresses
         try:
@@ -390,7 +377,7 @@ class Worksheet:
                     except Exception:
                         parts.append(f'  - {pt.Name}')
         except Exception as e:
-            xl_log(f"getSheetSummary: PivotTables failed: {e}")
+            xl_log(f'getSheetSummary: PivotTables failed: {e}')
 
         # Conditional Formats
         try:
@@ -411,9 +398,9 @@ class Worksheet:
                             pass
                         parts.append(f'  - {cf_type} on {addr} [{", ".join(props)}]')
                     except Exception as e:
-                        xl_log(f"getSheetSummary: ConditionalFormat item failed: {e}")
+                        xl_log(f'getSheetSummary: ConditionalFormat item failed: {e}')
         except Exception as e:
-            xl_log(f"getSheetSummary: ConditionalFormats failed: {e}")
+            xl_log(f'getSheetSummary: ConditionalFormats failed: {e}')
 
         # AutoFilter — with filtering status
         try:
@@ -432,7 +419,7 @@ class Worksheet:
                 status = 'filtering active' if is_filtered else 'no active filters'
                 parts.append(f'\nAutoFilter present [{rng_addr}] [{status}]')
         except Exception as e:
-            xl_log(f"getSheetSummary: AutoFilter failed: {e}")
+            xl_log(f'getSheetSummary: AutoFilter failed: {e}')
 
         # Charts — with chart type
         try:
@@ -445,12 +432,11 @@ class Worksheet:
                     chart_type = co.Chart.ChartType
                     parts.append(f'  - "{title}" [type={chart_type}]')
         except Exception as e:
-            xl_log(f"getSheetSummary: Charts failed: {e}")
+            xl_log(f'getSheetSummary: Charts failed: {e}')
 
         return '\n'.join(parts)
 
-    def addPicture(self, name: str, base64_data: str,
-                   anchor_cell: str):
+    def addPicture(self, name: str, base64_data: str, anchor_cell: str):
         """Add a picture from base64-encoded image data.
 
         Returns the COM Shape object.
@@ -461,8 +447,7 @@ class Worksheet:
     # AutoFill
     # ------------------------------------------------------------------
 
-    def autoFill(self, source_range: str, target_range: str,
-                 fill_mode: str = 'auto') -> None:
+    def autoFill(self, source_range: str, target_range: str, fill_mode: str = 'auto') -> None:
         """AutoFill — equivalent to Excel's drag-fill.
 
         fill_mode: 'auto' (default) or 'constant'.
@@ -473,12 +458,11 @@ class Worksheet:
         t_sr, t_sc, t_er, t_ec = parse_range(target_range)
         if s_sr < t_sr or s_sc < t_sc or s_er > t_er or s_ec > t_ec:
             raise ValueError(
-                f"Source range {source_range} must be contained within target range "
-                f"{target_range}. Example: autoFill(\"A1:A2\", \"A1:A10\")"
+                f'Source range {source_range} must be contained within target range '
+                f'{target_range}. Example: autoFill("A1:A2", "A1:A10")'
             )
 
         src = self._ws.Range(source_range)
         tgt = self._ws.Range(target_range)
         xl_type = _XL_FILL_COPY if fill_mode == 'constant' else _XL_FILL_DEFAULT
         src.AutoFill(tgt, xl_type)
-

package/xll/modules/shortcut_xl/api-reference.py

@@ -20,10 +20,10 @@ class Workbook:
     def getSheetNames(self) -> list[str]:
         """Get the names of all sheets in the workbook."""
 
-    def getSheet(self, name: str) -> "Worksheet":
+    def getSheet(self, name: str) -> 'Worksheet':
         """Get a sheet by name, returned as a wrapped Worksheet."""
 
-    def addSheet(self, name: str, index: int | None = None) -> "Worksheet":
+    def addSheet(self, name: str, index: int | None = None) -> 'Worksheet':
         """Add a new sheet at 0-based index. index=0 inserts before the first sheet.
         Omit index for Excel's default position.
         Example: wb.addSheet("NewSheet", 0)  # insert as first sheet
@@ -51,7 +51,7 @@ class Workbook:
         self,
         from_range: str,
         to_address: str,
-        paste_type: str = "all",  # "all" | "values" | "formatting" | "formulas"
+        paste_type: str = 'all',  # "all" | "values" | "formatting" | "formulas"
     ) -> None:
         """Copy range within same workbook via range.Copy + PasteSpecial.
         Addresses must include sheet name. Do NOT use Sheet.Copy (broken via pywin32).
@@ -65,7 +65,6 @@ class Workbook:
         """
 
 
-
 class Worksheet:
     """
     Worksheet wrapper.
@@ -140,7 +139,7 @@ class Worksheet:
         self,
         source_range: str,
         target_range: str,
-        fill_mode: str = "auto",  # "auto" | "constant"
+        fill_mode: str = 'auto',  # "auto" | "constant"
     ) -> None:
         """Drag-fill. Source must be contained within target.
         Use fill_mode="constant" when copying a single value without incrementing.
@@ -170,6 +169,7 @@ class Worksheet:
 
 # Color helper — COM uses BGR integers, not hex
 
+
 def hex_to_bgr(hex_str: str) -> int:
     """Convert "#RRGGBB" hex string to BGR integer for Excel COM.
     Example: ws.Range("A1").Font.Color = hex_to_bgr("#FF0000")  # red
@@ -178,14 +178,18 @@ def hex_to_bgr(hex_str: str) -> int:
 
 # Address helpers — 0-based indices
 
+
 def index_to_address(row: int, col: int) -> str:
     """Convert 0-based (row, col) to Excel address: index_to_address(0, 0) → "A1"."""
 
+
 def address_to_index(address: str) -> tuple[int, int]:
     """Parse "A1" into (row, col) 0-based tuple: address_to_index("B3") → (2, 1)."""
 
+
 def col_letter(index: int) -> str:
     """Convert 0-based column index to letter: col_letter(26) → "AA"."""
 
+
 def col_index(letter: str) -> int:
     """Convert column letter to 0-based index: col_index("AA") → 26."""

package/xll/python/Lib/site-packages/anyio/_backends/_asyncio.py

@@ -53,7 +53,7 @@ from typing import (
     IO,
     TYPE_CHECKING,
     Any,
-    Optional,
+    ParamSpec,
     TypeVar,
     cast,
 )
@@ -78,7 +78,6 @@ from .._core._exceptions import (
     EndOfStream,
     RunFinishedError,
     WouldBlock,
-    iterate_exceptions,
 )
 from .._core._sockets import convert_ipv6_sockaddr
 from .._core._streams import create_memory_object_stream
@@ -109,11 +108,6 @@ if TYPE_CHECKING:
 else:
     FileDescriptorLike = object
 
-if sys.version_info >= (3, 10):
-    from typing import ParamSpec
-else:
-    from typing_extensions import ParamSpec
-
 if sys.version_info >= (3, 11):
     from asyncio import Runner
     from typing import TypeVarTuple, Unpack
@@ -498,17 +492,39 @@ class CancelScope(BaseCancelScope):
                     self._pending_uncancellations -= 1
 
                 # Update cancelled_caught and check for exceptions we must not swallow
-                cannot_swallow_exc_val = False
-                if exc_val is not None:
-                    for exc in iterate_exceptions(exc_val):
-                        if isinstance(exc, CancelledError) and is_anyio_cancellation(
-                            exc
-                        ):
-                            self._cancelled_caught = True
-                        else:
-                            cannot_swallow_exc_val = True
+                if isinstance(exc_val, BaseExceptionGroup):
+                    cancelleds_caught, remaining = exc_val.split(
+                        lambda exc: (
+                            isinstance(exc, CancelledError)
+                            and is_anyio_cancellation(exc)
+                        )
+                    )
+
+                    if cancelleds_caught is None:
+                        return False
+
+                    self._cancelled_caught = True
 
-                return self._cancelled_caught and not cannot_swallow_exc_val
+                    if remaining is None:
+                        return True
+
+                    context = remaining.__context__
+                    try:
+                        # Preserve __cause__ and __suppress_context__ by avoiding `raise
+                        # ... from ...`
+                        raise remaining
+                    finally:
+                        # Preserve __context__
+                        remaining.__context__ = context
+                        del context
+                else:
+                    if isinstance(exc_val, CancelledError) and is_anyio_cancellation(
+                        exc_val
+                    ):
+                        self._cancelled_caught = True
+                        return True
+                    else:
+                        return False
             else:
                 if self._pending_uncancellations:
                     assert self._parent_scope is not None
@@ -928,7 +944,7 @@ class TaskGroup(abc.TaskGroup):
 # Threads
 #
 
-_Retval_Queue_Type = tuple[Optional[T_Retval], Optional[BaseException]]
+_Retval_Queue_Type = tuple[T_Retval | None, BaseException | None]
 
 
 class WorkerThread(Thread):
@@ -1139,7 +1155,7 @@ def _forcibly_shutdown_process_pool_on_exit(
 
     # Close as much as possible (w/o async/await) to avoid warnings
     for process in workers.copy():
-        if process.returncode is None:
+        if process.returncode is not None:
             continue
 
         process._stdin._stream._transport.close()  # type: ignore[union-attr]
@@ -1192,8 +1208,7 @@ class StreamProtocol(asyncio.Protocol):
 
     def connection_lost(self, exc: Exception | None) -> None:
         if exc:
-            self.exception = BrokenResourceError()
-            self.exception.__cause__ = exc
+            self.exception = exc
 
         self.read_event.set()
         self.write_event.set()
@@ -1277,7 +1292,7 @@ class SocketStream(abc.SocketStream):
                 if self._closed:
                     raise ClosedResourceError from None
                 elif self._protocol.exception:
-                    raise self._protocol.exception from None
+                    raise BrokenResourceError from self._protocol.exception
                 else:
                     raise EndOfStream from None
 
@@ -1300,7 +1315,7 @@ class SocketStream(abc.SocketStream):
             if self._closed:
                 raise ClosedResourceError
             elif self._protocol.exception is not None:
-                raise self._protocol.exception
+                raise BrokenResourceError from self._protocol.exception
 
             try:
                 self._transport.write(item)
@@ -2243,6 +2258,7 @@ class TestRunner(abc.TestRunner):
     async def _call_in_runner_task(
         self,
         func: Callable[P, Awaitable[T_Retval]],
+        /,
         *args: P.args,
         **kwargs: P.kwargs,
     ) -> T_Retval:

package/xll/python/Lib/site-packages/anyio/_backends/_trio.py

@@ -30,6 +30,7 @@ from typing import (
     Any,
     Generic,
     NoReturn,
+    ParamSpec,
     TypeVar,
     cast,
     overload,
@@ -84,11 +85,6 @@ from ..streams.memory import MemoryObjectSendStream
 if TYPE_CHECKING:
     from _typeshed import FileDescriptorLike
 
-if sys.version_info >= (3, 10):
-    from typing import ParamSpec
-else:
-    from typing_extensions import ParamSpec
-
 if sys.version_info >= (3, 11):
     from typing import TypeVarTuple, Unpack
 else:
@@ -887,6 +883,7 @@ class TestRunner(abc.TestRunner):
     def _call_in_runner_task(
         self,
         func: Callable[P, Awaitable[T_Retval]],
+        /,
         *args: P.args,
         **kwargs: P.kwargs,
     ) -> T_Retval:

package/xll/python/Lib/site-packages/anyio/_core/_fileio.py

@@ -301,6 +301,11 @@ class Path:
     def __fspath__(self) -> str:
         return self._path.__fspath__()
 
+    if sys.version_info >= (3, 15):
+
+        def __vfspath__(self) -> str:
+            return self._path.__vfspath__()
+
     def __str__(self) -> str:
         return self._path.__str__()
 
@@ -561,8 +566,10 @@ class Path:
             os.path.ismount, self._path, abandon_on_cancel=True
         )
 
-    def is_reserved(self) -> bool:
-        return self._path.is_reserved()
+    if sys.version_info < (3, 15):
+
+        def is_reserved(self) -> bool:
+            return self._path.is_reserved()
 
     async def is_socket(self) -> bool:
         return await to_thread.run_sync(self._path.is_socket, abandon_on_cancel=True)
@@ -784,14 +791,9 @@ class Path:
         errors: str | None = None,
         newline: str | None = None,
     ) -> int:
-        # Path.write_text() does not support the "newline" parameter before Python 3.10
-        def sync_write_text() -> int:
-            with self._path.open(
-                "w", encoding=encoding, errors=errors, newline=newline
-            ) as fp:
-                return fp.write(data)
-
-        return await to_thread.run_sync(sync_write_text)
+        return await to_thread.run_sync(
+            self._path.write_text, data, encoding, errors, newline
+        )
 
 
 PathLike.register(Path)

package/xll/python/Lib/site-packages/anyio/_core/_subprocesses.py

@@ -1,22 +1,16 @@
 from __future__ import annotations
 
-import sys
 from collections.abc import AsyncIterable, Iterable, Mapping, Sequence
 from io import BytesIO
 from os import PathLike
 from subprocess import PIPE, CalledProcessError, CompletedProcess
-from typing import IO, Any, Union, cast
+from typing import IO, Any, TypeAlias, cast
 
 from ..abc import Process
 from ._eventloop import get_async_backend
 from ._tasks import create_task_group
 
-if sys.version_info >= (3, 10):
-    from typing import TypeAlias
-else:
-    from typing_extensions import TypeAlias
-
-StrOrBytesPath: TypeAlias = Union[str, bytes, "PathLike[str]", "PathLike[bytes]"]
+StrOrBytesPath: TypeAlias = str | bytes | PathLike[str] | PathLike[bytes]
 
 
 async def run_process(

package/xll/python/Lib/site-packages/anyio/_core/_synchronization.py

@@ -335,6 +335,10 @@ class Condition:
         except BaseException:
             if not event.is_set():
                 self._waiters.remove(event)
+            elif self._waiters:
+                # This task was notified by could not act on it, so pass
+                # it on to the next task
+                self._waiters.popleft().set()
 
             raise
         finally:

package/xll/python/Lib/site-packages/anyio/_core/_tempfile.py

@@ -463,7 +463,6 @@ class TemporaryDirectory(Generic[AnyStr]):
     :param prefix: Prefix to be added to the temporary directory name.
     :param dir: The parent directory where the temporary directory is created.
     :param ignore_cleanup_errors: Whether to ignore errors during cleanup
-        (Python 3.10+).
     :param delete: Whether to delete the directory upon closing (Python 3.12+).
     """
 
@@ -489,10 +488,8 @@ class TemporaryDirectory(Generic[AnyStr]):
             "suffix": self.suffix,
             "prefix": self.prefix,
             "dir": self.dir,
+            "ignore_cleanup_errors": self.ignore_cleanup_errors,
         }
-        if sys.version_info >= (3, 10):
-            params["ignore_cleanup_errors"] = self.ignore_cleanup_errors
-
         if sys.version_info >= (3, 12):
             params["delete"] = self.delete