From 510e8c9a5d19a6f7cc16eb8407b09e9e10c94b81 Mon Sep 17 00:00:00 2001
From: Doug Hellmann <doug@doughellmann.com>
Date: Mon, 19 Nov 2018 12:54:56 -0500
Subject: [PATCH] add a script to get a list of unreleased changes for a team

Change-Id: I061cea61dd5d0a7711faae9e06809993caf36de9
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
---
 doc/source/reference/using.rst            | 16 +++++-
 tools/functions                           | 22 ++++++++
 tools/list_unreleased_changes_for_team.sh | 67 +++++++++++++++++++++++
 3 files changed, 102 insertions(+), 3 deletions(-)
 create mode 100755 tools/list_unreleased_changes_for_team.sh

diff --git a/doc/source/reference/using.rst b/doc/source/reference/using.rst
index c358725e10..1cf53ac73b 100644
--- a/doc/source/reference/using.rst
+++ b/doc/source/reference/using.rst
@@ -646,12 +646,22 @@ looking at the commit logs.
 Print the list of changes in ``openstack/oslo.config`` along the
 master branch.
 
+tools/list_unreleased_changes_for_team.sh
+-----------------------------------------
+
+Given a series and team name, produce a list of the changes in the
+repositories for that team since their last tag on that branch. This
+is useful for deciding if a project needs to prepare a release, and
+for predicting what the next release version should be by looking at
+the commit logs.
+
 ::
 
-  ./tools/list_unreleased_changes.sh stable/kilo $(list-deliverables --repos --team Oslo)
+  ./tools/list_unreleased_changes_for_team.sh stein oslo
 
-Print the list of changes in the ``stable/kilo`` branch of all Oslo
-libraries.
+Print the list of changes in Oslo team repositories along the branch
+for the stein release ('master' before the release and 'stable/stein'
+after the release).
 
 tools/list_library_unreleased_changes.sh
 ----------------------------------------
diff --git a/tools/functions b/tools/functions
index d02a9d6c86..c86203a032 100644
--- a/tools/functions
+++ b/tools/functions
@@ -117,3 +117,25 @@ function clone_repo {
 
     return $_retval
 }
+
+
+function series_to_branch {
+    typeset series="$1"
+
+    typeset default=$(python -c 'from openstack_releases import defaults; print(defaults.RELEASE)')
+    if [ "$series" = "$default" ]; then
+        echo "master"
+    else
+        echo "stable/$series"
+    fi
+}
+
+
+function enable_tox_venv {
+    # Set up and activate the virtualenv that contains the
+    # edit-deliverable command.
+    if [ ! -d .tox/venv ]; then
+        tox -e venv --notest
+    fi
+    source .tox/venv/bin/activate
+}
diff --git a/tools/list_unreleased_changes_for_team.sh b/tools/list_unreleased_changes_for_team.sh
new file mode 100755
index 0000000000..0be473da38
--- /dev/null
+++ b/tools/list_unreleased_changes_for_team.sh
@@ -0,0 +1,67 @@
+#!/bin/bash
+#
+#    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.
+#
+# Provide a list of the unreleased changes in the given repositories
+
+if [[ $# -lt 2 ]]; then
+    echo "Usage: $(basename $0) <series> <team>"
+    echo "series should be e.g. 'stein' or 'rocky'"
+    echo "team should be e.g. glance"
+    exit 1
+fi
+
+series="$1"
+team="$2"
+
+TOOLSDIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+BASEDIR=$(dirname $TOOLSDIR)
+source $TOOLSDIR/functions
+enable_tox_venv
+
+# Make sure no pager is configured so the output is not blocked
+export PAGER=
+
+setup_temp_space 'list-unreleased'
+
+branch=$(series_to_branch "$series")
+
+function list_changes {
+    title "Unreleased changes in $repo ($branch)"
+    clone_repo $repo $branch
+    if [[ $? -ne 0 ]]; then
+        return 1
+    fi
+    cd $repo
+    prev_tag=$(get_last_tag)
+    if [ -z "$prev_tag" ]; then
+        echo "$repo has not yet been released"
+    else
+        echo
+        end_sha=$(git log -n 1 --pretty=tformat:%h)
+        echo "Changes between $prev_tag and $end_sha"
+        echo
+        git log --no-color --no-merges --format='%h %ci %s' \
+            --graph ${prev_tag}..${end_sha}
+        echo
+    fi
+}
+
+repos=$(list-deliverables -r --team "$team" --series "$series")
+
+# Show the unreleased changes for each repository.
+for repo in $repos; do
+    cd $MYTMPDIR
+    echo
+    list_changes "$repo"
+done