)
import turbot.sheets
import turbot.slack
-import itertools
+from turbot.slack import slack_send_message, slack_channel_members
TURBOT_USER_ID = 'U01B9QM4P9R'
lambda_success = {'statusCode': 200}
lambda_error = {'statusCode': 400}
+def channel_url(channel_id):
+ return "https://halibutthatbass.slack.com/archives/{}".format(channel_id)
+
def puzzle_block(puzzle):
name = puzzle['name']
status = puzzle['status']
+ solution = puzzle['solution']
channel_id = puzzle['channel_id']
+ url = puzzle.get('url', None)
+ sheet_url = puzzle.get('sheet_url', None)
+ state = puzzle.get('state', None)
status_emoji = ''
+ solution_str = ''
if status == 'solved':
status_emoji = ":ballot_box_with_check:"
else:
status_emoji = ":white_square:"
- puzzle_text = "{} {}: <#{}>".format(status_emoji, name, channel_id)
+ if len(solution):
+ solution_str = "*`" + '`, `'.join(solution) + "`*"
+
+ links = []
+ if url:
+ links.append("<{}|Puzzle>".format(url))
+ if sheet_url:
+ links.append("<{}|Sheet>".format(sheet_url))
+
+ state_str = ''
+ if state:
+ state_str = "\n{}".format(state)
+
+ puzzle_text = "{}{} <{}|{}> ({}){}".format(
+ status_emoji, solution_str,
+ channel_url(channel_id), name,
+ ', '.join(links), state_str
+ )
return section_block(text_block(puzzle_text))
response = turb.db.Table(hunt_id).scan()
puzzles = response['Items']
- hunt_text = "*{}*: <#{}>".format(name, channel_id)
+ hunt_text = "*<{}|{}>*".format(channel_url(channel_id), name)
return [
section_block(text_block(hunt_text)),
hunt_blocks = []
for hunt in hunts:
- if hunt['active']:
- hunt_blocks += hunt_block(turb, hunt)
+ if not hunt['active']:
+ continue
+ if user_id not in slack_channel_members(turb.slack_client,
+ hunt['channel_id']):
+ continue
+ hunt_blocks += hunt_block(turb, hunt)
return {
"type": "home",
"blocks": [
- section_block(text_block("*Active hunts*")),
+ section_block(text_block("*Hunts you belong to*")),
divider_block(),
* hunt_blocks,
actions_block(button_block("New hunt", "new_hunt"))
hunts_table.put_item(Item=item)
# Also, let the channel users know what we are up to
- turb.slack_client.chat_postMessage(
- channel=channel_id,
- text="Welcome to the channel for the {} hunt! ".format(item['name'])
+ slack_send_message(
+ turb.slack_client, channel_id,
+ "Welcome to the channel for the {} hunt! ".format(item['name'])
+ "Please wait a minute or two while I create some backend resources.")
- # Create a sheet for the channel
- sheet = turbot.sheets.sheets_create(turb, channel_name)
+ # Create a sheet for the hunt
+ sheet = turbot.sheets.sheets_create(turb, item['name'])
# Update the database with the URL of the sheet
item['sheet_url'] = sheet['url']
hunts_table.put_item(Item=item)
# Message the channel with the URL of the sheet
- turb.slack_client.chat_postMessage(channel=channel_id,
- text="Sheet created for this hunt: {}"
- .format(sheet['url']))
+ slack_send_message(turb.slack_client, channel_id,
+ "Sheet created for this hunt: {}".format(sheet['url']))
# Create a database table for this hunt's puzzles
table = turb.db.create_table(
hunts_table.put_item(Item=item)
# Message the hunt channel that the database is ready
- turb.slack_client.chat_postMessage(
- channel=channel_id,
- text="Thank you for waiting. This hunt is now ready to begin! "
+ slack_send_message(
+ turb.slack_client, channel_id,
+ "Thank you for waiting. This hunt is now ready to begin! "
+ "Use `/puzzle` to create puzzles for the hunt.")
return lambda_success
+def set_channel_description(turb, puzzle):
+ channel_id = puzzle['channel_id']
+ description = puzzle['name']
+ url = puzzle.get('url', None)
+ sheet_url = puzzle.get('sheet_url', None)
+
+ links = []
+ if url:
+ links.append("<{}|Puzzle>".format(url))
+ if sheet_url:
+ links.append("<{}|Sheet>".format(sheet_url))
+
+ if len(links):
+ description += "({})".format(', '.join(links))
+
+ turb.slack_client.conversations_setPurpose(channel=channel_id,
+ purpose=description)
+ turb.slack_client.conversations_setTopic(channel=channel_id,
+ topic=description)
+
def puzzle_channel_created(turb, puzzle_channel_name, puzzle_channel_id):
"""Creates sheet and invites user for a newly-created puzzle channel"""
# and Slack retries the event, that next event will see this 'pending'
# string and cleanly return (eliminating all future retries).
item['sheet_url'] = 'pending'
+ item['channel_url'] = channel_url(puzzle_channel_id)
puzzle_table.put_item(Item=item)
# Create a sheet for the puzzle
- sheet = turbot.sheets.sheets_create_for_puzzle(turb, puzzle_channel_name)
+ sheet = turbot.sheets.sheets_create_for_puzzle(turb, item)
# Update the database with the URL of the sheet
item['sheet_url'] = sheet['url']
puzzle_table.put_item(Item=item)
- # Message the channel with the URL of the puzzle's sheet
- turb.slack_client.chat_postMessage(channel=puzzle_channel_id,
- text="Sheet created for this puzzle: {}"
- .format(sheet['url']))
+ # Get the new sheet_url into the channel description
+ set_channel_description(turb, item)
+ # Lookup and invite all users from this hunt to this new puzzle
hunts_table = turb.db.Table('hunts')
response = hunts_table.scan(
FilterExpression='hunt_id = :hunt_id',
# Filter out Turbot's own ID to avoid inviting itself
members = [m for m in members if m != TURBOT_USER_ID]
- turb.slack_client.chat_postMessage(
- channel=puzzle_channel_id,
- text="Inviting all members from the hunt channel: {}"
- .format(hunt_id))
+ slack_send_message(
+ turb.slack_client, puzzle_channel_id,
+ "Inviting all members from the hunt channel: "
+ + "<#{}>".format(hunt_channel_id))
# Invite those members to the puzzle channel (in chunks of 500)
cursor = 0
users=members[cursor:cursor + 500])
cursor += 500
+ # And finally, give a welcome message with some documentation
+ # on how to update the state of the puzzle in the database.
+ welcome_msg = (
+ "Welcome! This channel is the primary place to "
+ + "discuss things as the team works together to solve the "
+ + "puzzle '{}'. ".format(item['name'])
+ )
+
+ if 'url' in item:
+ welcome_msg += (
+ "See the <{}|puzzle itself> ".format(item['url'])
+ + "for what was originally presented to us."
+ )
+
+ sheet_msg = (
+ "Actual puzzle solving work will take place within the following "
+ + "<{}|shared spreadsheet> ".format(item['sheet_url'])
+ )
+
+ state_msg = (
+ "Whenever the status of the puzzle progress changes "
+ + "significantly, please type `/state` with a brief message "
+ + "explaining where things stand. This could be something "
+ + "like `/state Grid is filled. Need insight for extraction.` "
+ + "or `/state Nathan has printed this and is cutting/assembling`. "
+ + "It's especially important to put information in `/state` "
+ + "when you step away from a puzzle so the next team members "
+ + "to arrive will know what is going on."
+ )
+
+ solved_msg = (
+ "When a puzzle has been solved, submitted, and the solution is "
+ + "confirmed, please type `/solved THE PUZZLE ANSWER HERE`. All "
+ + "information given in `/state` and `/solved` will be presented "
+ + "in this channel's topic as well as in the hunt overview "
+ + "(which is available by selecting \"Turbot\" from the Slack "
+ + "list of members)."
+ )
+
+ turb.slack_client.chat_postMessage(
+ channel=puzzle_channel_id,
+ text="New puzzle: {}".format(item['name']),
+ blocks=[
+ section_block(text_block(welcome_msg)),
+ section_block(text_block(sheet_msg)),
+ section_block(text_block(state_msg)),
+ section_block(text_block(solved_msg))
+ ])
+
return lambda_success
def channel_created(turb, event):