Merge ~fourdollars/pc-enablement/+git/oem-scripts:master into ~oem-solutions-engineers/pc-enablement/+git/oem-scripts:master

[Shih-Yuan Lee]

[Shih-Yuan Lee (fourdollars)]

[BOT]
$ cat oem-scripts-1.12-5f2b26c-in-docker-focal-summary.log
autopkgtest-collect-credentials PASS
autopkgtest-oem-scripts-auto PASS
pkg-somerville-meta PASS
pkg-stella-meta PASS
pkg-sutton-meta PASS
bootstrap-meta PASS
bug-bind PASS
get-private-ppa PASS
jq-lp PASS
launchpad-api PASS
lp-bug PASS
oem-meta-packages PASS
pkg-list PASS
review-merge-proposal PASS
run-autopkgtest PASS
setup-apt-dir PASS
mir-bug SKIP exit status 77 and marked as skippable
git-url-insteadof-setting PASS
lp-dl-attm PASS
recovery-from-iso.sh PASS
mir-bug-verification PASS
https://paste.ubuntu.com/p/b7GVnfyvkN/ oem-scripts-1.12-5f2b26c-in-docker-focal-complete.log

[Yuan-Chen Cheng (ycheng-twn)]

Well, the code looks fine, however, there are some nice to have change:

1. For get meta pkg name from group and platform name, can we refactor so that it's a function call that can be re-use?

2. for project oem-priority, team name oem-solutions-engineers, ubuntu-desktop, etc, can we start to put those string into const variable, so that the source code editor will tell us we have typo.

I mean something like:

OEM_TEAM = "oem-solutions-engineers"

person=lp.people[OEM_TEAM]

3. "focal" is hardcoded, it will be easier to be changed if it's a variable.

review: Approve

