Nvim installation now works for more linux distros.

2026-08-19 18:50:56 -03:00
1 parent 700203b6fe
commit 31e570c8f9
@@ -1,7 +1,9 @@
-# Neovim Setup for Fedora
+# Neovim Setup

 A single-script Neovim configuration built around C/C++ development (CMake + clangd + codelldb), with LSP support for Go, C#, TypeScript/JavaScript, HTML, and CSS alongside it.

+Supports **Fedora, Ubuntu, Debian, and Arch Linux** (and their common derivatives — Pop!_OS, Linux Mint, Manjaro, EndeavourOS, etc. — via `/etc/os-release`'s `ID_LIKE`) — the script detects which one you're on and uses the right package manager and package names automatically.
+
 ## Installing

 ```bash
@@ -12,16 +14,25 @@ chmod +x setup_neovim.sh
 **This deletes `~/.config/nvim` and `~/.local/share/nvim` before writing the new config** — there is no backup step. If you have an existing Neovim setup you care about, copy it elsewhere first.

 The script:
-1. Installs system packages via `dnf` (compilers, debuggers, language runtimes, LSPs) and two Nerd Fonts (JetBrainsMono, Cascadia Code) for icon glyphs.
+1. Detects your distro and installs system packages via the right manager (`dnf`/`apt`/`pacman`), plus two Nerd Fonts (JetBrainsMono, Cascadia Code) for icon glyphs.
 2. Wipes and rewrites `~/.config/nvim`.
 3. Writes a personal `~/.clang-format` fallback (see [Formatting](#formatting)).

 First launch will take a minute or two: `lazy.nvim` bootstraps itself and installs all plugins, then Mason installs the language servers and `codelldb`.

+### Distro-specific notes
+
+- **Debian**: the .NET SDK isn't in Debian's own repos, so the script adds Microsoft's apt feed just for that one package. This step is best-effort — if it fails, the rest of the script still completes; see the printed warning for manual install instructions (only matters for C#/omnisharp).
+- **Ubuntu/Debian**: `fd-find`'s binary is named `fdfind` (a package-name clash with something unrelated), not `fd` like on Fedora/Arch. The script symlinks `~/.local/bin/fd` to it so anything expecting a plain `fd` on `PATH` (e.g. Telescope's file finder) works the same as everywhere else — make sure `~/.local/bin` is actually on your `PATH`.
+- **Arch**: the script runs a full `pacman -Syu` before installing anything new, per Arch's own guidance against partial upgrades — this does mean it'll upgrade your existing packages too, not just add new ones.
+- **Older distro releases** (Debian stable, older Ubuntu LTS): this config relies on Neovim 0.11+ APIs throughout. If your distro's packaged Neovim is older, the script prints a warning after install — see [Neovim's install docs](https://github.com/neovim/neovim/blob/master/INSTALL.md) for an AppImage/PPA/prebuilt build if so.
+
 ## What gets installed

- **Compilers/tools**: gcc, g++, make, cmake, clang-tools-extra, lldb, gdb, dotnet-sdk-8.0, golang, nodejs/npm, python3-pip
- **CLI tools**: ripgrep, fd-find, git, curl, wget, unzip, fish (used only for Neovim's embedded terminal — see [Terminal](#terminal))
+Package names vary by distro (see the script for the exact list per package manager), but the same set gets installed everywhere:
+
+- **Compilers/tools**: gcc, g++, make, cmake, clang tooling, lldb, gdb, .NET SDK 8.0, Go, nodejs/npm, python3-pip
+- **CLI tools**: ripgrep, fd, git, curl, wget, unzip, fish (used only for Neovim's embedded terminal — see [Terminal](#terminal))
 - **Language servers**: clangd, gopls, omnisharp, ts_ls, html, cssls (via Mason), plus `typescript-language-server` and `vscode-langservers-extracted` via npm
 - **Debug adapter**: codelldb (auto-installed by Mason on first debug session)

@@ -3,15 +3,130 @@
 echo

 echo "========================================="
-echo " Starting Neovim Setup for Fedora"
+echo " Starting Neovim Setup"
 echo "========================================="

-# 1. Install System Dependencies via DNF
-echo "[1/4] Installing system dependencies and LSPs..."
+# 1. Detect distro and install system dependencies
+echo "[1/4] Detecting distro and installing system dependencies..."
+
+if [ ! -f /etc/os-release ]; then
+    echo "ERROR: Cannot detect your Linux distribution (/etc/os-release not found)."
+    echo "This script supports Fedora, Ubuntu, Debian, and Arch Linux."
+    exit 1
+fi
+. /etc/os-release
+DISTRO_ID="$ID"
+DISTRO_ID_LIKE="${ID_LIKE:-}"
+
+# Normalize into one of: fedora, debian, arch. Checking ID_LIKE too so
+# common derivatives (Pop!_OS, Linux Mint, Manjaro, EndeavourOS, etc.)
+# land in the right family even though only the four distros above
+# were specifically asked for.
+case "$DISTRO_ID $DISTRO_ID_LIKE" in
+    *fedora*|*rhel*)
+        DISTRO_FAMILY="fedora"
+        ;;
+    *arch*)
+        DISTRO_FAMILY="arch"
+        ;;
+    *debian*|*ubuntu*)
+        DISTRO_FAMILY="debian"
+        ;;
+    *)
+        echo "ERROR: Unsupported or undetected distro (ID=$DISTRO_ID, ID_LIKE=$DISTRO_ID_LIKE)."
+        echo "This script supports Fedora, Ubuntu, Debian, and Arch Linux."
+        exit 1
+        ;;
+esac
+echo "Detected: $DISTRO_ID (family: $DISTRO_FAMILY)"
+
+case "$DISTRO_FAMILY" in
+    fedora)
        sudo dnf install -y neovim git curl wget gcc gcc-c++ make cmake \
            nodejs npm python3-pip ripgrep fd-find \
            golang clang-tools-extra dotnet-sdk-8.0 unzip fontconfig \
            lldb gdb fish
+        ;;
+
+    debian)
+        export DEBIAN_FRONTEND=noninteractive
+        sudo apt-get update
+        # Package name differences from Fedora: g++ (not gcc-c++),
+        # golang-go (not golang), clang-tools (not clang-tools-extra --
+        # Debian/Ubuntu split clang-format/clang-tidy differently, this
+        # is the closest equivalent bundle).
+        sudo apt-get install -y neovim git curl wget gcc g++ make cmake \
+            nodejs npm python3-pip ripgrep fd-find \
+            golang-go clang-tools unzip fontconfig \
+            lldb gdb fish
+
+        # fd-find installs its binary as `fdfind` on Debian/Ubuntu (a
+        # name clash with an unrelated existing package called `fd`),
+        # unlike Fedora/Arch where it's just `fd`. Symlink it so tools
+        # that look for a plain `fd` on PATH (e.g. Telescope's
+        # find_files) work the same way here as everywhere else.
+        if command -v fdfind >/dev/null 2>&1 && ! command -v fd >/dev/null 2>&1; then
+            mkdir -p "$HOME/.local/bin"
+            ln -sf "$(command -v fdfind)" "$HOME/.local/bin/fd"
+            echo "Symlinked fdfind -> ~/.local/bin/fd (make sure ~/.local/bin is on your PATH)."
+        fi
+
+        # .NET SDK: Ubuntu ships dotnet-sdk-8.0 directly in its own
+        # repos. Debian does not (long-standing packaging/licensing
+        # reasons) and needs Microsoft's own apt feed added first.
+        # Best-effort either way -- a failure here doesn't stop the
+        # rest of the script, since this only matters for C#/omnisharp.
+        if [ "$DISTRO_ID" = "ubuntu" ] || echo "$DISTRO_ID_LIKE" | grep -qi ubuntu; then
+            sudo apt-get install -y dotnet-sdk-8.0 || \
+                echo "WARNING: dotnet-sdk-8.0 install failed -- see https://learn.microsoft.com/en-us/dotnet/core/install/linux-ubuntu-install"
+        else
+            (
+                set -e
+                DEBIAN_MAJOR="${VERSION_ID%%.*}"
+                wget -q "https://packages.microsoft.com/config/debian/${DEBIAN_MAJOR}/packages-microsoft-prod.deb" -O /tmp/packages-microsoft-prod.deb
+                sudo dpkg -i /tmp/packages-microsoft-prod.deb
+                rm -f /tmp/packages-microsoft-prod.deb
+                sudo apt-get update
+                sudo apt-get install -y dotnet-sdk-8.0
+            ) || echo "WARNING: dotnet-sdk-8.0 install failed -- see https://learn.microsoft.com/en-us/dotnet/core/install/linux-debian for manual steps"
+        fi
+        ;;
+
+    arch)
+        # Arch's own wiki explicitly warns against `pacman -Sy
+        # <package>` (sync without upgrading first) -- it risks
+        # partial-upgrade dependency issues. -Syu first is the
+        # recommended safe order; this does mean the script also
+        # upgrades your existing packages, not just installs new ones,
+        # which is expected/intentional here, not a side effect to
+        # work around.
+        sudo pacman -Syu --noconfirm
+        # Package name differences from Fedora: gcc includes g++
+        # already (no separate gcc-c++ package), python-pip (not
+        # python3-pip -- Arch's default python already is python3),
+        # fd (not fd-find), go (not golang), clang bundles clang-format/
+        # clang-tidy directly (no separate clang-tools-extra).
+        sudo pacman -S --noconfirm neovim git curl wget gcc make cmake \
+            nodejs npm python-pip ripgrep fd \
+            go clang dotnet-sdk-8.0 unzip fontconfig \
+            lldb gdb fish
+        ;;
+esac
+
+# This config relies on fairly recent Neovim APIs (vim.lsp.config/
+# enable, virtual_lines diagnostics, vim.o.winborder -- all 0.11+).
+# Distro-packaged Neovim can lag well behind that, especially on
+# Debian stable and older Ubuntu LTS releases. Warn (don't fail) if
+# what actually got installed is too old.
+NVIM_VER_LINE=$(nvim --version 2>/dev/null | head -n1)
+NVIM_MAJOR=$(echo "$NVIM_VER_LINE" | sed -n 's/.*v\([0-9]*\)\.\([0-9]*\).*/\1/p')
+NVIM_MINOR=$(echo "$NVIM_VER_LINE" | sed -n 's/.*v\([0-9]*\)\.\([0-9]*\).*/\2/p')
+if [ -n "$NVIM_MAJOR" ] && [ -n "$NVIM_MINOR" ] && [ "$NVIM_MAJOR" -eq 0 ] && [ "$NVIM_MINOR" -lt 11 ]; then
+    echo "WARNING: Installed Neovim is v${NVIM_MAJOR}.${NVIM_MINOR}, but this config needs 0.11+."
+    echo "         Debian stable and older Ubuntu LTS releases often ship an older"
+    echo "         version. See https://github.com/neovim/neovim/blob/master/INSTALL.md"
+    echo "         for official AppImage/PPA/prebuilt options if so."
+fi

 # Install global NPM packages for JS/TS, HTML, and CSS LSPs
 echo "Installing NPM-based LSPs..."
@@ -46,7 +161,7 @@ fi
 fc-cache -fv
 echo "Fonts installed and cache updated successfully!"

-# 3. Deletes existing Neovim config
+# 3. Delete existing Neovim config
 echo "[3/4] Deleting existing Neovim configurations..."
 if [ -d "$HOME/.config/nvim" ]; then
    rm -fr "$HOME/.config/nvim"