feat: add tar as an installable tool

Author: aminya

README.md

@@ -36,7 +36,7 @@ Setting up a **cross-platform** environment for building and testing C++/C proje
 | cache           | ccache, sccache                                                                                             |
 | documentation   | doxygen, graphviz                                                                                           |
 | coverage        | gcovr, opencppcoverage, kcov                                                                                |
-| other           | python, powershell, sevenzip                                                                                |
+| other           | python, powershell, sevenzip, tar                                                                           |
 
 `setup-cpp` automatically handles the dependencies of the selected tool (e.g., `python` is required for `conan`).
 

action.yml

@@ -166,6 +166,9 @@ inputs:
   git:
     description: "Wether to install git (true/false) or the specific version to install."
     required: false
+  tar:
+    description: "Wether to install tar (true/false) or the specific version to install."
+    required: false
 
 runs:
   using: "node20"

cspell.config.yaml

@@ -60,6 +60,7 @@ words:
   - gcovr
   - ghes
   - Graphviz
+  - gtar
   - hadolint
   - iarna
   - inja

dist/legacy/setup-cpp.js

@@ -134,7 +134,7 @@ All the available tools:
       cache: { tools: "--ccache, --sccache" },
       documentation: { tools: "--doxygen, --graphviz" },
       coverage: { tools: "--gcovr, --opencppcoverage, --kcov" },
-      other: { tools: "--python, --powershell, --sevenzip" },
+      other: { tools: "--python, --powershell, --sevenzip, --tar" },
     },
     ["tools"],
   )

dist/legacy/setup-cpp.js.map

@@ -0,0 +1,12 @@
+import type { InstallationInfo } from "../../utils/setup/setupBin.js"
+import { testBin } from "../../utils/tests/test-helpers.js"
+import { setupTar } from "../tar.js"
+
+jest.setTimeout(300000)
+describe("setup-tar", () => {
+  it("should setup tar", async () => {
+    const installInfo = await setupTar("", "", process.arch)
+
+    await testBin("tar", ["--version"], (installInfo as InstallationInfo | undefined)?.binDir)
+  })
+})

dist/modern/setup-cpp.mjs

@@ -0,0 +1,61 @@
+import { info } from "ci-log"
+import { hasApk, installApkPack } from "setup-alpine"
+import { hasAptGet, installAptPack } from "setup-apt"
+import { installBrewPack } from "setup-brew"
+import which from "which"
+import { hasDnf } from "../utils/env/hasDnf.js"
+import { isArch } from "../utils/env/isArch.js"
+import { setupBin } from "../utils/setup/setupBin.js"
+import { setupDnfPack } from "../utils/setup/setupDnfPack.js"
+import { setupPacmanPack } from "../utils/setup/setupPacmanPack.js"
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export async function setupTar(version: string, setupDir: string, arch: string) {
+  const tar = await which("tar", { nothrow: true })
+  if (tar !== null) {
+    info(`tar already installed at ${tar}`)
+    return
+  }
+
+  switch (process.platform) {
+    case "win32": {
+      // install tar from GnuWin
+      // https://phoenixnap.dl.sourceforge.net/project/gnuwin32/tar/1.13-1/tar-1.13-1-bin.zip?viasf=1
+      return setupBin(
+        "tar",
+        "1.13-1",
+        () => {
+          return {
+            url: "https://phoenixnap.dl.sourceforge.net/project/gnuwin32/tar/1.13-1/tar-1.13-1-bin.zip?viasf=1",
+            extractedFolderName: "",
+            binRelativeDir: "bin",
+            binFileName: "tar.exe",
+          }
+        },
+        setupDir,
+        arch,
+      )
+    }
+    case "darwin": {
+      // installs as gtar
+      return installBrewPack("gnu-tar", version)
+    }
+    case "linux": {
+      if (isArch()) {
+        await setupPacmanPack("gzip")
+        await setupPacmanPack("xz")
+        return setupPacmanPack("tar")
+      } else if (hasDnf()) {
+        return setupDnfPack([{ name: "tar" }, { name: "gzip" }, { name: "xz" }])
+      } else if (hasAptGet()) {
+        return installAptPack([{ name: "tar" }, { name: "gzip" }, { name: "xz-utils" }])
+      } else if (await hasApk()) {
+        return installApkPack([{ name: "tar" }, { name: "gzip" }, { name: "xz" }])
+      }
+      throw new Error("Unsupported linux distribution")
+    }
+    default: {
+      throw new Error("Unsupported platform")
+    }
+  }
+}