add script to generate branching instructions

This script reads the governance files to find repository tags and
owners, and deliverable files from the releases repository, and emits a
series of shell instructions for creating stable branches.

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

README.rst

@@ -299,7 +299,7 @@ project.
 
 
 make_stable_branch.sh
------------------------------
+---------------------
 
 This script makes a stable branch from an existing tag and updates the
 .gitreview file in the new branch for future submissions.
@@ -308,6 +308,16 @@ This script makes a stable branch from an existing tag and updates the
 
   ./make_stable_branch.sh kilo openstack/oslo.config 1.9.2
 
+batch-stable-branches
+---------------------
+
+This command generates a series of calls to make_stable_branch.sh
+using the governance repository and releases repository as inputs.
+
+::
+
+  batch-stable-branches --tag type:library --tag release:has-stable-branches --tag release:managed -r ~/repos/openstack/releases mitaka
+
 make_feature_branch.sh
 ----------------------
 

releasetools/cmds/batch_create_stable_branches.py

@@ -0,0 +1,110 @@
+#!/usr/bin/env python
+
+#    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.
+
+"""Generate the commands to create stable branches for a bunch of projects.
+"""
+
+from __future__ import print_function
+
+import argparse
+import glob
+import os.path
+
+from releasetools import governance
+
+import yaml
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument(
+        '--project-list',
+        default=governance.PROJECTS_LIST,
+        help='a URL pointing to a projects.yaml file, defaults to %(default)s',
+    )
+    parser.add_argument(
+        '--releases-repo', '-r',
+        default='.',
+        help='path to the releases repository for automatic scanning',
+    )
+    parser.add_argument(
+        '--team',
+        help='the name of the project team, such as "Nova" or "Oslo"',
+    )
+    parser.add_argument(
+        '--tag',
+        action='append',
+        default=[],
+        help='the name of a tag, such as "release:managed"',
+    )
+    parser.add_argument(
+        '--verbose', '-v',
+        action='store_true',
+        default=False,
+        help='produce detailed output',
+    )
+    parser.add_argument(
+        'series',
+        help='the name of the release series to work on'
+    )
+    args = parser.parse_args()
+
+    team_data = governance.get_team_data()
+    if args.verbose:
+        print('# Filtering on team: {}'.format(args.team))
+        print('# Filtering on tags: {}'.format(args.tag))
+    filtered_repos = {
+        r.name
+        for r in governance.get_repositories(team_data=team_data,
+                                             team_name=args.team,
+                                             tags=args.tag,
+                                             code_only=True)
+    }
+
+    pattern = os.path.join(args.releases_repo, 'deliverables',
+                           args.series, '*.yaml')
+    deliverable_files = sorted(glob.glob(pattern))
+
+    for filename in deliverable_files:
+        if args.verbose:
+            print('\n# {}'.format(filename))
+        with open(filename, 'r') as f:
+            deliverable_data = yaml.safe_load(f)
+        releases = deliverable_data.get('releases')
+        if not releases:
+            if args.verbose:
+                print('#  no releases')
+            continue
+        latest_release = releases[-1]
+        projects = latest_release.get('projects')
+        if not projects:
+            if args.verbose:
+                print('#  no projects')
+            continue
+        for project in projects:
+            repo = project['repo']
+            if repo in filtered_repos:
+                print('make_stable_branch.sh {series} {repo} {version}'.format(
+                    series=args.series,
+                    repo=repo,
+                    version=latest_release['version'],
+                ))
+            elif args.verbose:
+                print('#  {} does not match search criteria'.format(repo))
+
+    return 0
+
+
+if __name__ == '__main__':
+    main()

setup.cfg

@@ -35,3 +35,4 @@ console_scripts =
     launchpad-login = releasetools.cmds.launchpad_login:main
     send-mail = releasetools.cmds.mail:main
     dashboard = releasetools.cmds.dashboard:main
+    batch-stable-branches = releasetools.cmds.batch_create_stable_branches:main