]> git.cworth.org Git - turbot/blobdiff - turbot/sheets.py
Add notes on how to update the Google sheets credentials
[turbot] / turbot / sheets.py
index f2a9681f7c7483593d6cfad973076dadf802c61e..76515ca09547c660a94466fd6d223259211b7f44 100644 (file)
 PUZZLE_TEMPLATE_ID = "1drSoyrE4gM3JaGweDkOybwXWdKPIDTfUmB1gQCYS3Uw"
-PUZZLE_TEMPLATE_SHEETS = ["Text", "Grid"]
+PUZZLE_TEMPLATE_SHEETS = ["Text", "Square grid", "Hex Grid",
+                          "Formula reference: indexing"]
 
-def sheets_create(turb, name):
-    """Create a new sheet with the given name.
+def sheets_create_folder(turb, folder_name, parents = None):
+    """Create a new folder within Google Drive
 
-    Returns the dict with 'id' and 'url'of the spreadsheet.
+    Returns the id of the created folder."""
+
+    body = {
+        "name": folder_name,
+        "mimeType": "application/vnd.google-apps.folder"
+    }
+
+    if parents:
+        body["parents"] = parents
+
+    folder = turb.files.create(body=body, fields='id').execute()
+
+    return folder.get('id')
+
+def sheets_create(turb, name, folder_id):
+    """Create a new spreadsheet with the given name.
+
+    Returns a dict with 'id' and 'url' of the spreadsheet
     """
 
-    # Create a new spreadsheet
-    spreadsheet_body = {
-        'properties': {
-            'title': name
-        }
+    body = {
+        "name": name,
+        "parents": [folder_id],
+        "mimeType": "application/vnd.google-apps.spreadsheet"
     }
 
-    new_sheet = turb.sheets.create(body=spreadsheet_body).execute()
+    spreadsheet = turb.files.create(body=body, fields='id').execute()
+    id = spreadsheet['id']
+
+    # The files.create call gives us the ID for our new sheet, but we
+    # need the URL for it as well. So we get that with the sheets API.
+    spreadsheet = turb.sheets.get(spreadsheetId=id,
+                                  fields='spreadsheetUrl').execute()
+    url = spreadsheet['spreadsheetUrl']
 
-    # Now that we've created a new sheet, we need to also allow anyone
-    # with the link to the sheet to be able to edit it.
-    turb.permissions.create(fileId=new_sheet["spreadsheetId"],
+    # Finally, we want to also allow anyone with the link to the sheet
+    # to be able to edit it.
+    turb.permissions.create(fileId=id,
                             body={'type': 'anyone', 'role': 'writer'},
-                            fields='id').execute()
+                            fields='').execute()
 
     return {
-        'id': new_sheet["spreadsheetId"],
-        'url': new_sheet["spreadsheetUrl"]
+        'id': id,
+        'url': url
     }
 
-def sheets_create_for_puzzle(turb, name):
+def sheets_create_for_puzzle(turb, puzzle, folder_id):
     """Creates a new sheet for a puzzle of the given name
 
-    Like sheets_create(), but also copies the puzzle template sheet."""
+    Like sheets_create(), but also copies the puzzle template sheet.
 
-    # First create the new sheet
-    new_sheet = sheets_create(turb, name)
+    Here, 'puzzle' is a dict that must have a 'name' key and may optionally
+    have a 'channel_url' or 'url' key.
+    """
+
+    # First create the new spreadsheet
+    spreadsheet = sheets_create(turb, puzzle['name'], folder_id)
+    spreadsheet_id = spreadsheet['id']
+    spreadsheet_url = spreadsheet['url']
 
-    # Copy some sheets from the Template spreadsheet
+    # And fetch the individual "sheets" from the spreadsheet
+    spreadsheet = turb.sheets.get(spreadsheetId=spreadsheet_id,
+                                  fields='sheets').execute()
+    first_sheet_id = spreadsheet['sheets'][0]['properties']['sheetId']
 
