laporan-generator 2.6.2 → 2.7.0

package/scripts/report-doctor.py

@@ -2,11 +2,19 @@
 """report-doctor.py: Audit komprehensif kesehatan dan integritas proyek laporan."""
 
 import glob
+import json
 import os
 import re
 import shutil
 import sys
 
+if sys.platform == "win32":
+    try:
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+        sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+    except Exception:
+        pass
+
 GREEN = "\033[0;32m"
 BLUE = "\033[0;34m"
 CYAN = "\033[0;36m"
@@ -98,101 +106,166 @@ def check_style_anomalies(markdown_files):
 
 
 def main():
-    root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-    os.chdir(root)
-
-    print(f"{CYAN}{BOLD}")
-    print("  ========================================================")
-    print("             LAPORAN GENERATOR - DOCTOR & AUDIT SUITE     ")
-    print("  ========================================================")
-    print(f"{NC}")
+    json_mode = "--json" in sys.argv
+    pos_args = [a for a in sys.argv[1:] if not a.startswith("-")]
+
+    target_dir = os.getcwd()
+    if pos_args:
+        target_dir = os.path.abspath(pos_args[0])
+    elif not (os.path.isfile(os.path.join(target_dir, "metadata.yml")) or os.path.isdir(os.path.join(target_dir, "chapters"))):
+        pkg_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+        if os.path.isfile(os.path.join(pkg_root, "metadata.yml")):
+            target_dir = pkg_root
+
+    os.chdir(target_dir)
+
+    if not json_mode:
+        print(f"{CYAN}{BOLD}")
+        print("  ========================================================")
+        print("             LAPORAN GENERATOR - DOCTOR & AUDIT SUITE     ")
+        print("  ========================================================")
+        print(f"{NC}")
 
     errors = 0
     warnings = 0
 
     # 1. Dependensi
-    print(f"  {BLUE}{BOLD}[1/4] Audit Toolchain & Dependensi Sistem{NC}")
+    if not json_mode:
+        print(f"  {BLUE}{BOLD}[1/4] Audit Toolchain & Dependensi Sistem{NC}")
     deps, has_im = check_dependencies()
+    dep_list = []
     for cmd, name, req, found in deps:
         if "ImageMagick" in name:
             continue
-        if found:
-            print(f"    {GREEN}[OK]{NC} {name:<26}: Terpasang ({cmd})")
-        else:
-            if req:
-                print(f"    {RED}[FAIL]{NC} {name:<24}: TIDAK DITEMUKAN (Wajib)")
-                errors += 1
+        dep_list.append({"command": cmd, "name": name, "required": req, "found": found})
+        if not json_mode:
+            if found:
+                print(f"    {GREEN}[OK]{NC} {name:<26}: Terpasang ({cmd})")
             else:
-                print(f"    {YELLOW}[INFO]{NC} {name:<24}: Tidak ditemukan (Opsional)")
+                if req:
+                    print(f"    {RED}[FAIL]{NC} {name:<24}: TIDAK DITEMUKAN (Wajib)")
+                else:
+                    print(f"    {YELLOW}[INFO]{NC} {name:<24}: Tidak ditemukan (Opsional)")
+        if not found and req:
+            errors += 1
 
-    if has_im:
-        print(f"    {GREEN}[OK]{NC} {'ImageMagick':<26}: Terpasang")
-    else:
-        print(f"    {YELLOW}[INFO]{NC} {'ImageMagick':<24}: Tidak ditemukan (Opsional untuk kompresi gambar)")
-    print("")
+    dep_list.append({"command": "magick/convert", "name": "ImageMagick", "required": False, "found": has_im})
+    if not json_mode:
+        if has_im:
+            print(f"    {GREEN}[OK]{NC} {'ImageMagick':<26}: Terpasang")
+        else:
+            print(f"    {YELLOW}[INFO]{NC} {'ImageMagick':<24}: Tidak ditemukan (Opsional untuk kompresi gambar)")
+        print("")
 
     # 2. Berkas & Struktur
-    print(f"  {BLUE}{BOLD}[2/4] Audit Struktur Direktori & Berkas Wajib{NC}")
+    if not json_mode:
+        print(f"  {BLUE}{BOLD}[2/4] Audit Struktur Direktori & Berkas Wajib{NC}")
     req_files = [
         "metadata.yml", "template.typ", "reference.docx",
         "references.bib", "docx.lua", "cover.md"
     ]