diff --git a/bootstrap-meta b/bootstrap-meta
new file mode 100755
index 0000000..03549a3
--- /dev/null
+++ b/bootstrap-meta
@@ -0,0 +1,420 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# Copyright (C) 2021  Canonical Ltd.
+# Author: Shih-Yuan Lee (FourDollars) <[e-mail]>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+import argparse
+import collections
+import jinja2
+import json
+import oem_scripts
+import re
+
+from copy import copy
+from logging import info, warning, error
+from oem_scripts import SUBSCRIBER_LIST, TAG_LIST, remove_prefix, yes_or_ask
+from oem_scripts.LaunchpadLogin import LaunchpadLogin
+from oem_scripts.logging import setup_logging
+
+
+class BootstrapMeta(object):
+    def __init__(self, platformJson, lp, kernel_meta):
+        self.kernel_meta = kernel_meta
+        self.lp = lp
+        self.json = json.load(platformJson)
+        self.project = self.json["project"]
+        self.group = self.json["group"]
+        self.platform = self.json["platform"]
+
+        if self.json["project"] == "somerville":
+            self.meta = "oem-somerville-" + self.json["platform"] + "-meta"
+        elif self.json["project"] == "stella":
+            self.meta = (
+                "oem-stella."
+                + self.json["group"]
+                + "."
+                + self.json["platform"]
+                + "-meta"
+            )
+        elif self.json["project"] == "sutton":
+            self.meta = (
+                "oem-sutton."
+                + self.json["group"]
+                + "."
+                + self.json["platform"]
+                + "-meta"
+            )
+        else:
+            raise Exception("Not supported")
+
+    def create_bug(self, title, description, importance, status):
+        project = lp.projects["oem-priority"]
+        bug = self.lp.bugs.createBug(
+            description=description,
+            target=project,
+            title=title,
+            information_type="Public",
+            tags=TAG_LIST,
+        )
+        info("meta package public bug: " + bug.web_link)
+
+        for task in bug.bug_tasks:
+            task.status = status
+            task.importance = importance
+            # Assign to reporter by default
+            task.assignee = lp.me
+            task.lp_save()
+
+        # Subscribe the oem-solutions-engineers
+        bug.subscribe(person=lp.people["oem-solutions-engineers"])
+        bug.lp_save()
+
+        return bug
+
+    def _grouping_market_names(self, market_names: list, maxsplit=1) -> str:
+        # Remove empty item
+        while "" in market_names:
+            market_names.remove("")
+        tmp = collections.defaultdict(list)
+        space_in_model = False
+        try:
+            for market_name in sorted(market_names):
+                if maxsplit == 1:
+                    name, model = market_name.split(maxsplit=maxsplit)
+                    tmp[name].append(model)
+                    if " " in model:
+                        space_in_model = True
+                elif maxsplit == 2:
+                    brand, name, model = market_name.split(maxsplit=maxsplit)
+                    tmp[brand + " " + name].append(model)
+                    if " " in model:
+                        space_in_model = True
+        except ValueError:
+            return ", ".join(sorted(market_names))
+
+        if space_in_model:
+            return ", ".join(
+                f"{name} {', '.join(models)}" for name, models in tmp.items()
+            )
+        else:
+            return ", ".join(
+                f"{name} {'/'.join(models)}" for name, models in tmp.items()
+            )
+
+    def parse_market_name(self):
+        if self.project == "somerville":
+            self.market_name = self._grouping_market_names(self.json["productnames"])
+            if not self.market_name.startswith("Dell "):
+                self.market_name = "Dell " + self.market_name
+        elif self.project == "stella":
+            self.market_name = self._grouping_market_names(
+                self.json["productnames"], maxsplit=2
+            )
+            self.market_name = remove_prefix(self.market_name, "HP ")
+            if not self.market_name.startswith("HP "):
+                self.market_name = "HP " + self.market_name
+        elif self.project == "sutton":
+            self.market_name = self._grouping_market_names(self.json["productnames"])
+            if not self.market_name.startswith("Lenovo "):
+                self.market_name = "Lenovo " + self.market_name
+        else:
+            raise Exception("Not supported")
+
+
+class BootstrapMetaMIR(BootstrapMeta):
+    def __init__(self, platformJson, lp, kernel_meta):
+        super().__init__(platformJson, lp, kernel_meta)
+
+    def _read_from_template(self, marketName, oemMetaPackage, kernelMeta):
+        env = jinja2.Environment(
+            loader=jinja2.FileSystemLoader(["./", "/usr/share/oem-scripts"])
+        )
+        template = env.get_template("oem-meta-package.mir.jinja2")
+        return template.render(
+            metaPkgName=self.market_name,
+            branchName=self.branch,
+            oemCodenameNogroup=self.project,
+            deviceName=self.device_name,
+        )
+
+    def create(self):
+        title = f"[DRAFT][MIR] {self.meta}"
+        description = "[DRAFT]" + self._read_from_template()
+        super().create_bug(
+            title, description, importance="Critical", status="Confirmed"
+        )
+
+    def update(self):
+        pass
+
+
+class BootstrapMetaSRU(BootstrapMeta):
+    def __init__(self, platformJson, lp, kernel_meta, output):
+        super().__init__(platformJson, lp, kernel_meta)
+        self.parse_market_name()
+        self.pattern = re.compile(
+            rf".*Update the hardware support for .* in {self.meta}.*"
+        )
+        self.output = output
+
+    def _read_from_template(self):
+        env = jinja2.Environment(
+            loader=jinja2.FileSystemLoader(["./", "/usr/share/oem-scripts"])
+        )
+        template = env.get_template("oem-meta-package.sru.jinja2")
+        return template.render(
+            marketName=self.market_name,
+            oemMetaPackage=self.meta,
+            kernelMeta=self.kernel_meta,
+        )
+
+    def create(self, importance="High", status="Confirmed"):
+        project = lp.projects[f"ubuntu/focal/+source/{self.meta}"]
+        tasks = project.searchTasks()
+        for task in tasks:
+            bug = task.bug
+            if self.pattern.match(bug.title):
+                if self.output:
+                    self.output.write(f"{bug.id}\n")
+                if lp.service_root != "https://api.launchpad.net/":
+                    error(f'{bug.web_link} - "{bug.title}" has been created.')
+                else:
+                    error(f'LP: #{bug.id} - "{bug.title}" has been created.')
+                exit(1)
+        title = (
+            f"[DRAFT] Update the hardware support for {self.market_name} in {self.meta}"
+        )
+        description = "[DRAFT]" + self._read_from_template()
+        bug = super().create_bug(
+            title, description, importance=importance, status=status
+        )
+        if self.output:
+            self.output.write(f"{bug.id}\n")
+        task = bug.addTask(target=lp.projects[f"ubuntu/+source/{self.meta}"])
+        task.status = "Won't Fix"
+        task.lp_save()
+        task = bug.addTask(target=lp.projects[f"ubuntu/focal/+source/{self.meta}"])
+        task.status = status
+        task.importance = importance
+        task.assignee = lp.me
+        task.lp_save()
+
+    def update(self, release=False, ready=False, yes=False):
+        project = lp.projects[f"ubuntu/focal/+source/{self.meta}"]
+        tasks = project.searchTasks()
+        candidate = None
+        for task in tasks:
+            bug = task.bug
+            if self.pattern.match(bug.title):
+                if yes_or_ask(
+                    yes,
+                    f'Do you want to update LP: #{bug.id} - "{bug.title}" for {self.kernel_meta}?',
+                ):
+                    candidate = bug
+
+        if candidate is None:
+            warning("Please use create-sru-bug to create the SRU bug first.")
+            exit(1)
+        else:
+            bug = candidate
+            if self.output:
+                self.output.write(f"{bug.id}\n")
+
+        bug.title = f"Update the hardware support for {self.market_name} in {self.meta}"
+        bug.description = self._read_from_template()
+        bug.lp_save()
+
+        subscriptions = list(map(lambda x: x.person.name, bug.subscriptions))
+        tags = copy(bug.tags)
+        if ready or release:
+            for subscriber in SUBSCRIBER_LIST:
+                if subscriber not in subscriptions:
+                    bug.subscribe(person=lp.people[subscriber])
+        if "oem-solutions-engineers" not in subscriptions:
+            bug.subscribe(person=lp.people["oem-solutions-engineers"])
+        if release:
+            if "oem-done-upload" not in tags:
+                tags.append("oem-done-upload")
+            if "oem-needs-upload" in tags:
+                tags.remove("oem-needs-upload")
+            if "ubuntu-desktop" not in subscriptions:
+                bug.subscribe(person=lp.people["ubuntu-desktop"])
+            if "ubuntu-sponsors" in subscriptions:
+                bug.unsubscribe(person=lp.people["ubuntu-sponsors"])
+            if "ubuntu-sru" not in subscriptions:
+                bug.subscribe(person=lp.people["ubuntu-sru"])
+        elif ready:
+            if "oem-done-upload" in tags:
+                tags.remove("oem-done-upload")
+            if "oem-needs-upload" not in tags:
+                tags.append("oem-needs-upload")
+            if "ubuntu-desktop" not in subscriptions:
+                bug.subscribe(person=lp.people["ubuntu-desktop"])
+            if "ubuntu-sponsors" not in subscriptions:
+                bug.subscribe(person=lp.people["ubuntu-sponsors"])
+            if "ubuntu-sru" in subscriptions:
+                bug.unsubscribe(person=lp.people["ubuntu-sru"])
+        else:
+            if "oem-done-upload" in tags:
+                tags.remove("oem-done-upload")
+            if "oem-needs-upload" in tags:
+                tags.remove("oem-needs-upload")
+            if "ubuntu-desktop" in subscriptions:
+                bug.unsubscribe(person=lp.people["ubuntu-desktop"])
+            if "ubuntu-sponsors" in subscriptions:
+                bug.unsubscribe(person=lp.people["ubuntu-sponsors"])
+            if "ubuntu-sru" in subscriptions:
+                bug.unsubscribe(person=lp.people["ubuntu-sru"])
+        for tag in bug.tags:
+            if tag.startswith("oem-scripts-"):
+                if tag[len("oem-scripts-") :] != oem_scripts.__version__:
+                    tags.remove(tag)
+        for tag in TAG_LIST:
+            if tag not in tags:
+                tags.append(tag)
+        bug.tags = tags
+        bug.lp_save()
+
+        for task in bug.bug_tasks:
+            if (
+                task.bug_target_name == "oem-priority"
+                or task.bug_target_name == "oem-somerville-varys-meta (Ubuntu Focal)"
+            ):
+                if release:
+                    task.status = "In Progress"
+                elif ready:
+                    task.status = "Triaged"
+                else:
+                    task.status = "Confirmed"
+            elif task.bug_target_name == "oem-somerville-varys-meta (Ubuntu)":
+                task.status = "Won't Fix"
+            task.lp_save()
+
+        if lp.service_root != "https://api.launchpad.net/":
+            info(f'{bug.web_link} - "{bug.title}" has been updated.')
+        else:
+            info(f'LP: #{bug.id} - "{bug.title}" has been updated.')
+
+
+parser = argparse.ArgumentParser(
+    formatter_class=argparse.RawDescriptionHelpFormatter,
+    epilog="""
+examples:
+    bootstrap-meta create-mir-bug platformJSON [WIP]
+    bootstrap-meta update-mir-bug platformJSON [WIP]
+    bootstrap-meta update-mir-git platformJSON [WIP]
+    bootstrap-meta create-sru-bug platformJSON [--kernel linux-generic-hwe-20.04]
+    bootstrap-meta update-sru-bug platformJSON [--kernel linux-generic-hwe-20.04] [--yes] [--ready|--release]
+    bootstrap-meta update-sru-git platformJSON [WIP]""",
+)
+
+parser.add_argument("-d", "--debug", help="print debug messages", action="store_true")
+parser.add_argument(
+    "-q", "--quiet", help="Don't print info messages", action="store_true"
+)
+
+subparsers = parser.add_subparsers(dest="subcommand")
+
+create_mir_bug = subparsers.add_parser("create-mir-bug", help="[-h] platformJSON")
+create_mir_bug.add_argument(
+    "json",
+    help="Specify the platform json of the OEM metapackage.",
+    type=argparse.FileType("r", encoding="UTF-8"),
+)
+
+update_mir_bug = subparsers.add_parser("update-mir-bug", help="[-h] platformJSON")
+update_mir_bug.add_argument(
+    "json",
+    help="Specify the platform json of the OEM metapackage.",
+    type=argparse.FileType("r", encoding="UTF-8"),
+)
+
+create_sru_bug = subparsers.add_parser("create-sru-bug", help="[-h] platformJSON")
+create_sru_bug.add_argument(
+    "json",
+    help="Specify the platform json of the OEM metapackage in Ubuntu archive.",
+    type=argparse.FileType("r", encoding="UTF-8"),
+)
+create_sru_bug.add_argument(
+    "--kernel",
+    default="linux-generic-hwe-20.04",
+    help="Specify the kernel meta of the OEM metapackage that is targeting on.",
+)
+create_sru_bug.add_argument(
+    "-o",
+    "--output",
+    help="Specify a file name to write the bug number.",
+    type=argparse.FileType("w", encoding="UTF-8"),
+)
+
+update_sru_bug = subparsers.add_parser(
+    "update-sru-bug",
+    help="[-h] platformJSON [--kernel linux-generic-hwe-20.04] [--yes] [--ready|--release]",
+)
+update_sru_bug.add_argument(
+    "json",
+    help="Specify the platform json of the OEM metapackage in Ubuntu archive.",
+    type=argparse.FileType("r", encoding="UTF-8"),
+)
+update_sru_bug.add_argument(
+    "--kernel",
+    default="linux-generic-hwe-20.04",
+    help="Specify the kernel meta of the OEM metapackage that is targeting on.",
+)
+update_sru_bug.add_argument(
+    "--release",
+    action="store_true",
+    help="Update the bug when the OEM metapackage has been uploaded into the queue for releasing.",
+)
+update_sru_bug.add_argument(
+    "--ready",
+    action="store_true",
+    help="Update the bug when the OEM metapackage is ready to upload.",
+)
+update_sru_bug.add_argument(
+    "--yes", help="Say yes for all prompts.", action="store_true"
+)
+update_sru_bug.add_argument(
+    "-o",
+    "--output",
+    help="Specify a file name to write the bug number.",
+    type=argparse.FileType("w", encoding="UTF-8"),
+)
+
+args = parser.parse_args()
+setup_logging(debug=args.debug, quiet=args.quiet)
+
+if args.subcommand:
+    login = LaunchpadLogin()
+    lp = login.lp
+    lp.service_root = login.service_root
+    lp.service_version = login.service_version
+
+# if args.subcommand == "create-mir-bug":
+#     mirbug = BootstrapMetaMIR(args.json, lp, args.kernel)
+#     mirbug.create()
+# elif args.subcommand == "update-mir-bug":
+#     mirbug = BootstrapMetaMIR(args.json, lp, args.kernel)
+#     mirbug.update()
+if args.subcommand == "create-sru-bug":
+    srubug = BootstrapMetaSRU(args.json, lp, args.kernel, args.output)
+    srubug.create()
+elif args.subcommand == "update-sru-bug":
+    srubug = BootstrapMetaSRU(args.json, lp, args.kernel, args.output)
+    srubug.update(release=args.release, ready=args.ready, yes=args.yes)
+else:
+    parser.print_help()
diff --git a/debian/changelog b/debian/changelog
index 4896fc6..6ef7544 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,17 @@
+oem-scripts (1.12) UNRELEASED; urgency=medium
+
+  * bootstrap-meta,
+    debian/tests/bootstrap-meta,
+    debian/tests/control,
+    mir-bug,
+    oem-meta-package.sru.jinja2,
+    oem_scripts/LaunchpadLogin.py,
+    oem_scripts/__init__.py,
+    setup.py: Add the bootstrap-meta tool to deal with OEM metapackages SRU
+    bugs.
+
+ -- Shih-Yuan Lee (FourDollars) <[e-mail]>  Thu, 02 Sep 2021 14:55:10 +0800
+
 oem-scripts (1.11) focal; urgency=medium
 
   * debian/control,
