stable-rt-tools 1.4__py3-none-any.whl

stable_rt_tools/__init__.py

@@ -0,0 +1,26 @@
+#!/usr/bin/env python3
+#
+# srt - support out of tree patch workflows
+#
+# Copyright (c) Daniel Wagner <dwagner@suse.de>
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+"""
+    srt - support out of tree patch workflows
+"""

stable_rt_tools/about.py

@@ -0,0 +1,51 @@
+# stable-rt-tools - support out of tree patch workflows
+#
+# Copyright (c) Daniel Wagner <dwagner@suse.de>
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+"""
+    Setup script for stable-rt-tools, a tool to support out of
+    tree patch workflows
+"""
+
+__all__ = [
+    '__version__',
+    '__title__',
+    '__summary__',
+    '__uri__',
+    '__doc_uri__',
+    '__author__',
+    '__email__',
+    '__license__',
+    '__copyright__',
+]
+
+__version__ = '1.4'
+
+__title__ = 'stable-rt-tools'
+__summary__ = 'Support out of tree patch workflows'
+__uri__ = 'https://github.com/igaw/stable-rt-tools/' \
+    'releases/archive/{version}.tar.gz'.format(version=__version__)
+__doc_uri__ = 'https://stable-rt-tools.readthedocs.io'
+
+__author__ = "Daniel Wagner"
+__email__ = 'dwagner@suse.de'
+
+__license__ = 'MIT'
+__copyright__ = 'Copyright (c) {} <{}>'.format(__author__, __email__)

stable_rt_tools/srt.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+#
+# srt - stable rt tooling
+#
+# Copyright (c) Siemens AG, 2018
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE
+
+import argparse
+import logging
+import sys
+
+from stable_rt_tools import (srt_announce, srt_commit, srt_create, srt_push,
+                             srt_sign, srt_tag, srt_upload, srt_patches,
+                             srt_prep, about)
+
+sub_cmd = {
+    'prep': srt_prep,
+    'commit': srt_commit,
+    'tag': srt_tag,
+    'create': srt_create,
+    'sign': srt_sign,
+    'upload': srt_upload,
+    'push': srt_push,
+    'announce': srt_announce,
+    'patches': srt_patches,
+}
+
+
+def srt_get_argparser():
+    parser = argparse.ArgumentParser(description='srt - stable -rt tool')
+    parser.add_argument('-d', '--debug',
+                        action='store_true',
+                        help='Enable debug logging')
+    parser.add_argument('-v', '--version',
+                        action='store_true',
+                        help='Show stable-rt-tools version')
+
+    subparser = parser.add_subparsers(help='sub command help', dest='cmd')
+
+    for _, cmd in sub_cmd.items():
+        cmd.add_argparser(subparser)
+
+    return parser
+
+
+def main():
+    parser = srt_get_argparser()
+    args = parser.parse_args(sys.argv[1:])
+    if args.version:
+        print('stable-rt-tools version {}'.format(about.__version__))
+        return
+
+    if args.debug:
+        logging.getLogger().setLevel(logging.DEBUG)
+    else:
+        logging.getLogger().setLevel(logging.INFO)
+
+    if args.cmd in sub_cmd:
+        sub_cmd[args.cmd].execute(args)
+
+
+if __name__ == "__main__":
+    main()

stable_rt_tools/srt_announce.py

