chore: improve output log for build spec gen

Author: Trong Nhan Mai

src/macaron/__main__.py

@@ -276,7 +276,7 @@ def gen_build_spec(gen_build_spec_args: argparse.Namespace) -> int:
         logger.error("Error while generate reproducible central build spec.")
         return os.EX_DATAERR
 
-    logger.debug(build_spec_content)
+    logger.debug("Build spec content: \n%s", build_spec_content)
     build_spec_filepath = os.path.join(global_config.output_path, "macaron.buildspec")
     try:
         with open(build_spec_filepath, mode="w", encoding="utf-8") as file:

src/macaron/build_spec_generator/jdk_finder.py

@@ -126,8 +126,14 @@ def get_jdk_version_from_jar(artifact_path: str) -> str | None:
             for line in manifest_content.splitlines():
                 if "Build-Jdk" in line or "Build-Jdk-Spec" in line:
                     _, _, version = line.rpartition(":")
+                    logger.debug(
+                        "Found JDK version %s from java artifact at %s",
+                        version.strip(),
+                        artifact_path,
+                    )
                     return version.strip()
 
+            logger.debug("Cannot find any JDK version from java artifact at %s", artifact_path)
             return None
 
 
@@ -175,7 +181,10 @@ def find_jdk_version_from_remote_maven_repo_standalone(
         remote_maven_repo_url,
         maven_repository_path,
     )
-
+    logger.debug(
+        "Find JDK version from jar at %s, using temporary file.",
+        artifact_url,
+    )
     with tempfile.TemporaryDirectory() as temp_dir_name:
         local_artifact_path = os.path.join(temp_dir_name, asset_name)
         try:
@@ -253,6 +262,11 @@ def find_jdk_version_from_remote_maven_repo_cache(
         remote_maven_repo_url,
         maven_repository_path,
     )
+    logger.debug(
+        "Find JDK version from jar at %s, using cache %s",
+        artifact_url,
+        local_artifact_path,
+    )
     try:
         download_file(
             artifact_url,

src/macaron/build_spec_generator/macaron_db_extractor.py

@@ -119,6 +119,9 @@ def lookup_one_or_none(
 def compile_sqlite_select_statement(select_statment: Select) -> str:
     """Return the equivalent SQLite SELECT statement from an SQLAlchemy SELECT statement.
 
+    This function also introduces additional cosmetic details so that it can be easily
+    read from the log.
+
     Parameters
     ----------
     select_statement : Select
@@ -129,11 +132,11 @@ def compile_sqlite_select_statement(select_statment: Select) -> str:
     str
         The equivalent SQLite SELECT statement as a string.
     """
-    sqlite_str = select_statment.compile(
+    compiled_sqlite = select_statment.compile(
         dialect=sqlite.dialect(),  # type: ignore
         compile_kwargs={"literal_binds": True},
     )
-    return str(sqlite_str)
+    return f"\n----- Begin SQLite query \n{str(compiled_sqlite)}\n----- End SQLite query\n"
 
 
 def get_sql_stmt_latest_component_for_purl(purl: PackageURL) -> Select[tuple[Component]]: