refactor(dx): add justfile, use absolute paths from sitemap script

Signed-off-by: Victor Adossi <vadossi@cosmonic.com>

Author: vados-cosmonic

justfile

@@ -0,0 +1,19 @@
+just := env_var_or_default("JUST", "just")
+just_dir := env_var_or_default("JUST_DIR", justfile_directory())
+
+python := env_var_or_default("PYTHON", "python3")
+cargo := env_var_or_default("CARGO", "cargo")
+
+publish_domain := env_var_or_default("PUBLISH_DOMAIN", "component-model.bytecodealliance.org")
+
+scripts_dir := env_var_or_default("SCRIPTS_DIR", "scripts")
+
+sitemap_output_path := absolute_path("./component-model/book/html/sitemap.xml")
+
+@_default:
+    {{just}} --list
+
+# Build the sitemap
+@build-sitemap:
+      {{python}} {{scripts_dir}}/generate_sitemap.py --domain "{{publish_domain}}" --higher-priority "design" --output-path {{sitemap_output_path}}
+

scripts/generate_sitemap.py

@@ -1,11 +1,13 @@
 import os
 from urllib.parse import urljoin
 from datetime import datetime
+from pathlib import Path
+
 import argparse
 
-def parse_summary():
+def parse_summary(summary_file_path):
     """Parse URLs from the SUMMARY.md file."""
-    with open("../../src/SUMMARY.md", "r") as file:
+    with open(summary_file_path, "r") as file:
         for line in file:
             if "](" in line:
                 url = line.split("](")[1].split(")")[0]
@@ -23,10 +25,10 @@ def determine_priority(url_path, higher_priority_section):
     else:
         return "0.5"  # All other pages
 
-def generate_sitemap(domain, output_path, higher_priority_section):
+def generate_sitemap(domain, output_path, summary_file_path, higher_priority_section):
     """Generate a sitemap XML file from SUMMARY.md structure."""
     domain = "https://" + domain
-    urls = parse_summary()  # Add base URL to the list of URLs
+    urls = parse_summary(summary_file_path)  # Add base URL to the list of URLs
     urls = [""] + list(urls)
 
     sitemap = '<?xml version="1.0" encoding="UTF-8"?>\n'
@@ -48,11 +50,23 @@ def generate_sitemap(domain, output_path, higher_priority_section):
     with open(output_path, "w") as file:
         file.write(sitemap)
 
+DEFAULT_SUMMARY_MD_PATH = (Path(__file__).parent / "../component-model/src/SUMMARY.md").resolve()
+DEFAULT_SITEMAP_XML_PATH = (Path(__file__).parent / "../component-model/book/html/sitemap.sml").resolve()
+
 if __name__ == "__main__":
     parser = argparse.ArgumentParser(description="Generate a sitemap for mdBook")
-    parser.add_argument("-d", "--domain", required=True, help="Domain for the mdBook site (e.g., component-model.bytecodealliance.org)")
-    parser.add_argument("-o", "--output-path", default="sitemap.xml", help="Output path for the sitemap file")
+    parser.add_argument("-d", "--domain", required=True, help="Domain for the mdBook site (e.g., 'component-model.bytecodealliance.org')")
+    parser.add_argument("-o", "--output-path", default=DEFAULT_SITEMAP_XML_PATH, help="Output path for the sitemap file")
+    parser.add_argument("-s", "--summary-md-path", default=DEFAULT_SUMMARY_MD_PATH, help="Path to SUMMARY.md")
     parser.add_argument("-p", "--higher-priority", help="Subsection path (e.g., 'design') to assign a higher priority of 0.8")
     args = parser.parse_args()
 
-    generate_sitemap(args.domain, args.output_path, args.higher_priority)
+    summary_file_path = Path(args.summary_md_path).resolve()
+    if not summary_file_path.exists():
+        raise FileNotFoundError(f"failed to find summary file [{summary_file_path}]")
+
+    output_path = Path(args.output_path).resolve()
+    if not output_path.parent.exists():
+        raise FileNotFoundError(f"failed to find output dir [{output_path.parent}]")
+
+    generate_sitemap(args.domain, output_path, summary_file_path, args.higher_priority)