@@ -0,0 +1,240 @@
+#!/usr/bin/env python3
+#
+# srt - stable rt tooling
+#
+# Copyright (c) Siemens AG, 2018
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE
+
+
+import os
+from datetime import date, timedelta
+from email.utils import make_msgid
+from time import gmtime, strftime
+
+try:
+    import importlib.resources as pkg_resources
+except ImportError:
+    import importlib_resources as pkg_resources
+
+from stable_rt_tools.srt_util import (check_context, cmd, confirm, get_config,
+                                      get_gpg_fingerprint,
+                                      get_local_branch_name,
+                                      get_remote_branch_name)
+from stable_rt_tools.srt_util_context import SrtContext
+
+
+def find_starting_ref(ctx):
+    # find starting point. first check for stable update only
+    ref = cmd(['git', 'log', '--pretty=format:%H', '--merges', '-n', '1'])
+
+    # if patches have been added, we find the old tag and should start there
+    # and not the last merge
+    commits = cmd(['git', 'log', '--simplify-by-decoration',
+                   '--oneline', str(ref) + '..'])
+    if ' '.join(commits.split('\n')).find(str(ctx.old_short_tag)) != -1:
+        ref = str(ctx.old_tag)
+
+    return ref
+
+
+def create_rc_patches(config, ctx):
+    branch_name = get_local_branch_name()
+    cmd(['git', 'checkout', '-b', 'next-tmp'])
+
+    srt_env = os.environ.copy()
+    srt_env['SRT_REVIEW_TAG'] = str(ctx.new_tag)
+    srt_env['FILTER_BRANCH_SQUELCH_WARNING'] = str(1)
+    srt_path = os.path.dirname(os.path.realpath(__file__))
+
+    ref = find_starting_ref(ctx)
+    cmd(['git', 'filter-branch', '-f', '--msg-filter',
+         srt_path + '/srt_git_filter.py', str(ref) + '..'],
+        env=srt_env)
+
+    cmd(['git', 'format-patch', str(ref) + '..',
+         '-o', ctx.new_dir_mails, '--subject-prefix', 'PATCH RT',
+         '--cover-letter'])
+
+    cmd(['git', 'checkout', branch_name])
+    cmd(['git', 'branch', '-D', 'next-tmp'])
+
+
+def cover_letter_replacements(config, ctx):
+    r = {
+        "mail_to": config['MAIL_TO'],
+        "major": ctx.new_tag.major,
+        "minor": ctx.new_tag.minor,
+        "patch": ctx.new_tag.patch,
+        "new_version": ctx.new_short_tag,
+        "old_version": ctx.old_short_tag,
+        "prj_dir": config['PRJ_DIR'],
+        "message_id": make_msgid(),
+        "sender": config['SENDER'],
+        "name": config['NAME'],
+        "new_tag_rt": ctx.new_tag.rt,
+        "gpg_key_fingerprint": get_gpg_fingerprint(config),
+    }
+    if ctx.is_rc:
+        r["new_tag_rc"] = ctx.new_tag.rc
+    return r
+
+
+def write_rc_cover_letter(config, ctx):
+    with open(ctx.new_dir_mails + '/0000-cover-letter.patch', 'r') as f:
+        coverletter = f.read()
+
+    coverletter = coverletter.replace('*** SUBJECT HERE ***',
+                                      'Linux ' + str(ctx.new_tag))
+
+    rc_text = ''
+    with open(get_rc_templ_path(config), 'r') as f:
+        rc_text = f.read()
+
+    r = cover_letter_replacements(config, ctx)
+
+    today = date.today()
+    rc_date = today + timedelta(weeks=1)
+    r["release_date"] = rc_date
+
+    rc_text = rc_text.format(**r)
+
+    coverletter = coverletter.replace('*** BLURB HERE ***',
+                                      rc_text)
+
+    with open(ctx.new_dir_mails + '/0000-cover-letter.patch', 'w') as f:
+        f.write(coverletter)
+
+
+def send_rc_patches(config, ctx, args):
+    gmd = ['git', 'send-email', '--confirm=never']
+    if args.suppress_cc:
+        gmd += ['--suppress-cc=all']
+    gmd += ['--to="{}"'.format(t) for t in config['MAIL_TO'].split(',')]
+    gmd += [ctx.new_dir_mails]
+
+    print('Dry run')
+    gmdd = gmd.copy()
+    gmdd.insert(2, '--dry-run')
+    print(cmd(gmdd, verbose=True))
+    if confirm('OK to send patches?'):
+        cmd(gmd)
+
+
+def announce_rc(config, ctx, args):
+    create_rc_patches(config, ctx)
+    write_rc_cover_letter(config, ctx)
+    send_rc_patches(config, ctx, args)
+
+
+def get_announce_tmpl_path(config):
+    if 'ANNOUNCE' in config:
+        return config['ANNOUNCE']
+
+    # Use importlib.resources.files for modern resource access
+    return str(
+        pkg_resources.files('stable_rt_tools').joinpath('announce-srt.txt')
+    )
+
+
+def get_rc_templ_path(config):
+    if 'RC_TEXT' in config:
+        return config['RC_TEXT']
+
+    return str(
+        pkg_resources.files('stable_rt_tools').joinpath('announce-srt-rc.txt')
+    )
+
+
+def announce(config, ctx, args):
+    from stable_rt_tools.srt_util import is_quilt_workflow
+    if ctx.is_rc:
+        announce_rc(config, ctx, args)
+        return
+
+    if is_quilt_workflow(config):
+        import subprocess
+        tag = str(ctx.new_tag) + '-patches'
+        try:
+            msg = subprocess.check_output([
+                'git', 'show', '-s', '--format=%B', tag
+            ], encoding='utf-8').strip()
+            announce_start = msg.find('[ANNOUNCE]')
+            if announce_start != -1:
+                lines = msg[announce_start:].splitlines()
+                msg = '\n'.join(lines[1:]).lstrip('\n')
+            else:
+                pass
+            timestamp = strftime('%a, %d %b %Y %H:%M:%S -0000', gmtime())
+            sender = config.get('SENDER', '')
+            mail_to = config.get('MAIL_TO', '')
+            print(f"From: {sender}")
+            print(f"To: {mail_to}")
+            print(f"Subject: [ANNOUNCE] {ctx.new_tag}")
+            print(f"Date: {timestamp}\n")
+            print(msg)
+        except Exception as e:
+            print(f"Error extracting announcement from tag {tag}: {e}")
+        return
+
+    # rfc2822.html
+    # 3.3. Date and Time Specification
+    timestamp = strftime('%a, %d %b %Y %H:%M:%S -0000', gmtime())
+
+    stable_rt_text = ''
+    with open(get_announce_tmpl_path(config), 'r') as f:
+        stable_rt_text = f.read()
+
+    r = cover_letter_replacements(config, ctx)
+
+    r["date"] = timestamp
+    r["branch_name"] = get_remote_branch_name()
+    r["branch_head"] = cmd(['git', 'rev-parse', 'HEAD'])
+
+    print(stable_rt_text.format(**r))
+
+    ref = find_starting_ref(ctx)
+    print(cmd(['git', '--no-pager', 'shortlog', '{0}..{1}'.
+               format(ref, ctx.new_tag)]))
+
+    print('---')
+
+    print(cmd(['git', '--no-pager', 'diff', '--stat', '{0}..{1}'.
+               format(ref, ctx.new_tag)]))
+
+    print('---')
+
+    print(cmd(['git', '--no-pager', 'diff', '{0}..{1}'.
+               format(ref, ctx.new_tag)]))
+
+
+def add_argparser(parser):
+    prs = parser.add_parser('announce')
+    prs.add_argument('OLD_TAG', nargs='?')
+    prs.add_argument('NEW_TAG', nargs='?')
+    prs.add_argument('--suppress-cc', '-s', action="store_true", default=False,
+                     help='Don''t auto-cc anyone (for testing)')
+    return prs
+
+
+def execute(args):
+    ctx = SrtContext(args)
+    check_context(ctx)
+
+    announce(get_config(), ctx, args)

stable_rt_tools/srt_commit.py

@@ -0,0 +1,116 @@
+#!/usr/bin/env python3
+#
+# srt - stable rt tooling
+#
+# Copyright (c) Siemens AG, 2018
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE
+
+
+import re
+import shutil
+import sys
+import tempfile
+
+from stable_rt_tools.srt_util import (cmd, confirm, get_config, get_gnupghome,
+                                      get_last_rt_tag, get_remote_branch_name,
+                                      is_dirty)
+
+
+def localversion_set(filename, version):
+    with open(filename, 'w') as f:
+        f.write(version)
+        f.write('\n')
+
+
+def localversion_inc(filename):
+    with open(filename, 'r+') as f:
+        line = f.readline()
+        version = int(line[3:])
+        f.seek(0)
+        f.write('-rt{0}\n'.format(version+1))
+        f.truncate()
+
+
+def get_kernel_version():
+    tmp = tempfile.mkdtemp()
+    cmd(['make', 'O=%s' % tmp, 'defconfig'])
+    line = cmd(['make', '-s', 'O=%s' % tmp, 'kernelrelease'])
+    shutil.rmtree(tmp)
+    return line.strip()[:-1]
+
+
+def last_commit_was_release_commit():
+    p = re.compile(r'^.*Linux ([0-9\.]+[-a-z0-9]+)( REBASE)*')
+    lines = cmd(['git', 'log', '-1', '--pretty=%B'])
+    for msg in iter(lines.splitlines()):
+        m = p.match(msg)
+        if not m:
+            continue
+        return True
+    return False
+
+
+def commit(config, rc):
+    if is_dirty():
+        print('repo is dirty -> abort', file=sys.stderr)
+        return
+
+    branch_name = get_remote_branch_name()
+    post_fix = branch_name.split('-')[-1]
+    branch_rebase = True if post_fix == 'rebase' else False
+
+    old_head = cmd(['git', 'rev-parse', 'HEAD'])
+
+    if branch_rebase:
+        rt = get_last_rt_tag(branch_name, '-rebase')
+        if last_commit_was_release_commit():
+            cmd(['git', 'reset', 'HEAD~'])
+        localversion_set(config['LOCALVERSION'], rt)
+    elif rc:
+        rt = get_last_rt_tag(branch_name, '-next')
+        rt = rt[3:]
+        rt = int(rt) + 1
+        localversion_set(config['LOCALVERSION'], '-rt{0}-rc{1}'.format(rt, rc))
+    else:
+        localversion_inc(config['LOCALVERSION'])
+
+    version = get_kernel_version()
+    msg = 'Linux {0}'.format(version)
+    if branch_rebase:
+        msg = msg + ' REBASE'
+
+    print('git commit -m {0}'.format(msg))
+    if confirm('OK to commit?'):
+        cmd(['git', 'add', config['LOCALVERSION']])
+        cmd(['git', 'commit', '-s', '-m', msg],
+            env={'GNUPGHOME': get_gnupghome(config)})
+    else:
+        cmd(['git', 'reset', '--hard', old_head])
+
+
+def add_argparser(parser):
+    prs = parser.add_parser('commit')
+    prs.add_argument('--release-candidate', '-r',
+                     default=None, metavar='N', type=int)
+    return prs
+
+
+def execute(args):
+    commit(get_config(), args.release_candidate)

