smartsheet-tools 0.0.1__py3-none-any.whl → 0.0.3__py3-none-any.whl

smartsheet_tools/__init__.py

@@ -0,0 +1,146 @@
+from datetime import datetime
+import re
+from smartsheet.models import Cell, Row, Folder, Sheet
+
+# Cache for column types to minimize API calls when correcting date formats
+_COLUMN_TYPE_CACHE = {}
+
+def norm(v):
+    if v is None:
+        return ""
+    s = str(v).strip().lower()
+    return re.sub(r"\.0+$", "", s)
+
+def disp_or_val(cell):
+    # prefer display_value when Smartsheet provides a formatted value
+    dv = getattr(cell, "display_value", None)
+    return dv if dv not in (None, "") else cell.value
+
+def title_to_index(sheet):
+    # authoritative positions from Smartsheet (not Python enumerate order)
+    return {c.title: c.index for c in sheet.columns}
+
+def index_to_id(sheet):
+    # authoritative positions from Smartsheet (not Python enumerate order)
+    return {c.index: c.id for c in sheet.columns}
+
+def id_to_index(sheet):
+    # authoritative positions from Smartsheet (not Python enumerate order)
+    return {c.id: c.index for c in sheet.columns}
+
+def id_to_title(sheet):
+    return {c.id: c.title for c in sheet.columns}
+
+def title_to_id(sheet):
+    return {c.title: c.id for c in sheet.columns}
+
+def guard_row(row, *idxs):
+    # ensure row has enough cells for all requested positions
+    return max(idxs) < len(row.cells)
+
+def datetime_to_isoformat(dt):
+    if dt is None:
+        return None
+    return dt.replace(microsecond=0).isoformat() + 'Z'
+
+def standard_time_to_isoformat(st):
+    if st is None:
+        return None
+    return datetime_to_isoformat(datetime.strptime(st, "%m/%d/%Y"))
+
+def get_cached_column_type(column_id, sheet_obj):
+    if sheet_obj.id not in _COLUMN_TYPE_CACHE:
+        _COLUMN_TYPE_CACHE[sheet_obj.id] = {}
+        
+    if column_id not in _COLUMN_TYPE_CACHE[sheet_obj.id]:
+        _COLUMN_TYPE_CACHE[sheet_obj.id][column_id] = str(sheet_obj.get_column(column_id).type)
+    
+    return _COLUMN_TYPE_CACHE[sheet_obj.id][column_id]
+
+def get_col_names_of_date_cols(sheet_obj):
+    return [c.title for c in sheet_obj.columns if get_cached_column_type(c.id, sheet_obj) in ("DATE", "DATETIME")]
+
+def brute_force_date_string(s, nonetype_if_fail=False):
+    # attempt to parse a date string in common formats to ISO 8601
+    if isinstance(s, datetime):
+        return datetime_to_isoformat(s)
+    
+    if not isinstance(s, str):
+        return None if nonetype_if_fail else s
+    
+    s = s.split(" ")[0]
+    for fmt in ("%Y-%m-%d", "%m/%d/%Y", "%m/%d/%y"):
+        try:
+            return datetime_to_isoformat(datetime.strptime(s, fmt))
+        except ValueError:
+            continue
+    return None if nonetype_if_fail else s
+
+
+def is_date_col(column_id, sheet_obj):
+    column_type = get_cached_column_type(column_id, sheet_obj)
+    return column_type in ("DATE", "DATETIME")
+
+def correct_date_format(isoformat_datetime, column_id, sheet_obj):
+    if isinstance(isoformat_datetime, datetime):
+        isoformat_datetime = datetime_to_isoformat(isoformat_datetime)
+
+    column_type = get_cached_column_type(column_id, sheet_obj)
+    if column_type == "DATE":
+        return isoformat_datetime.split("T",1)[0]
+    elif column_type == "DATETIME":
+        return isoformat_datetime
+    return None
+
+def new_cell(column_id, value=None, strict=False, formula=None):
+    new_cell = Cell()
+    new_cell.column_id = column_id
+    if formula is not None:
+        new_cell.formula = formula
+    else:
+        new_cell.value = value
+    if strict:
+        new_cell.strict = True
+    return new_cell
+
+def new_row(cells=None, id=None, parent_id=None, to_top=False):
+    new_row = Row()
+    if cells:
+        new_row.cells = cells
+    if id:
+        new_row.id = id
+    if parent_id:
+        new_row.parent_id = parent_id
+    if to_top:
+        new_row.to_top = to_top
+    return new_row
+
+def walk_folder_for_sheets(smartsheet_client, folder_id):
+    for item in smartsheet_client.Folders.get_folder_children(folder_id).data:
+        if isinstance(item, Folder):
+            yield from walk_folder_for_sheets(smartsheet_client, item.id)
+        elif isinstance(item, Sheet):
+            yield item
+
+def walk_workspace_for_sheets(smartsheet_client, workspace_id):
+    for item in smartsheet_client.Workspaces.get_workspace_children(workspace_id).data:
+        if isinstance(item, Folder):
+            yield from walk_folder_for_sheets(smartsheet_client, item.id)
+        elif isinstance(item, Sheet):
+            yield item
+            
+def walk_folder_for_folders(smartsheet_client, folder_id):
+    for item in smartsheet_client.Folders.get_folder_children(folder_id).data:
+        if isinstance(item, Folder):
+            yield item
+            yield from walk_folder_for_folders(smartsheet_client, item.id)
+            
+def walk_workspace_for_folders(smartsheet_client, workspace_id):
+    for item in smartsheet_client.Workspaces.get_workspace_children(workspace_id).data:
+        if isinstance(item, Folder):
+            yield item
+            yield from walk_folder_for_folders(smartsheet_client, item.id)
+            
+def walk_sheet_names_from_workspace(smartsheet_client, workspace_id):
+    for sheet in walk_workspace_for_sheets(smartsheet_client, workspace_id):
+        yield sheet.name