diff --git a/debian/tests/bootstrap-meta b/debian/tests/bootstrap-meta
new file mode 100644
index 0000000..f0ec33f
--- /dev/null
+++ b/debian/tests/bootstrap-meta
@@ -0,0 +1,58 @@
+#!/bin/bash
+
+set -euo pipefail
+IFS=$'\n\t'
+
+export LAUNCHPAD_API="https://api.staging.launchpad.net/"
+
+cat > fossa-varys.json <<ENDLINE
+{
+  "group": "",
+  "platform": "varys",
+  "productnames": [
+    "Precision 5550"
+  ],
+  "project": "somerville"
+}
+ENDLINE
+
+cleanup() {
+    echo "= cleanup ="
+    if [ -f "bugid" ]; then
+        BUG_ID=$(cat bugid)
+        rm bugid
+    fi
+    if [ -f "$BUG_ID.json" ]; then
+        jq -C -S < "$BUG_ID.json"
+        rm "$BUG_ID.json"
+        lp-bug cleanup --yes "$BUG_ID"
+    fi
+}
+
+trap cleanup EXIT INT TERM
+
+bootstrap-meta create-sru-bug fossa-varys.json --kernel linux-oem-20.04 --output bugid
+BUG_ID=$(cat bugid)
+launchpad-api get "bugs/$BUG_ID" > "$BUG_ID.json"
+jq -r .description < "$BUG_ID.json" | grep "Precision 5550"
+jq -r .description < "$BUG_ID.json" | grep linux-oem-20.04
+jq -r '.tags|join(" ")' < "$BUG_ID.json" | grep oem-meta-packages
+
+if bootstrap-meta create-sru-bug fossa-varys.json --kernel linux-oem-20.04 --output bugid; then
+    echo "It is expected to return failed."
+    exit 1
+fi
+
+bootstrap-meta update-sru-bug fossa-varys.json --kernel linux-oem-20.04b --yes
+launchpad-api get "bugs/$BUG_ID" > "$BUG_ID.json"
+jq -r .description < "$BUG_ID.json" | grep linux-oem-20.04b
+
+bootstrap-meta update-sru-bug fossa-varys.json --kernel linux-oem-20.04c --yes --ready
+launchpad-api get "bugs/$BUG_ID" > "$BUG_ID.json"
+jq -r .description < "$BUG_ID.json" | grep linux-oem-20.04c
+jq -r '.tags|join(" ")' < "$BUG_ID.json" | grep oem-needs-upload
+
+bootstrap-meta update-sru-bug fossa-varys.json --kernel linux-oem-20.04d --yes --release
+launchpad-api get "bugs/$BUG_ID" > "$BUG_ID.json"
+jq -r .description < "$BUG_ID.json" | grep linux-oem-20.04d
+jq -r '.tags|join(" ")' < "$BUG_ID.json" | grep oem-done-upload
diff --git a/debian/tests/control b/debian/tests/control
index 1f9da74..a9a549d 100644
--- a/debian/tests/control
+++ b/debian/tests/control
@@ -10,6 +10,7 @@ Tests:
 Depends: @, ubuntu-dev-tools, git-buildpackage
 
 Tests:
+ bootstrap-meta,
  bug-bind,
  get-private-ppa,
  jq-lp,
diff --git a/mir-bug b/mir-bug
index d90e130..be49cb3 100755
--- a/mir-bug
+++ b/mir-bug
@@ -33,23 +33,17 @@ import subprocess
 from copy import copy
 from glob import glob
 from logging import debug, info, warning, error, critical
+from oem_scripts import (
+    SUBSCRIBER_LIST,
+    TAG_LIST,
+    ALLOWED_KERNEL_META_LIST,
+    remove_prefix,
+    yes_or_ask,
+)
 from oem_scripts.LaunchpadLogin import LaunchpadLogin
 from oem_scripts.logging import setup_logging
 from tempfile import TemporaryDirectory
 
-ALLOWED_KERNEL_META_LIST = (
-    "linux-oem-20.04c",
-    "linux-oem-20.04b",
-    "linux-oem-20.04",
-    "linux-generic-hwe-20.04",
-)
-SUBSCRIBER_LIST = ("oem-solutions-engineers", "ubuntu-sponsors", "ubuntu-desktop")
-TAG_LIST = [
-    "oem-meta-packages",
-    "oem-priority",
-    f"oem-scripts-{oem_scripts.__version__}",
-]
-
 parser = argparse.ArgumentParser(
     formatter_class=argparse.RawDescriptionHelpFormatter,
     epilog="""
@@ -154,11 +148,6 @@ setup_logging(debug=args.debug, quiet=args.quiet)
 pattern = re.compile(r".*\[MIR\]\W*oem-([^-]*)-(.*)-meta\W*")
 
 
-# Python 3.9 supports this.
-def remove_prefix(s, prefix):
-    return s[len(prefix) :] if s.startswith(prefix) else s
-
-
 def _grouping_market_names(market_names: list, maxsplit=1) -> str:
     # Remove empty item
     while "" in market_names:
@@ -345,20 +334,6 @@ def collect_bugs(lp, output):
     output.write("\n")
 
 
-def yes_or_ask(yes: bool, message: str) -> bool:
-    if yes:
-        print(f"> \033[1;34m{message}\033[1;0m (y/n) y")
-        return True
-    while True:
-        res = input(f"> \033[1;34m{message}\033[1;0m (y/n) ").lower()
-        if res not in {"y", "n"}:
-            continue
-        if res == "y":
-            return True
-        else:
-            return False
-
-
 def update_bug(
     lp,
     bug_number: int,
@@ -713,11 +688,7 @@ def check_and_update_bug_subscriptions(lp, bug, update=False, yes=False) -> bool
                     else:
                         result = False
     if args.ready:
-        for subscriber in (
-            "oem-solutions-engineers",
-            "ubuntu-sponsors",
-            "ubuntu-desktop",
-        ):
+        for subscriber in SUBSCRIBER_LIST:
             if subscriber not in subscriptions:
                 error(f"'{subscriber}' is not in the subscriptions.")
                 if update and yes_or_ask(
diff --git a/oem-meta-package.sru.jinja2 b/oem-meta-package.sru.jinja2
new file mode 100644
index 0000000..88f8661
--- /dev/null
+++ b/oem-meta-package.sru.jinja2
@@ -0,0 +1,24 @@
+[Impact]
+
+ * It should have no impact at all because these changes shall have been applied and verified in the corresponding OEM archive before this SRU process.
+
+[Test Plan]
+
+* Install Ubuntu 20.04.x LTS on {{ marketName }} and remove {{ oemMetaPackage }} manually if any.
+
+ * Enable focal-proposed and execute the update-manager.
+
+ * The update-manager should show "Hardware support for {{ marketName }}". If not, please change "When there are security updates" and "When there are other updates" in the Updates of software-properties-gtk to "Display immediately", install the older firefox by `sudo apt install firefox=75.0+build3-0ubuntu1` and reboot the system to wait for the update-manager pop up automatically.
+
+ * After it installed {{ oemMetaPackage }} by update-manager and reboot the system, you should see the system booting from the {{ kernelMeta }} kernel.
+
+[Where problems could occur]
+
+ * {{ oemMetaPackage }} is installed but it is not updated to the version in the corresponding OEM archive.
+
+ * The update-manager didn't show "Hardware support for {{ marketName }}" at all.
+
+[Other Info]
+
+ * You can see all {{ oemMetaPackage }} versions on https://people.ubuntu.com/~fourdollars/oem-meta-packages/.
+ * I have used ppa:oem-solutions-engineers/oem-projects-meta to verify it before this SRU process.
diff --git a/oem_scripts/LaunchpadLogin.py b/oem_scripts/LaunchpadLogin.py
index 01bae8b..d2fa68e 100644
--- a/oem_scripts/LaunchpadLogin.py
+++ b/oem_scripts/LaunchpadLogin.py
@@ -67,6 +67,9 @@ class LaunchpadLogin:
             else:
                 service_root = "production"
 
+        self.service_root = lookup_service_root(service_root)
+        self.service_version = version
+
         oem_scripts_config_ini = os.path.join(
             os.environ["HOME"], ".config/oem-scripts/config.ini"
         )
diff --git a/oem_scripts/__init__.py b/oem_scripts/__init__.py
index 2bfacd2..4052759 100644
--- a/oem_scripts/__init__.py
+++ b/oem_scripts/__init__.py
@@ -1 +1,31 @@
 __version__ = "1.11"
+
+ALLOWED_KERNEL_META_LIST = (
+    "linux-oem-20.04c",
+    "linux-oem-20.04b",
+    "linux-oem-20.04",
+    "linux-generic-hwe-20.04",
+)
+
+SUBSCRIBER_LIST = ("oem-solutions-engineers", "ubuntu-sponsors", "ubuntu-desktop")
+
+TAG_LIST = ["oem-meta-packages", "oem-priority", f"oem-scripts-{__version__}"]
+
+
+# Python 3.9 supports this.
+def remove_prefix(s, prefix):
+    return s[len(prefix) :] if s.startswith(prefix) else s
+
+
+def yes_or_ask(yes: bool, message: str) -> bool:
+    if yes:
+        print(f"> \033[1;34m{message}\033[1;0m (y/n) y")
+        return True
+    while True:
+        res = input(f"> \033[1;34m{message}\033[1;0m (y/n) ").lower()
+        if res not in {"y", "n"}:
+            continue
+        if res == "y":
+            return True
+        else:
+            return False
diff --git a/setup.py b/setup.py
index 81004d7..ace90b3 100644
--- a/setup.py
+++ b/setup.py
@@ -34,6 +34,7 @@ Also there is a meta package oem-dev-tools that installs all scripts""",
     author="Commercial Engineering",
     author_email="[e-mail]",
     scripts=[
+        "bootstrap-meta",
         "copyPackage.py",
         "get-oem-auth-token",
         "get-oemshare-auth-token",