stable_rt_tools/srt_create.py

@@ -0,0 +1,95 @@
+#!/usr/bin/env python3
+#
+# srt - stable rt tooling
+#
+# Copyright (c) Siemens AG, 2018
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE
+
+
+import os
+from logging import debug
+from subprocess import PIPE, Popen
+
+from stable_rt_tools.srt_util import check_context, cmd, get_config
+from stable_rt_tools.srt_util_context import SrtContext
+
+
+def create_patch_file(old_tag, new_tag, filename):
+    with open(filename, 'w') as file:
+        c1 = ['git', 'diff', str(old_tag), str(new_tag)]
+        c2 = ['xz', '-9']
+
+        debug('run: ' + ' '.join(c1) + ' | ' + ' '.join(c2))
+
+        p1 = Popen(c1, stdout=PIPE)
+        p2 = Popen(c2, stdin=p1.stdout, stdout=file)
+        p1.stdout.close()
+        p2.wait()
+
+
+def create_series(old_tag, new_tag, dirname):
+    cmd(['git', 'format-patch', '-q', '-o', dirname,
+         '{0}..{1}'.format(old_tag, new_tag)])
+
+    patches = [f for f in sorted(os.listdir(dirname))
+               if os.path.isfile(os.path.join(dirname, f))]
+    with open(dirname + '/series', 'w') as file:
+        for p in patches:
+            file.write('{0}\n'.format(p))
+
+
+def create_tar_file(dirname, filename):
+    cmd(['tar', '-C', dirname, '-cJf', filename, 'patches/'])
+
+
+def create(config, ctx):
+    for d in [ctx.new_dir_patches, ctx.new_dir_series]:
+        if not os.path.exists(d):
+            os.makedirs(d)
+
+    if ctx.new_tag.is_rc:
+        create_patch_file(ctx.old_tag.base, str(
+            ctx.new_tag), ctx.new_fln_patch)
+        create_series(ctx.old_tag, ctx.new_tag, ctx.new_dir_series)
+    else:
+        create_patch_file(ctx.new_tag.base, str(
+            ctx.new_tag), ctx.new_fln_patch)
+        create_series(ctx.new_tag.base, ctx.new_tag.rebase, ctx.new_dir_series)
+
+    create_tar_file(ctx.new_dir_patches, ctx.new_fln_tar)
+
+    print('Created the following files in {0}'.format(ctx.new_dir_patches))
+    for f in ctx.get_files():
+        print('\t{0}'.format(f))
+    print('Review them')
+
+
+def add_argparser(parser):
+    prs = parser.add_parser('create')
+    prs.add_argument('OLD_TAG', nargs='?')
+    prs.add_argument('NEW_TAG', nargs='?')
+    return prs
+
+
+def execute(args):
+    ctx = SrtContext(args)
+    check_context(ctx)
+
+    create(get_config(), ctx)

stable_rt_tools/srt_git_filter.py

@@ -0,0 +1,41 @@
+#!/usr/bin/env python3
+#
+# srt - stable rt tooling
+#
+# Copyright (c) Siemens AG, 2018
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE
+
+
+import os
+import sys
+
+review_tag = os.environ['SRT_REVIEW_TAG']
+message = sys.stdin.readlines()
+
+msg = """\
+{} stable review patch.
+If anyone has any objections, please let me know.
+
+-----------
+""".format(review_tag)
+
+print(message[0])
+print(msg)
+print(''.join(message[1:]))