test: type packagelib

Useful when working on integration tests and wanting to quickly see the
required types for `createPackage`.

Author: jelly

test/common/packagelib.py

@@ -138,8 +138,9 @@ def setUp(self):
     # Helper functions for creating packages/repository
     #
 
-    def createPackage(self, name, version, release, install=False,
-                      postinst=None, depends="", content=None, arch=None, provides=None, **updateinfo):
+    def createPackage(self, name: str, version: str, release: str, *, install: bool = False,
+                      postinst: str | None = None, depends: str = "", content: dict[str, dict[str, str] | str] | None = None,
+                      arch: str | None = None, provides: str | None = None, **updateinfo: str) -> None:
         """Create a dummy package in repo_dir on self.machine
 
         If install is True, install the package. Otherwise, update the package
@@ -151,15 +152,16 @@ def createPackage(self, name, version, release, install=False,
             provides = ""
 
         if self.backend == "apt":
-            self.createDeb(name, version + '-' + release, depends, postinst, install, content, arch, provides)
+            self.createDeb(name, version + '-' + release, depends, postinst, install=install, content=content, arch=arch, provides=provides)
         elif self.backend == "alpm":
-            self.createPacmanPkg(name, version, release, depends, postinst, install, content, arch, provides)
+            self.createPacmanPkg(name, version, release, depends, postinst, install=install, content=content, arch=arch, provides=provides)
         else:
-            self.createRpm(name, version, release, depends, postinst, install, content, arch, provides)
+            self.createRpm(name, version, release, depends, postinst, install=install, content=content, arch=arch, provides=provides)
         if updateinfo:
             self.updateInfo[name, version, release] = updateinfo
 
-    def createDeb(self, name, version, depends, postinst, install, content, arch, provides):
+    def createDeb(self, name: str, version: str, depends: str, postinst: str | None = None, *, install: bool,
+                  content: dict[str, dict[str, str] | str] | None = None, arch: str | None = None, provides: str | None = None) -> None:
         """Create a dummy deb in repo_dir on self.machine
 
         If install is True, install the package. Otherwise, update the package
@@ -206,7 +208,8 @@ def createDeb(self, name, version, depends, postinst, install, content, arch, pr
         m.execute(cmd)
         self.addCleanup(m.execute, f"dpkg -P --force-depends --force-remove-reinstreq {name} 2>/dev/null || true")
 
-    def createRpm(self, name, version, release, requires, post, install, content, arch, provides):
+    def createRpm(self, name: str, version: str, release: str, requires: str, post: str | None = None, *, install: bool,
+                  content: dict[str, dict[str, str] | str] | None = None, arch: str | None = None, provides: str | None = None) -> None:
         """Create a dummy rpm in repo_dir on self.machine
 
         If install is True, install the package. Otherwise, update the package
@@ -267,7 +270,8 @@ def createRpm(self, name, version, release, requires, post, install, content, ar
         self.machine.execute(cmd.format(self.repo_dir, name, version, release, arch))
         self.addCleanup(self.machine.execute, f"rpm -e --nodeps {name} 2>/dev/null || true")
 
-    def createPacmanPkg(self, name, version, release, requires, postinst, install, content, arch, provides):
+    def createPacmanPkg(self, name: str, version: str, release: str, requires: str, postinst: str | None = None, *, install: bool,
+                        content: dict[str, dict[str, str] | str] | None = None, arch: str | None = None, provides: str | None = None) -> None:
         """Create a dummy pacman package in repo_dir on self.machine
 
         If install is True, install the package. Otherwise, update the package
@@ -348,7 +352,7 @@ def createPacmanPkg(self, name, version, release, requires, postinst, install, c
         self.machine.execute(cmd)
         self.addCleanup(self.machine.execute, f"pacman -Rdd --noconfirm {name} 2>/dev/null || true")
 
-    def createAptChangelogs(self):
+    def createAptChangelogs(self) -> None:
         # apt metadata has no formal field for bugs/CVEs, they are parsed from the changelog
         for ((pkg, ver, rel), info) in self.updateInfo.items():
             changes = info.get("changes", "some changes")
@@ -366,7 +370,7 @@ def createAptChangelogs(self):
 """
             self.machine.execute(f"mkdir -p $(dirname {path}); echo '{contents}' > {path}")
 
-    def createYumUpdateInfo(self):
+    def createYumUpdateInfo(self) -> str:
         xml = '<?xml version="1.0" encoding="UTF-8"?>\n<updates>\n'
         for ((pkg, ver, rel), info) in self.updateInfo.items():
             refs = ""
@@ -402,10 +406,10 @@ def createYumUpdateInfo(self):
         xml += '</updates>\n'
         return xml
 
-    def addPackageSet(self, name):
+    def addPackageSet(self, name: str) -> None:
         self.machine.execute(f"mkdir -p {self.repo_dir}; cp /var/lib/package-sets/{name}/* {self.repo_dir}")
 
-    def enableRepo(self):
+    def enableRepo(self) -> None:
         if self.backend == "apt":
             self.createAptChangelogs()
             self.machine.execute(f"""echo 'deb [trusted=yes] file://{self.repo_dir} /' > /etc/apt/sources.list.d/test.list