BUILD: Add AppImage packaging support for Linux releases.

Closes #2

Author: nos1dot618

.gitignore

@@ -1,4 +1,6 @@
 .idea/
+build/
+release/
 cmake-build-debug**/
 venv/
 **__pycache__/

README.md

@@ -117,6 +117,19 @@ SUBCOMMANDS:
 
 1. [GNU Emacs](./editor-plugins/emacs)
 
+## Linux Releases
+
+Prebuilt Linux releases are distributed as **AppImages**, allowing the interpreter to run on most modern Linux distributions without installation.
+
+After downloading an AppImage, make it executable and run it:
+
+```shell
+chmod +x Lambda_Discipline-*.AppImage
+./Lambda_Discipline-*.AppImage --help
+```
+
+> You can also integrate the AppImage with your desktop environment using tools such as `AppImageLauncher`, or simply keep it as a portable executable.
+
 ## Dependencies
 
 1. [fmt](https://github.com/fmtlib/fmt.git): String formatting.

make.py

@@ -35,7 +35,9 @@ def subcommand_setup():
     build_dir.mkdir(parents=True, exist_ok=True)
 
     subprocess.run([sys.executable, "-m", "venv", str(venv_dir)], check=True)
-    subprocess.run([python(), "-m", "pip", "install", "-r", "requirements.dev.txt"], check=True)
+    subprocess.run(
+        [python(), "-m", "pip", "install", "-r", "requirements.dev.txt"], check=True
+    )
 
     try:
         subprocess.run(["cmake", "-S", ".", "-B", str(build_dir)], check=True)
@@ -49,17 +51,32 @@ def subcommand_build():
 
 
 def subcommand_test():
-    subprocess.run([python(), "-m", "pytest", f'--build-dir={BUILD_DIR}', "-v"], cwd=ROOT, check=True)
+    subprocess.run(
+        [python(), "-m", "pytest", f"--build-dir={BUILD_DIR}", "-v"],
+        cwd=ROOT,
+        check=True,
+    )
 
 
 if __name__ == "__main__":
-    parser = argparse.ArgumentParser(prog="make.py", description="Lambda Discipline build tool")
-    parser.add_argument("--build-dir", default="cmake-build-debug", help="CMake build directory (default: %(default)s)")
-    parser.add_argument("--venv-dir", default="venv",
-                        help="Python virtual environment directory (default: %(default)s)")
+    parser = argparse.ArgumentParser(
+        prog="make.py", description="Lambda Discipline build tool"
+    )
+    parser.add_argument(
+        "--build-dir",
+        default="cmake-build-debug",
+        help="CMake build directory (default: %(default)s)",
+    )
+    parser.add_argument(
+        "--venv-dir",
+        default="venv",
+        help="Python virtual environment directory (default: %(default)s)",
+    )
 
     subparsers = parser.add_subparsers(dest="command", required=True)
-    subparsers.add_parser("setup", help="Create venv, install dependencies, and configure CMake")
+    subparsers.add_parser(
+        "setup", help="Create venv, install dependencies, and configure CMake"
+    )
     subparsers.add_parser("build", help="Build the project")
     subparsers.add_parser("test", help="Run tests")
 

packaging/appimage/AppRun

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+
+HERE="$(dirname "$(readlink -f "$0")")"
+exec "$HERE/lbd" "$@"

packaging/appimage/fun.ninth.lambda-discipline.desktop

@@ -0,0 +1,10 @@
+[Desktop Entry]
+Type=Application
+Version=1.0
+Name=Lambda Discipline
+Comment=Functional programming language based on Lambda Calculus
+Exec=lbd
+Icon=fun.ninth.lambda-discipline
+Terminal=true
+Categories=Development;
+StartupNotify=true

packaging/appimage/fun.ninth.lambda-discipline.png

@@ -0,0 +1,97 @@
+#!/usr/bin/env python3
+
+from __future__ import annotations
+import argparse
+import shutil
+import subprocess
+from pathlib import Path
+import sys
+
+APP_ID = "fun.ninth.lambda-discipline"
+EXECUTABLE = "lbd"
+
+
+def run(*args: str) -> None:
+    subprocess.run(args, check=True)
+
+
+def copy_file(src: Path, dst: Path) -> None:
+    if not src.exists():
+        sys.exit(f"[ERROR] Path '{src}' does not exist")
+
+    shutil.copy2(src, dst)
+
+
+def get_appimagetool() -> str:
+    appimagetool = shutil.which("appimagetool")
+
+    if appimagetool is None:
+        appimagetool = shutil.which("appimagetool-x86_64.AppImage")
+
+    if appimagetool is None:
+        sys.exit(
+            "[ERROR] Could not find 'appimagetool' or 'appimagetool-x86_64.AppImage' in PATH."
+        )
+
+    return appimagetool
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(
+        description="Create an AppImage from an existing CMake build.",
+        epilog=(
+            "Example:\n  build-appimage.py build\n  build-appimage.py build-release"
+        ),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+
+    parser.add_argument(
+        "build_dir",
+        type=Path,
+        metavar="BUILD_DIR",
+        help="Path to the CMake build directory.",
+    )
+
+    parser.add_argument(
+        "release_dir",
+        type=Path,
+        metavar="RELEASE_DIR",
+        help="Directory where the AppDir and AppImage will be created.",
+    )
+
+    args = parser.parse_args()
+
+    build_dir = args.build_dir.resolve()
+    release_dir = args.release_dir.resolve()
+
+    executable = build_dir / EXECUTABLE
+    appdir = release_dir / "AppDir"
+
+    if not executable.exists():
+        sys.exit(f"[ERROR] Executable '{executable}' not found")
+
+    if appdir.exists():
+        shutil.rmtree(appdir)
+    appdir.mkdir(parents=True, exist_ok=True)
+
+    packaging = Path("packaging/appimage")
+
+    copy_file(packaging / "AppRun", appdir / "AppRun")
+    copy_file(packaging / f"{APP_ID}.desktop", appdir / f"{APP_ID}.desktop")
+    copy_file(packaging / f"{APP_ID}.png", appdir / f"{APP_ID}.png")
+    copy_file(executable, appdir / EXECUTABLE)
+
+    (appdir / "AppRun").chmod(0o755)
+    (appdir / EXECUTABLE).chmod(0o755)
+
+    run(
+        get_appimagetool(),
+        str(appdir),
+        str(release_dir / "Lambda_Discipline-x86_64.AppImage")
+    )
+
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())