Added function for converting column count into the correct column label such that 1..26 => A..Z.

Added update_cells and append_rows methods in excel to simulated the steps necessary to add and update cells and rows at the Worksheet level (no table id necessary)

Author: Luis M. Santos

O365/excel.py

@@ -10,7 +10,7 @@
 from urllib.parse import quote
 
 from .drive import File
-from .utils import ApiComponent, TrackerSet, to_snake_case
+from .utils import ApiComponent, TrackerSet, to_snake_case, col_index_to_label
 
 log = logging.getLogger(__name__)
 
@@ -1948,6 +1948,55 @@ def add_named_range(self, name, reference, comment="", is_formula=False):
             parent=self, **{self._cloud_data_key: response.json()}
         )
 
+    def update_cells(self, address, rows):
+        """
+        Updates the cells at a given range in this worksheet. This is a convenience method since there is no
+        direct endpoint API for tableless row updates.
+        :param str|Range address: the address to resolve to a range which can be used for updating cells.
+        :param list[list[str]] rows: list of rows to push to this range. If updating a single cell, pass a list
+            containing a single row (list) containing a single cell worth of data.
+        """
+        if isinstance(address, str):
+            address = self.get_range(address)
+
+        if not isinstance(address, Range):
+            raise ValueError("address was not an accepted type: str or Range")
+
+        if not isinstance(rows, list):
+            raise ValueError("rows was not an accepted type: list[list[str]]")
+
+        # Let's not even try pushing to API if the range rectangle mismatches the input row and column count.
+        row_count = len(rows)
+        col_count = len(rows[0]) if row_count > 0 else 1
+
+        if address.row_count != row_count or address.column_count != col_count:
+            raise ValueError("rows and columns are not the same size as the range selected. This is required by the Microsoft Graph API.")
+
+        address.values = rows
+        address.update()
+
+    def append_rows(self, rows):
+        """
+        Appends rows to the end of a worksheet. There is no direct Graph API to do this operation without a Table
+        instance. Instead, this method identifies the last row in the worksheet and requests a range after that row
+        and updates that range.
+        :param list[list[str]] rows: list of rows to push to this range. If updating a single cell, pass a list
+            containing a single row (list) containing a single cell worth of data.
+        """
+        row_count = len(rows)
+        col_count = len(rows[0]) if row_count > 0 else 0
+
+        # Find the last row index so we can grab a range after it.
+        current_range = self.get_used_range()
+        target_index = current_range.row_count
+
+        # Generate the address needed to outline the bounding rectangle to use to fill in data.
+        col_name = col_index_to_label(col_count)
+        insert_range_address = 'A{}:{}{}'.format(target_index + 1, col_name, target_index + row_count)
+
+        # Request to push the data to the given range.
+        self.update_cells(insert_range_address, rows)
+
     def get_named_range(self, name):
         """Retrieves a Named range by it's name"""
         url = self.build_url(self._endpoints.get("get_named_range").format(name=name))

O365/utils/__init__.py

@@ -5,6 +5,7 @@
 from .utils import NEXT_LINK_KEYWORD, ME_RESOURCE, USERS_RESOURCE
 from .utils import OneDriveWellKnowFolderNames, Pagination, Query
 from .token import BaseTokenBackend, FileSystemTokenBackend, FirestoreBackend, AWSS3Backend, AWSSecretsBackend, EnvTokenBackend, BitwardenSecretsManagerBackend, DjangoTokenBackend
+from .range import col_index_to_label
 from .windows_tz import get_iana_tz, get_windows_tz
 from .consent import consent_input_token
 from .casing import to_snake_case, to_pascal_case, to_camel_case

O365/utils/range.py

@@ -0,0 +1,21 @@
+
+CAPITALIZED_ASCII_CODE = 64
+CAPITALIZED_WINDOW = 26
+
+def col_index_to_label(col_index):
+    """
+    Given a column index, returns the label corresponding to the column name. For example, index 1 would be
+    A ... until 26 which would be Z.
+    This function will loop until a full label is generated using chunks of 26. Meaning, an index of 52 should
+    yield a label of ZZ corresponding to the ZZ column.
+
+    :param int col_index: list of rows to push to this range. If updating a single cell, pass a list
+        containing a single row (list) containing a single cell worth of data.
+    """
+    label = chr(CAPITALIZED_ASCII_CODE + col_index % CAPITALIZED_WINDOW)
+    col_index -= CAPITALIZED_WINDOW
+
+    while col_index >= CAPITALIZED_WINDOW:
+        label += chr(CAPITALIZED_ASCII_CODE + col_index % CAPITALIZED_WINDOW)
+        col_index -= CAPITALIZED_WINDOW
+    return label