{smartsheet_tools-0.0.1.dist-info → smartsheet_tools-0.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: smartsheet_tools
-Version: 0.0.1
+Version: 0.0.3
 Summary: A collection of convenience functions to aid with transitioning from simple-smartsheet to the SDK API and common tasks
 Author: Ashton Pooley
 Author-email: Ashton Pooley <ashton@ashi.digital>

smartsheet_tools-0.0.3.dist-info/RECORD

@@ -0,0 +1,6 @@
+smartsheet_tools/__init__.py,sha256=-0zRzn_7MUDL4sFfNzXRWTJj0MUY7NZ96O_5rSTmJiE,5268
+smartsheet_tools-0.0.3.dist-info/licenses/LICENSE,sha256=xshMXNQ83e1x1bG3-9fQ5U8hnMaJsv79ke3xuKmI2PI,31914
+smartsheet_tools-0.0.3.dist-info/METADATA,sha256=X_Tkf-hEspLuLBHreCq65BOSeKaBKi258LkNiL8sab8,834
+smartsheet_tools-0.0.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+smartsheet_tools-0.0.3.dist-info/top_level.txt,sha256=UXKUTK6mn1resx7hDN-MqSLi6ZnojUbkJ44VzmNmYi8,17
+smartsheet_tools-0.0.3.dist-info/RECORD,,

smartsheet_tools-0.0.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+smartsheet_tools

smartsheet_tools-0.0.1.dist-info/RECORD

@@ -1,5 +0,0 @@
-smartsheet_tools-0.0.1.dist-info/licenses/LICENSE,sha256=xshMXNQ83e1x1bG3-9fQ5U8hnMaJsv79ke3xuKmI2PI,31914
-smartsheet_tools-0.0.1.dist-info/METADATA,sha256=0JXbYO3MWkrZl9TXDer_AM1oSjbapvyvYxzR_383n90,834
-smartsheet_tools-0.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-smartsheet_tools-0.0.1.dist-info/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-smartsheet_tools-0.0.1.dist-info/RECORD,,

smartsheet_tools-0.0.1.dist-info/top_level.txt

@@ -1 +0,0 @@
-