+    file_status = []
     for rf in req_files:
-        if os.path.isfile(rf):
-            print(f"    {GREEN}[OK]{NC} Berkas {rf}")
-        else:
-            print(f"    {RED}[FAIL]{NC} Berkas {rf} TIDAK DITEMUKAN")
+        exists = os.path.isfile(rf)
+        file_status.append({"file": rf, "found": exists})
+        if not json_mode:
+            if exists:
+                print(f"    {GREEN}[OK]{NC} Berkas {rf}")
+            else:
+                print(f"    {RED}[FAIL]{NC} Berkas {rf} TIDAK DITEMUKAN")
+        if not exists:
             errors += 1
 
     chapter_files = sorted(glob.glob("chapters/*.md"))
-    if chapter_files:
-        print(f"    {GREEN}[OK]{NC} Direktori chapters/ ({len(chapter_files)} bab ditemukan)")
-    else:
-        print(f"    {RED}[FAIL]{NC} Tidak ada berkas markdown di chapters/")
+    if not json_mode:
+        if chapter_files:
+            print(f"    {GREEN}[OK]{NC} Direktori chapters/ ({len(chapter_files)} bab ditemukan)")
+        else:
+            print(f"    {RED}[FAIL]{NC} Tidak ada berkas markdown di chapters/")
+    if not chapter_files:
         errors += 1
-    print("")
+    if not json_mode:
+        print("")
 
     # 3. Sitasi & Referensi
-    print(f"  {BLUE}{BOLD}[3/4] Audit Sitasi & Integritas Bibliografi{NC}")
+    if not json_mode:
+        print(f"  {BLUE}{BOLD}[3/4] Audit Sitasi & Integritas Bibliografi{NC}")
     bib_keys, cited_keys, missing_keys, orphan_keys = check_citations("references.bib", chapter_files)
-    print(f"    * Total entri .bib     : {len(bib_keys)}")
-    print(f"    * Total sitasi di teks : {len(cited_keys)}")
+    if not json_mode:
+        print(f"    * Total entri .bib     : {len(bib_keys)}")
+        print(f"    * Total sitasi di teks : {len(cited_keys)}")
 
     if missing_keys:
         for k, locs in missing_keys.items():
             loc_str = ", ".join([f"{f}:{l}" for f, l in locs])
-            print(f"    {RED}[ERROR]{NC} Sitasi '@{k}' TIDAK DITEMUKAN di references.bib ({loc_str})")
+            if not json_mode:
+                print(f"    {RED}[ERROR]{NC} Sitasi '@{k}' TIDAK DITEMUKAN di references.bib ({loc_str})")
             errors += 1
-    else:
+    elif not json_mode:
         print(f"    {GREEN}[OK]{NC} Semua sitasi dalam teks valid terdaftar di references.bib")
 
     if orphan_keys:
-        print(f"    {YELLOW}[WARN]{NC} {len(orphan_keys)} entri di references.bib belum disitir dalam teks:")
-        for ok in list(orphan_keys)[:5]:
-            print(f"      - @{ok}")
-        if len(orphan_keys) > 5:
-            print(f"      - ... dan {len(orphan_keys) - 5} lainnya")
+        if not json_mode:
+            print(f"    {YELLOW}[WARN]{NC} {len(orphan_keys)} entri di references.bib belum disitir dalam teks:")
+            for ok in list(orphan_keys)[:5]:
+                print(f"      - @{ok}")
+            if len(orphan_keys) > 5:
+                print(f"      - ... dan {len(orphan_keys) - 5} lainnya")
         warnings += 1
-    print("")
+    if not json_mode:
+        print("")
 
     # 4. Gambar & Format Teks
-    print(f"  {BLUE}{BOLD}[4/4] Audit Media Citra & Anomali Tipografi{NC}")
+    if not json_mode:
+        print(f"  {BLUE}{BOLD}[4/4] Audit Media Citra & Anomali Tipografi{NC}")
     total_imgs, broken_imgs = check_images(chapter_files)
     if broken_imgs:
         for p, f, l in broken_imgs:
-            print(f"    {RED}[ERROR]{NC} Berkas gambar tidak ditemukan: '{p}' (di {f}:{l})")
+            if not json_mode:
+                print(f"    {RED}[ERROR]{NC} Berkas gambar tidak ditemukan: '{p}' (di {f}:{l})")
             errors += 1
-    else:
+    elif not json_mode:
         print(f"    {GREEN}[OK]{NC} Semua tautan gambar ({total_imgs} gambar) valid dan ada di disk")
 
     anomalies = check_style_anomalies(chapter_files)
     if anomalies:
         for f, l, msg in anomalies:
-            print(f"    {YELLOW}[WARN]{NC} {f}:{l} - {msg}")
+            if not json_mode:
+                print(f"    {YELLOW}[WARN]{NC} {f}:{l} - {msg}")
             warnings += 1
-    else:
+    elif not json_mode:
         print(f"    {GREEN}[OK]{NC} Bebas dari manual heading numbering dan box-drawing characters")
-    print("")
+    if not json_mode:
+        print("")
+
+    score = 100 if (errors == 0 and warnings == 0) else (95 if errors == 0 else max(0, 90 - errors * 15 - warnings * 5))
+    status_label = "HEALTHY" if errors == 0 and warnings == 0 else ("WARNING" if errors == 0 else "ERROR")
+
+    if json_mode:
+        result = {
+            "status": status_label,
+            "score": score,
+            "errors_count": errors,
+            "warnings_count": warnings,
+            "target_dir": os.getcwd(),
+            "dependencies": dep_list,
+            "required_files": file_status,
+            "chapters_count": len(chapter_files),
+            "chapters": [os.path.basename(c) for c in chapter_files],
+            "citations": {
+                "bib_count": len(bib_keys),
+                "cited_count": len(cited_keys),
+                "missing_keys": {k: [f"{f}:{l}" for f, l in locs] for k, locs in missing_keys.items()},
+                "orphan_keys": list(orphan_keys),
+            },
+            "images": {
+                "total": total_imgs,
+                "broken": [{"path": p, "file": f, "line": l} for p, f, l in broken_imgs],
+            },
+            "anomalies": [{"file": f, "line": l, "message": msg} for f, l, msg in anomalies],
+        }
+        print(json.dumps(result, indent=2))
+        return 1 if errors > 0 else 0
 
     # Skor Kesehatan
     print("  ========================================================")

package/scripts/report-stats.py

@@ -2,6 +2,7 @@
 """report-stats.py: Menghitung statistik komprehensif dokumen laporan akademik."""
 
 import glob
+import json
 import os
 import re
 import sys
@@ -55,8 +56,18 @@ def count_file_stats(filepath):
 
 
 def main():
-    root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-    os.chdir(root)
+    json_mode = "--json" in sys.argv
+    pos_args = [a for a in sys.argv[1:] if not a.startswith("-")]
+
+    target_dir = os.getcwd()
+    if pos_args:
+        target_dir = os.path.abspath(pos_args[0])
+    elif not (os.path.isfile(os.path.join(target_dir, "metadata.yml")) or os.path.isdir(os.path.join(target_dir, "chapters"))):
+        pkg_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+        if os.path.isfile(os.path.join(pkg_root, "metadata.yml")):
+            target_dir = pkg_root
+
+    os.chdir(target_dir)
 
     title = "Laporan Akademik"
     preset = "standard"
@@ -116,6 +127,39 @@ def main():
         sz = os.path.getsize("Laporan.docx")
         docx_size = f"{sz / 1024:.1f} KB"
 
+    if json_mode:
+        result = {
+            "title": title,
+            "preset": preset,
+            "target_dir": os.getcwd(),
+            "chapters_count": len(chapter_files),
+            "total_words": total_words,
+            "total_chars": total_chars,
+            "est_pages": est_pages,
+            "read_mins": read_mins,
+            "headings": {
+                "h1": total_h1,
+                "h2": total_h2,
+                "h3": total_h3,
+            },
+            "elements": {
+                "images": total_images,
+                "tables": total_tables,
+                "equations": total_equations,
+            },
+            "citations": {
+                "unique_cited": len(all_citations),
+                "bib_entries": bib_count,
+            },
+            "compiled_files": {
+                "pdf": pdf_size,
+                "docx": docx_size,
+            },
+            "file_breakdown": [{"filename": f, "words": c} for f, c in file_breakdown],
+        }
+        print(json.dumps(result, indent=2))
+        return
+
     print(f"{CYAN}{BOLD}")
     print("  ========================================================")
     print("                 LAPORAN GENERATOR - STATISTIK DOKUMEN    ")

