From 830224067216bd8064bea373787aeb089b92e660 Mon Sep 17 00:00:00 2001
From: Pieter-Jan Briers <pieterjan.briers+git@gmail.com>
Date: Sun, 14 Jan 2024 01:16:37 +0100
Subject: [PATCH] Make changelog script able to manage admin changelogs
 (#24033)

* Make changelog script able to manage admin changelogs

* I forgot to remove the comment

* Yeah that should probably just be an exclusion instead.
---
 Resources/Changelog/Parts/parts_here.txt |  2 ++
 Tools/update_changelog.py                | 21 ++++++++++++++++++---
 2 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/Resources/Changelog/Parts/parts_here.txt b/Resources/Changelog/Parts/parts_here.txt
index 0cd4a0cc29..b794003750 100644
--- a/Resources/Changelog/Parts/parts_here.txt
+++ b/Resources/Changelog/Parts/parts_here.txt
@@ -1,6 +1,8 @@
 The part YAML takes the following format:
 
 author: Your_Name_Here
+category: Admin # if left out, falls under the main changelog
 changes:
   - type: Fix # One of the following: Add, Remove, Tweak, Fix
     message: Your change here!
+
diff --git a/Tools/update_changelog.py b/Tools/update_changelog.py
index 53f6d88754..04a35bb45f 100755
--- a/Tools/update_changelog.py
+++ b/Tools/update_changelog.py
@@ -12,6 +12,7 @@ MAX_ENTRIES = 500
 HEADER_RE = r"(?::cl:|🆑) *\r?\n(.+)$"
 ENTRY_RE = r"^ *[*-]? *(\S[^\n\r]+)\r?$"
 
+CATEGORY_MAIN = "Main"
 
 # From https://stackoverflow.com/a/37958106/4678631
 class NoDatesSafeLoader(yaml.SafeLoader):
@@ -33,9 +34,12 @@ def main():
     parser = argparse.ArgumentParser()
     parser.add_argument("changelog_file")
     parser.add_argument("parts_dir")
+    parser.add_argument("--category", default=CATEGORY_MAIN)
 
     args = parser.parse_args()
 
+    category = args.category
+
     with open(args.changelog_file, "r", encoding="utf-8-sig") as f:
         current_data = yaml.load(f, Loader=NoDatesSafeLoader)
 
@@ -54,7 +58,13 @@ def main():
         partpath = os.path.join(args.parts_dir, partname)
         print(partpath)
 
-        partyaml = yaml.load(open(partpath, "r", encoding="utf-8-sig"), Loader=NoDatesSafeLoader)
+        with open(partpath, "r", encoding="utf-8-sig") as f:
+            partyaml = yaml.load(f, Loader=NoDatesSafeLoader)
+
+        part_category = partyaml.get("category", CATEGORY_MAIN)
+        if part_category != category:
+            print(f"Skipping: wrong category ({part_category} vs {category})")
+            continue
 
         author = partyaml["author"]
         time = partyaml.get(
@@ -86,8 +96,13 @@ def main():
         print(f"Removing {overflow} old entries.")
         entries_list = entries_list[overflow:]
 
-    with open(args.changelog_file, "w") as f:
-        yaml.safe_dump({"Entries": entries_list}, f)
+    new_data = {"Entries": entries_list}
+    for key, value in current_data.items():
+        if key != "Entries":
+            new_data[key] = value
+
+    with open(args.changelog_file, "w", encoding="utf-8-sig") as f:
+        yaml.safe_dump(new_data, f)
 
 
 main()
-- 
2.51.2