add a tool to list task assignments

Change-Id: If2d150c9ec074eae4f56e1dd027e04189b0f2786
Signed-off-by: Doug Hellmann <doug@doughellmann.com>

goal_tools/list_tasks.py

@@ -0,0 +1,84 @@
+#!/usr/bin/env python3
+
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+import argparse
+import logging
+import os.path
+import warnings
+
+import appdirs
+
+from goal_tools import storyboard
+
+LOG = logging.getLogger()
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    config_dir = appdirs.user_config_dir('OSGoalTools', 'OpenStack')
+    config_file = os.path.join(config_dir, 'storyboard.ini')
+    parser.add_argument(
+        '--config-file',
+        default=config_file,
+        help='configuration file (%(default)s)',
+    )
+    group = parser.add_mutually_exclusive_group()
+    group.add_argument(
+        '-v',
+        help='verbose mode',
+        dest='log_level',
+        default=logging.WARNING,
+        action='store_const',
+        const=logging.INFO,
+    )
+    group.add_argument(
+        '-q',
+        help='quiet mode',
+        dest='log_level',
+        action='store_const',
+        const=logging.WARNING,
+    )
+    parser.add_argument(
+        'story_id',
+        help='ID of the story to update',
+    )
+    args = parser.parse_args()
+
+    warnings.filterwarnings(
+        'ignore',
+        '.*Unverified HTTPS request is being made.*',
+    )
+
+    logging.basicConfig(level=args.log_level, format='%(message)s')
+
+    config = storyboard.get_config(args.config_file)
+
+    try:
+        sbc = storyboard.get_client(config)
+    except Exception as err:
+        parser.error(err)
+
+    story = sbc.stories.get(id=args.story_id)
+    LOG.info('Found story %s (%s)', story.id, story.title)
+    for task in story.tasks.get_all():
+        if task.assignee_id:
+            user = sbc.users.get(id=task.assignee_id)
+            owner = '{} ({})'.format(
+                user.full_name,
+                user.id,
+            )
+        else:
+            owner = 'None'
+        LOG.info('%s: %s assigned to %s',
+                 task.id, task.title, owner)

setup.cfg

@@ -31,6 +31,7 @@ console_scripts =
 	find-story = goal_tools.find_story:main
 	update-tasks = goal_tools.update_tasks:main
 	assign-task = goal_tools.assign_task:main
+	list-tasks = goal_tools.list_tasks:main
 
 who_helped =
     contributions list = goal_tools.who_helped.contributions:ListContributions