Initial commit

Author: masaccio

src/build/build_binaries.py

@@ -0,0 +1,77 @@
+"""Build dotnet FracturedJson binaries and copy to Python package."""  # noqa: INP001
+
+import json
+import shutil
+import subprocess
+from os import chdir
+from pathlib import Path
+from sys import exit
+
+ROOT_DIR = Path(__file__).parent.parent.parent.absolute()
+BUILD_DIR = ROOT_DIR / "FracturedJson" / "FracturedJsonCli"
+SRC_DIR = ROOT_DIR / "src" / "fractured_json"
+TEST_DIR = ROOT_DIR / "tests" / "bin"
+VERSION_FILE = SRC_DIR / "_version.py"
+
+
+def build_binaries() -> None:
+    """Build the DLL and CLI as a new .NET project."""
+    chdir(BUILD_DIR)
+    shutil.rmtree(BUILD_DIR / "bin", ignore_errors=True)
+    shutil.rmtree(BUILD_DIR / "obj", ignore_errors=True)
+
+    cmd = ["dotnet", "publish", "-c", "Release"]
+    try:
+        subprocess.run(cmd, check=True, capture_output=True, text=True)  # noqa: S603
+    except subprocess.CalledProcessError as e:
+        print(e.output)
+        exit(1)
+
+    print("✅ Built CLI project and DLLs")
+
+
+def parse_assets_json() -> tuple[Path, str]:
+    """Parse project.assets.json for FracturedJson version."""
+    assets_filename = BUILD_DIR / "obj" / "project.assets.json"
+    if not assets_filename.exists():
+        msg = f"Run 'dotnet restore' first: {assets_filename}"
+        raise FileNotFoundError(msg)
+
+    assets = json.load(assets_filename.open())
+    framework = next(iter(assets["projectFileDependencyGroups"].keys()))
+    library_version = assets["project"]["version"]
+
+    print(f"✅ Latest version is {library_version}")
+    return (BUILD_DIR / "bin" / "Release" / framework / "publish", library_version)
+
+
+def create_version_file(version: str) -> None:
+    """Create _version.pywith latest FracturedJson version."""
+    with open(VERSION_FILE, "w") as f:  # noqa: PTH123
+        print('__version__ = "5.0.0"', file=f)
+    print(f"✅ Created _version.py with version {version}")
+
+
+def copy_binary(bin_dir: Path, file: str, target_dir: Path) -> None:
+    """Copy built binaries into Python folders."""
+    target_dir.mkdir(parents=True, exist_ok=True)
+    shutil.copy2(bin_dir / file, target_dir / file)
+
+
+def main() -> None:
+    """Build all the .NET dependencies and copy to the Python package."""
+    build_binaries()
+
+    bin_dir, version = parse_assets_json()
+    create_version_file(version)
+    copy_binary(bin_dir, "FracturedJson.dll", SRC_DIR)
+    copy_binary(bin_dir, "Mono.Options.dll", TEST_DIR)
+    copy_binary(bin_dir, "FracturedJson.dll", TEST_DIR)
+    copy_binary(bin_dir, "FracturedJsonCli", TEST_DIR)
+    copy_binary(bin_dir, "FracturedJsonCli.runtimeconfig.json", TEST_DIR)
+    copy_binary(bin_dir, "FracturedJsonCli.dll", TEST_DIR)
+    print("✅ Copied binaries to test folder")
+
+
+if __name__ == "__main__":
+    main()

src/build/generate_options_desc.py

@@ -0,0 +1,80 @@
+"""Generate options descriptions from the FracturedJson wiki."""  # noqa: INP001
+
+import re
+
+import requests
+from bs4 import BeautifulSoup
+
+WIKI_OPTIONS = "https://github.com/j-brooke/FracturedJson/wiki/Options"
+
+
+def to_snake_case(name: str, upper: bool = False) -> str:
+    """Convert PascalCase or camelCase to SNAKE_CASE or snake_case."""
+    s1 = re.sub("(.)([A-Z][a-z]+)", r"\1_\2", name)
+    s2 = re.sub("([a-z0-9])([A-Z])", r"\1_\2", s1)
+    return s2.upper() if upper else s2.lower()
+
+
+def fetch_options() -> dict[str, str]:
+    # Fetch the page
+    resp = requests.get(WIKI_OPTIONS)  # noqa: S113
+    resp.raise_for_status()
+
+    # Parse HTML
+    soup = BeautifulSoup(resp.text, "html.parser")
+
+    options: dict[str, str] = {}
+    option_name_map: dict[str, str] = {}
+    started = False
+
+    # Each option name is in an H2 inside a DIV.markdown-heading
+    for heading_div in soup.select("div.markdown-heading > h2"):
+        option_name = heading_div.get_text(strip=True)
+
+        # Some H2 tags are misinterpreted before this first option
+        if not started and option_name != "MaxTotalLineLength":
+            continue
+        started = True
+
+        # Walk forward to find the first <p> after this heading
+        desc = None
+        for sib in heading_div.parent.next_siblings:
+            # Skip non-tag items (whitespace, etc.)
+            if not getattr(sib, "name", None):
+                continue
+            # Stop if we hit another heading section
+            if sib.name in {"h1", "h2", "h3"} or (
+                sib.name == "div" and "markdown-heading" in sib.get("class", [])
+            ):
+                break
+            # First paragraph is the description
+            p = sib.find("p") if sib.name != "p" else sib
+            if p:
+                # Preserve spaces around <code> tags
+                desc = p.get_text(" ", strip=True)
+                break
+
+        if desc:
+            desc = re.sub(r"\s+\(.*", "", desc)
+            desc = re.sub(r"\s+", " ", desc)
+            desc = re.sub(r"The default.*", "", desc)
+            py_option_name = to_snake_case(option_name, upper=False)
+            option_name_map[py_option_name] = option_name
+            options[py_option_name] = desc
+
+    # Descriptions may refer to .NET names; convert to Pythonic names
+    for py_name, desc in options.items():
+        for py_name_2, dotnet_name in option_name_map.items():
+            desc = desc.replace(dotnet_name, py_name_2)  # noqa: PLW2901
+            desc = desc.replace("_", "-")  # noqa: PLW2901
+        options[py_name] = desc
+    return options
+
+
+if __name__ == "__main__":
+    options = fetch_options()
+    with open("src/fractured_json/generated/option_descriptions.py", "w") as f:
+        f.write("# Auto-generated file; do not edit.\n")
+        f.write("FLAG_DESCRIPTIONS = {\n")
+        f.writelines(f'    "{name}": "{desc}",\n' for name, desc in sorted(options.items()))
+        f.write("}\n")