Musl is too hard to set up on GitHub Actions, removing (#192)

Author: esimkowitz

.github/workflows/release.yml

@@ -10,53 +10,32 @@ jobs:
     name: Build N-API modules
     runs-on: ${{ matrix.settings.host }}
     permissions: {}
-    defaults:
-      run:
-        shell: ${{ matrix.settings.shell }}
     strategy:
       fail-fast: false
       matrix:
         settings:
           - host: macos-15-intel
             target: x86_64-apple-darwin
             npm_platform: darwin-x64
-            shell: bash
           - host: macos-latest
             target: aarch64-apple-darwin
             npm_platform: darwin-arm64
-            shell: bash
           - host: windows-latest
             target: x86_64-pc-windows-msvc
             npm_platform: win32-x64-msvc
-            shell: bash
           - host: windows-11-arm
             target: aarch64-pc-windows-msvc
             npm_platform: win32-arm64-msvc
-            shell: bash
           - host: ubuntu-latest
             target: x86_64-unknown-linux-gnu
             npm_platform: linux-x64-gnu
-            shell: bash
           - host: ubuntu-24.04-arm
             target: aarch64-unknown-linux-gnu
             npm_platform: linux-arm64-gnu
-            shell: bash
-          - host: ubuntu-latest
-            target: x86_64-unknown-linux-musl
-            npm_platform: linux-x64-musl
-            alpine: true
-            alpine_arch: x86_64
-            shell: alpine.sh {0}
-          - host: ubuntu-latest
-            target: aarch64-unknown-linux-musl
-            npm_platform: linux-arm64-musl
-            alpine: true
-            alpine_arch: aarch64
-            shell: alpine.sh {0}
     steps:
       # Speed up apt-get operations by disabling unnecessary man-db auto-update
       - name: Disable man-db auto-update
-        if: runner.os == 'Linux' && !matrix.settings.alpine
+        if: runner.os == 'Linux'
         run: |
           echo "man-db man-db/auto-update boolean false" | sudo debconf-set-selections
           sudo rm -f /var/lib/man-db/auto-update
@@ -72,33 +51,11 @@ jobs:
           cache: false
       - name: Setup Task runner
         uses: go-task/setup-task@v1
-      - name: Setup Alpine Linux
-        if: matrix.settings.alpine
-        uses: jirutka/setup-alpine@v1
-        with:
-          arch: ${{ matrix.settings.alpine_arch }}
-          packages: >
-            build-base
-            cups-dev
-            nodejs
-            npm
-            go-task
-            curl
-      - name: Install Linux dependencies (glibc)
-        if: runner.os == 'Linux' && !matrix.settings.alpine
+      - name: Install Linux dependencies
+        if: runner.os == 'Linux'
         run: |
           sudo apt-get update
           sudo apt-get install -y libcups2-dev pkg-config clang
-      - name: Install Rust toolchain in Alpine (musl)
-        if: matrix.settings.alpine
-        run: |
-          # Install rustup
-          curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain none
-          source $HOME/.cargo/env
-          # Install toolchain and components from rust-toolchain.toml
-          rustup show
-          # Add musl target
-          rustup target add ${{ matrix.settings.target }}
       - name: Install dependencies
         run: npm ci
       - name: Build N-API module
@@ -138,46 +95,27 @@ jobs:
     runs-on: ${{ matrix.settings.host }}
     needs: build-napi
     permissions: {}
-    defaults:
-      run:
-        shell: ${{ matrix.settings.shell }}
     strategy:
       fail-fast: false
       matrix:
         settings:
           - host: macos-13
             target: x86_64-apple-darwin
-            shell: bash
           - host: macos-14
             target: aarch64-apple-darwin
-            shell: bash
           - host: windows-latest
             target: x86_64-pc-windows-msvc
-            shell: bash
           - host: windows-11-arm
             target: aarch64-pc-windows-msvc
             test_runtimes: rust node
-            shell: bash
           - host: ubuntu-latest
             target: x86_64-unknown-linux-gnu
-            shell: bash
           - host: ubuntu-24.04-arm
             target: aarch64-unknown-linux-gnu
-            shell: bash
-          - host: ubuntu-latest
-            target: x86_64-unknown-linux-musl
-            alpine: true
-            alpine_arch: x86_64
-            shell: alpine.sh {0}
-          - host: ubuntu-latest
-            target: aarch64-unknown-linux-musl
-            alpine: true
-            alpine_arch: aarch64
-            shell: alpine.sh {0}
     steps:
       # Speed up apt-get operations by disabling unnecessary man-db auto-update
-      - name: Disable man-db auto-update and install deps (glibc)
-        if: runner.os == 'Linux' && !matrix.settings.alpine
+      - name: Disable man-db auto-update and install deps
+        if: runner.os == 'Linux'
         run: |
           echo "man-db man-db/auto-update boolean false" | sudo debconf-set-selections
           sudo rm -f /var/lib/man-db/auto-update
@@ -208,27 +146,6 @@ jobs:
         with:
           version: 3.x
           repo-token: ${{ secrets.GITHUB_TOKEN }}
-      - name: Setup Alpine Linux
-        if: matrix.settings.alpine
-        uses: jirutka/setup-alpine@v1
-        with:
-          arch: ${{ matrix.settings.alpine_arch }}
-          packages: >
-            cups-dev
-            go-task
-            nodejs
-            npm
-            deno
-            bun
-            curl
-      - name: Install Rust toolchain in Alpine (musl)
-        if: matrix.settings.alpine
-        run: |
-          # Install rustup
-          curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain none
-          source $HOME/.cargo/env
-          # Install toolchain and components from rust-toolchain.toml
-          rustup show
       - name: Download all N-API binary artifacts
         uses: actions/download-artifact@v5
         with:

CLAUDE.md

@@ -180,11 +180,8 @@ ALWAYS run these after changes through the taskfile:
    runtime detection and behavior
 10. **Platform limitations**:
     - Android intentionally excluded from N-API builds
-11. **Musl support**: Linux musl (Alpine) fully supported
-    - Detection via `process.report` API (no shell/filesystem access)
-    - Built with Docker using `node:22-alpine` for security
-    - Supports both x64 and arm64 architectures
-12. **Deno N-API support**: Deno requires `"nodeModulesDir": "auto"` in deno.json
+    - Linux musl (Alpine) not currently supported - only glibc-based distributions
+11. **Deno N-API support**: Deno requires `"nodeModulesDir": "auto"` in deno.json
     and `--allow-ffi` flag for N-API modules to work
 
 ## NAPI-RS Publishing and Release Workflow

CONTRIBUTING.md

@@ -177,12 +177,10 @@ The GitHub Actions release workflow handles cross-platform builds and npm publis
 
 **Supported platforms:**
 
-- **Linux**: x64-gnu, arm64-gnu, x64-musl, arm64-musl (both glibc and musl supported)
+- **Linux**: x64-gnu, arm64-gnu
 - **macOS**: x64, arm64
 - **Windows**: x64-msvc, arm64-msvc
 
-**Musl Support:** Alpine Linux, BusyBox-based systems, and other musl-based distributions are fully supported. The library automatically detects musl vs glibc using Node.js's `process.report` API.
-
 ## Publishing Architecture
 
 **Distribution via npm:**

README.md

@@ -9,7 +9,7 @@ Cross-runtime printer library for Node.js, Deno, and Bun with native performance
 ## Features
 
 - 🔄 **Cross-runtime compatibility** - Node.js, Deno, and Bun support
-- 🖨️ **Cross-platform printing** - Windows, macOS, and Linux (glibc and musl)
+- 🖨️ **Cross-platform printing** - Windows, macOS, and Linux
 - 🦀 **Native performance** - Rust backend with Node-API bindings
 - 🔒 **Safe testing** - Simulation mode prevents accidental printing
 - 📊 **Real-time monitoring** - Printer state changes and job tracking
@@ -20,7 +20,7 @@ Cross-runtime printer library for Node.js, Deno, and Bun with native performance
 
 - **macOS**: x64, arm64
 - **Windows**: x64, arm64
-- **Linux**: x64, arm64 (both glibc and musl supported, including Alpine Linux)
+- **Linux**: x64, arm64
 
 ## Installation
 

package.json

@@ -16,9 +16,7 @@
       "x86_64-pc-windows-msvc",
       "aarch64-pc-windows-msvc",
       "x86_64-unknown-linux-gnu",
-      "aarch64-unknown-linux-gnu",
-      "x86_64-unknown-linux-musl",
-      "aarch64-unknown-linux-musl"
+      "aarch64-unknown-linux-gnu"
     ]
   },
   "engines": {

src/index.ts

@@ -734,35 +734,6 @@ if (isSimulationMode) {
   );
 }
 
-/**
- * Detect if the system is using musl libc (e.g., Alpine Linux)
- * Uses process.report API which is available in Node.js without filesystem/shell access
- */
-function isMuslLibc(): boolean {
-  if (!isNode) return false;
-
-  try {
-    // Check for glibc version in process report (only present on glibc systems)
-    const report = g.process?.report?.getReport?.();
-    if (report?.header?.glibcVersionRuntime) {
-      return false; // Has glibc version, so it's glibc
-    }
-
-    // Check shared objects for musl indicators
-    if (Array.isArray(report?.sharedObjects)) {
-      return report.sharedObjects.some(
-        (obj: string) =>
-          typeof obj === "string" &&
-          (obj.includes("libc.musl-") || obj.includes("ld-musl-"))
-      );
-    }
-  } catch {
-    // If report API fails, assume glibc (safer default)
-  }
-
-  return false;
-}
-
 // Always load the N-API module - let the backend handle simulation mode
 try {
   // Platform detection for N-API module loading
@@ -788,13 +759,10 @@ try {
       throw new Error(`Unsupported architecture for Windows: ${arch}`);
     }
   } else if (platform === "linux") {
-    // Detect musl vs glibc
-    const isMusl = isMuslLibc();
-
     if (arch === "x64") {
-      platformString = isMusl ? "linux-x64-musl" : "linux-x64-gnu";
+      platformString = "linux-x64-gnu";
     } else if (arch === "arm64") {
-      platformString = isMusl ? "linux-arm64-musl" : "linux-arm64-gnu";
+      platformString = "linux-arm64-gnu";
     } else {
       throw new Error(`Unsupported architecture for Linux: ${arch}`);
     }