package_release: refactoring

Improve readability of package_release.py and its submodule generate_release_metadata.py.

• Add describing comments throughout the file.
• Remove duplicate code from functions. Simplify them, so that they do what their names say (and nothing more).
• Rename variables and function arguments to make their purpose clearer.
• Harmonize variable names with their corresponding command line arguments.
• Add pydoc for functions.
• Add type declarations to function arguments.
• Generate MD5 and metadata files in the source directories so that they can be copied along with the rest of the files.
• Make output-dir an argument that can be passed multiple times instead of hard-coding two dirs with certain meanings.
• Remove LOCALDIR variable from package.env, because it is not used anywhere (only occurence was job class ".uploadsdkftp" which wasn't used anywhere either).

scripts/package_release.py

@@ -29,9 +29,9 @@ def generate_md5sums_file(input_files: list[str], output_file: str):
     md5sums = {}
     for f in input_files:
         md5sums[os.path.basename(f)] = md5(f)
-    dir = os.path.dirname(output_file)
-    if dir:
-        os.makedirs(dir, exist_ok=True)
+    output_dir = os.path.dirname(output_file)
+    if output_dir:
+        os.makedirs(output_dir, exist_ok=True)
     with open(output_file, "w", encoding="utf-8") as f_md5:
         for f, h in md5sums.items():
             f_md5.write("{}  {}\n".format(h, f))