+    # Then, copy some useful sheets over from the Template spreadsheet
     response = turb.sheets.get(spreadsheetId=PUZZLE_TEMPLATE_ID).execute()
 
     for sheet in response["sheets"]:
         if sheet["properties"]["title"] in PUZZLE_TEMPLATE_SHEETS:
-            turb.sheets.sheets().copyTo(spreadsheetId=PUZZLE_TEMPLATE_ID,
-                                        sheetId=sheet["properties"]["sheetId"],
-                                        body={
-                                            "destinationSpreadsheetId":
-                                            new_sheet['id']
-                                        }).execute()
-
-    return new_sheet
+            res = turb.sheets.sheets().copyTo(
+                spreadsheetId=PUZZLE_TEMPLATE_ID,
+                sheetId=sheet["properties"]["sheetId"],
+                body={
+                    "destinationSpreadsheetId": spreadsheet_id
+                }).execute()
+            # Rename each copied sheet to match the name from the template
+            sheet_name = sheet["properties"]["title"]
+            # Except for "Text" which we rename to the puzzle name
+            if sheet_name == "Text":
+                sheet_name = puzzle['name']
+            rename_sheet(turb, spreadsheet_id, res['sheetId'], sheet_name)
+
+    # Next, delete the blank sheet made at spreadsheet creation time
+    delete_sheet(turb, spreadsheet_id, first_sheet_id)
+
+    # Insert some useful links into the sheet where expected
+    if 'url' in puzzle:
+        url_link = puzzle['url']
+        url_text = "Original puzzle link"
+        spreadsheet_update_data(
+            turb, spreadsheet_id, "B1:B1",
+            '=HYPERLINK("{}","{}")'.format(url_link, url_text))
+
+    if 'channel_url' in puzzle:
+        url_link = puzzle['channel_url']
+        url_text = "Slack channel link"
+        spreadsheet_update_data(
+            turb, spreadsheet_id, "B2:B2",
+            '=HYPERLINK("{}","{}")'.format(url_link, url_text))
+
+    return {
+        'id': spreadsheet_id,
+        'url': spreadsheet_url
+    }
+
+def spreadsheet_update_data(turb, spreadsheet_id, range, text):
+
+    turb.sheets.values().update(
+        spreadsheetId=spreadsheet_id,
+        range=range,
+        valueInputOption='USER_ENTERED',
+        body={
+            'range': range,
+            'values': [
+                [text]
+            ]
+        }
+    ).execute()
+
+def delete_sheet(turb, spreadsheet_id, sheet_id):
+
+    body = {
+        'requests': [{
+            'deleteSheet': {
+                'sheetId': sheet_id,
+            },
+        }]
+    }
+
+    turb.sheets.batchUpdate(spreadsheetId=spreadsheet_id,
+                            body=body
+                            ).execute()
+
+def rename_sheet(turb, spreadsheet_id, sheet_id, name):
+
+    body = {
+        'requests': [{
+            'updateSheetProperties': {
+                'properties': {
+                    'sheetId': sheet_id,
+                    'title': name
+                },
+                'fields': 'title'
+            }
+        }]
+    }
+
+    turb.sheets.batchUpdate(spreadsheetId=spreadsheet_id,
+                            body=body
+                            ).execute()
+
+def spreadsheet_id_from_url(url):
+    # Google sheet ids are between the /d/ and /edit in the url, like
+    # https://docs.google.com/spreadsheets/d/1dxHBzjen...-LaXeVPrg/edit#gid=0
+    start = url.find('/d/') + 3
+    end = url.find('/edit')
+    return url[start:end]
+
+def rename_spreadsheet(turb, spreadsheet_url, name):
+
+    spreadsheet_id = spreadsheet_id_from_url(spreadsheet_url)
+
+    body = {
+        'requests': [{
+            'updateSpreadsheetProperties': {
+                'properties': {
+                    'title': name
+                },
+                'fields': 'title'
+            }
+        }]
+    }
+
+    turb.sheets.batchUpdate(spreadsheetId=spreadsheet_id,
+                            body=body
+                            ).execute()