return topic
+def puzzle_channel_description(puzzle):
+ """Compute the channel description for a puzzle"""
+
+ url = puzzle.get('url', None)
+ sheet_url = puzzle.get('sheet_url', None)
+ tags = puzzle.get('tags', [])
+ state = puzzle.get('state', None)
+
+ description = (
+ "Discussion to solve the puzzle \"{}\".\n".format(puzzle['name'])
+ )
+
+ if url:
+ description += "See the <{}|Original puzzle>\n".format(url)
+
+ if sheet_url:
+ description += (
+ "Actual solving work takes place in the "
+ + "<{}|shared spreadsheet>\n".format(sheet_url)
+ )
+
+ if tags:
+ description += "This puzzle has the following tags: {}\n".format(
+ " ".join(["`{}`".format(t) for t in tags]))
+
+ if state:
+ description += "This puzzle has a state of: {}\n".format(state)
+
+ description += (
+ "You can see a summary of this information at any point "
+ + "by issuing the `/puzzle` command and you can edit any of "
+ + "this information by issuing the `/edit` command"
+ )
+
+ return description
+
def puzzle_channel_name(puzzle):
"""Compute the channel name for a puzzle"""
turb.slack_client.conversations_setTopic(channel=channel_id,
topic=channel_topic)
+ # Compute the channel description and set it if it has changed
+ channel_description = puzzle_channel_description(puzzle)
+
+ old_channel_description = None
+ if old_puzzle:
+ old_channel_description = puzzle_channel_description(old_puzzle)
+
+ if channel_description != old_channel_description:
+ turb.slack_client.conversations_setPurpose(channel=channel_id,
+ purpose=channel_description)
+
# Compute the sheet name and set it if it has changed
sheet_name = puzzle_sheet_name(puzzle)