The definitive list of the best of (consumer facing) open source.
Added comments and cleaned up python source code
Lucas119f95a492a2
diff --git a/core/source/generation/readme_generator.py b/core/source/generation/readme_generator.pyindex e4d9ce6..ca5033a 100644--- a/core/source/generation/readme_generator.py+++ b/core/source/generation/readme_generator.py@@ -1,8 +1,7 @@-from tableofcontents_generator import generate_table_of_contentsfrom contents_generator import generate_contentsfrom mainheader_generator import generate_mainheader+from tableofcontents_generator import generate_table_of_contents-# List of target platformsplatforms = ["all", "windows", "macos", "linux", "selfhost"]# Platforms mapped to corresponding header files@@ -19,27 +18,22 @@ def generate_readme_for_platform(platform):content = ""header_file = header_files.get(platform, "core/components/header.md")- # Inject mainheader with dynamic project count+ # Inject every component of the list from top to bottomif platform == "all":content += generate_mainheader()- # Inject headerwith open(header_file, "r", encoding="utf-8") as f:content += f.read() + "\n"- # Inject tags.mdwith open("core/components/tags.md", "r", encoding="utf-8") as f:content += f.read() + "\n"- # Generate Table of Contentstoc_md = generate_table_of_contents()content += toc_md + "\n"- # Generate the actual markdown list of contents for the given platformcontents_md = generate_contents(platform)content += contents_md + "\n"- # Inject footer.mdwith open("core/components/footer.md", "r", encoding="utf-8") as f:content += f.read() + "\n"diff --git a/core/source/generation/tableofcontents_generator.py b/core/source/generation/tableofcontents_generator.pyindex 16080c2..07dc59a 100644--- a/core/source/generation/tableofcontents_generator.py+++ b/core/source/generation/tableofcontents_generator.py@@ -1,13 +1,12 @@import json+# Utilsdef slugify(name):- # Create an anchor-friendly slug from a stringreturn name.lower().replace(" ", "-").replace("(", "").replace(")", "")def generate_table_of_contents():- # Load the categories JSON datawith open("core/data/static/categories.json", "r", encoding="utf-8") as f:data = json.load(f)categories = data.get("categories", [])@@ -21,17 +20,16 @@ def generate_table_of_contents():alphabetical_md += f"- [{name}](#{slugify(name)})\n"# Build the categorized list- # Create a mapping from parent id to parent nameparent_map = {cat["id"]: cat["name"] for cat in categories}- # Group subcategories by their parent id+grouped = {}for sub in subcategories:parent = sub.get("parent", "other")grouped.setdefault(parent, []).append(sub["name"])- # Sort each group's subcategories alphabetically+for key in grouped:grouped[key].sort(key=lambda x: x.lower())- # Sort parent categories (exclude "other", which is appended at the end)+parents = [(pid, parent_map.get(pid, "Other")) for pid in grouped if pid != "other"]parents.sort(key=lambda x: x[1].lower())if "other" in grouped:@@ -64,7 +62,7 @@ def generate_table_of_contents():<details open><summary><b>Categorized</b></summary> <br />-+{categorized_md}</details>"""diff --git a/core/source/maintenance/json_formatter.py b/core/source/maintenance/json_formatter.pyindex 96698d4..18589d5 100644--- a/core/source/maintenance/json_formatter.py+++ b/core/source/maintenance/json_formatter.py@@ -14,6 +14,7 @@ with open("core/data/static/platforms.json") as f:seen_github = set()issues_report = []+# Check for formatting issues inside of all data files (static and dynamic)for app in applications:app_issues = []diff --git a/core/source/maintenance/stats_updator.py b/core/source/maintenance/stats_updator.pyindex fd688e1..43be6e9 100644--- a/core/source/maintenance/stats_updator.py+++ b/core/source/maintenance/stats_updator.py@@ -1,8 +1,9 @@-import os-import requestsimport json+import osfrom datetime import datetime+import requests+with open("core/data/dynamic/applications.json", "r") as f:data = json.load(f)@@ -14,6 +15,7 @@ headers = {}+# Update stats of all projects by contacting GitHub APIdef update_application_data(app):repo_name = app["repo_url"].split("github.com/")[1]@@ -30,6 +32,7 @@ def update_application_data(app):app["stars"] = repo_data.get("stargazers_count", app["stars"])app["language"] = repo_data.get("language", app["language"])+ # Check for flags to prevent update of specific statsif "custom-homepage" not in app.get("flags", []):app["homepage_url"] = repo_data.get("homepage", app["homepage_url"])diff --git a/core/source/maintenance/status_checker.py b/core/source/maintenance/status_checker.pyindex f9bb1c3..8788d8c 100644--- a/core/source/maintenance/status_checker.py+++ b/core/source/maintenance/status_checker.py@@ -1,8 +1,9 @@-import os-import requestsimport json+import osfrom datetime import datetime, timedelta+import requests+INPUT_FILE = "core/data/dynamic/applications.json"OUTPUT_FILE = "resources/maintenance/status_maintenance.md"GITHUB_TOKEN = os.getenv("GITHUB_TOKEN")@@ -18,6 +19,7 @@ potentially_abandoned = []archived = []no_longer_exists = []+# Check if projects are abandoned, archived, or no longer existfor app in data.get("applications", []):repo_url = app.get("repo_url")if not repo_url or "github.com" not in repo_url: