starred/definitive-opensource
1
0
Fork 0
mirror of https://github.com/mustbeperfect/definitive-opensource.git synced 2026-04-22 08:45:50 +02:00
Code Issues Packages Projects Releases Wiki Activity

Fixed backticks still in applications.json platform tags

Browse Source
This commit is contained in:
Lucas
2025-03-22 16:54:04 -07:00
parent c242bc20f3
commit 65a5c66720
10 changed files with 654 additions and 657 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
source/scripts/contents_generator.py
View File

@@ -1,23 +1,18 @@
import json
def slugify(name):
"""
Convert a string to an anchor-friendly slug.
"""
# Converts string to an anchor-friendly slug
return name.lower().replace(" ", "-").replace("(", "").replace(")", "")
def extract_repo_path(link):
"""
Extract the GitHub repository path from the URL.
Expects links of the form: https://github.com/username/repo
"""
# Extract the GitHub repository path from the URL. Link format: https://github.com/username/repo
parts = link.rstrip("/").split("/")
if len(parts) >= 5:
return f"{parts[-2]}/{parts[-1]}"
return ""
def generate_contents(platform="all"):
# Load categories and applications JSON data.
# Load categories and applications JSON data
with open("source/data/categories.json", "r", encoding="utf-8") as f:
cat_data = json.load(f)
with open("source/data/applications.json", "r", encoding="utf-8") as f:
@@ -27,10 +22,10 @@ def generate_contents(platform="all"):
subcategories = cat_data.get("subcategories", [])
applications = app_data.get("applications", [])
# Build a mapping of parent category id to parent category name.
# Map parent categories id to corresponding name
parent_map = {cat["id"]: cat["Name"] for cat in categories}
# Group subcategories by their parent.
# Group subcategories by their parent
subcat_by_parent = {}
for sub in subcategories:
parent = sub.get("parent", "other")
@@ -38,23 +33,24 @@ def generate_contents(platform="all"):
"Name": sub["Name"],
"id": sub["id"]
})
# Sort subcategories alphabetically in each parent group.
# Sort subcategories alphabetically in each parent group
for key in subcat_by_parent:
subcat_by_parent[key].sort(key=lambda x: x["Name"].lower())
# Filter and group applications by their subcategory (identified by the app's "category" field).
# Filter and group applications by their subcategory
apps_by_subcat = {}
for app in applications:
include = False
if platform == "all":
include = True
else:
# Normalize platform tags by stripping backticks and comparing in lower-case.
app_platforms = [p.strip("`").lower() for p in app.get("platforms", [])]
# Compare platform tags in lower case
app_platforms = [p.lower() for p in app.get("platforms", [])]
target = platform.lower()
if target in app_platforms:
include = True
# For macos, linux, and windows, also include if "cross" is present.
# Include "Cross" apps for select platforms
if target in ["macos", "linux", "windows"] and "cross" in app_platforms:
include = True
if not include:
@@ -63,13 +59,13 @@ def generate_contents(platform="all"):
cat_id = app.get("category", "uncategorized")
apps_by_subcat.setdefault(cat_id, []).append(app)
# Sort applications within each subcategory alphabetically by name.
# Sort applications within each subcategory alphabetically by name
for key in apps_by_subcat:
apps_by_subcat[key].sort(key=lambda x: x["name"].lower())
# Build Markdown output.
md_output = ""
# Process parent categories: sort alphabetically (excluding "other", which is added last).
# Process parent categories: sort alphabetically (excluding "other", which is added last)
parent_items = [(pid, parent_map.get(pid, pid)) for pid in subcat_by_parent if pid != "other"]
parent_items.sort(key=lambda x: x[1].lower())
if "other" in subcat_by_parent:
@@ -77,13 +73,13 @@ def generate_contents(platform="all"):
for pid, pname in parent_items:
md_output += f"# {pname} - [Go to top](#contents)\n\n"
# For each subcategory under the parent category.
# For each subcategory under the parent category
for sub in subcat_by_parent.get(pid, []):
subname = sub["Name"]
md_output += f"### {subname}\n\n"
md_output += "| Name | Description | Platform | Stars |\n"
md_output += "| --- | --- | --- | --- |\n"
# List all apps for the given subcategory.
# List all apps for the given subcategory
apps = apps_by_subcat.get(sub["id"], [])
for app in apps:
name = app.get("name", "")
@@ -92,8 +88,8 @@ def generate_contents(platform="all"):
tags = ""
if app.get("tags"):
tags += " " + " ".join(app["tags"])
# Join the platform tags as provided.
app_platforms = " ".join(app.get("platforms", []))
# Join the platform tags as provided
app_platforms = " ".join(f"`{p}`" for p in app.get("platforms", []))
repo_path = extract_repo_path(link)
stars_badge = f"![GitHub Repo stars](https://img.shields.io/github/stars/{repo_path}?style=for-the-badge&label=%20&color=white)" if repo_path else ""
md_output += f"| [{name}]({link}){tags} | {description} | {app_platforms} | {stars_badge} |\n"
@@ -101,5 +97,5 @@ def generate_contents(platform="all"):
return md_output
if __name__ == "__main__":
# For testing, default to 'all' platforms.
# For testing, default to 'all' platforms
print(generate_contents("all"))