package/scripts/test_scripts.py

@@ -1,7 +1,9 @@
 #!/usr/bin/env python3
 """test_scripts.py: Automated unit tests for Laporan Generator Python helper scripts."""
 
+import json
 import os
+import subprocess
 import sys
 import unittest
 
@@ -36,16 +38,39 @@ class TestScanPreset(unittest.TestCase):
         self.assertIn("UNIVERSITAS INDONESIA", inst)
 
 
+def get_presets_dir():
+    for c in [
+        os.path.join(ROOT_DIR, "presets"),
+        os.path.join(ROOT_DIR, "resources", "presets"),
+        os.path.join(ROOT_DIR, "..", "..", "..", "presets"),
+    ]:
+        if os.path.isdir(c):
+            return os.path.abspath(c)
+    return os.path.join(ROOT_DIR, "presets")
+
+
+def get_project_root():
+    for c in [
+        ROOT_DIR,
+        os.path.join(ROOT_DIR, "resources"),
+        os.path.join(ROOT_DIR, "..", "..", ".."),
+    ]:
+        if os.path.isfile(os.path.join(c, "metadata.yml")):
+            return os.path.abspath(c)
+    return ROOT_DIR
+
+
 class TestValidatePreset(unittest.TestCase):
     def test_parse_simple_yaml(self):
-        test_yaml = os.path.join(ROOT_DIR, "presets", "standard.yml")
+        presets_dir = get_presets_dir()
+        test_yaml = os.path.join(presets_dir, "standard.yml")
         self.assertTrue(os.path.exists(test_yaml))
         data = validate_preset.parse_simple_yaml(test_yaml)
         self.assertEqual(data.get("preset_id"), "standard")
         self.assertEqual(data.get("margin_top"), "2cm")
 
     def test_validate_all_presets(self):
-        presets_dir = os.path.join(ROOT_DIR, "presets")
+        presets_dir = get_presets_dir()
         for f in os.listdir(presets_dir):
             if f.endswith(".yml"):
                 path = os.path.join(presets_dir, f)
@@ -128,7 +153,7 @@ report_stats = __import__("report-stats")
 
 class TestReportStats(unittest.TestCase):
     def test_count_file_stats_structure(self):
-        sample_md = os.path.join(ROOT_DIR, "cover.md")
+        sample_md = os.path.join(get_project_root(), "cover.md")
         if os.path.exists(sample_md):
             stats = report_stats.count_file_stats(sample_md)
             self.assertIsInstance(stats, dict)
@@ -136,6 +161,28 @@ class TestReportStats(unittest.TestCase):
             self.assertIsInstance(stats["chars"], int)
             self.assertGreaterEqual(stats["words"], 0)
 
+    def test_json_stats_execution(self):
+        proj_root = get_project_root()
+        cmd = [sys.executable, os.path.join(SCRIPTS_DIR, "report-stats.py"), proj_root, "--json"]
+        proc = subprocess.run(cmd, capture_output=True, text=True, cwd=proj_root)
+        self.assertEqual(proc.returncode, 0)
+        data = json.loads(proc.stdout)
+        self.assertIn("total_words", data)
+        self.assertIn("preset", data)
+        self.assertIn("target_dir", data)
+
+
+class TestReportDoctor(unittest.TestCase):
+    def test_json_doctor_execution(self):
+        proj_root = get_project_root()
+        cmd = [sys.executable, os.path.join(SCRIPTS_DIR, "report-doctor.py"), proj_root, "--json"]
+        proc = subprocess.run(cmd, capture_output=True, text=True, cwd=proj_root)
+        data = json.loads(proc.stdout)
+        self.assertIn("status", data)
+        self.assertIn("dependencies", data)
+        self.assertIn("required_files", data)
+        self.assertIn("citations", data)
+
 
 if __name__ == "__main__":
     unittest.main(verbosity=2)