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) " + 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