Merge pull request #276 from aminya/nala [skip ci]

Author: aminya

dist/actions/setup-cpp.js

@@ -4,4 +4,4 @@ pre-commit:
     test.lint:
       run: pnpm run test.lint
     build:
-      run: pnpm run clean && pnpm i && pnpm run build -- --no-color && git add ./dist
+      run: pnpm run clean && pnpm run build -- --no-color && git add ./dist

dist/actions/setup-cpp.js.map

@@ -46,6 +46,34 @@ Add the update-alternatives command to the rc file
 
 **returns:** Promise<void>
 
+### `getAptEnv` (function)
+
+Get the environment variables to use for the apt command
+
+**Parameters:**
+
+- apt (`string`) - The apt command to use
+
+**returns:** ProcessEnv
+
+### `aptTimeout` (variable)
+
+The timeout to use for apt commands
+Wait up to 300 seconds if the apt-get lock is held
+
+### `hasNala` (function)
+
+Check if nala is installed
+
+**returns:** boolean
+
+### `getApt` (function)
+
+Get the apt command to use
+If nala is installed, use that, otherwise use apt-get
+
+**returns:** string
+
 ### `isAptPackInstalled` (function)
 
 Check if a package is installed
@@ -66,6 +94,8 @@ Check if a package matching a regexp is installed
 
 **returns:** Promise<boolean>
 
+### `updatedRepos` (variable)
+
 ### `updateAptRepos` (function)
 
 Update the apt repositories
@@ -76,14 +106,72 @@ Update the apt repositories
 
 **returns:** void
 
-### `InstallationInfo` (type)
+### `updateAptReposMemoized` (variable)
 
-The information about an installation result
+Update the apt repositories (memoized)
 
-### `aptTimeout` (variable)
+**Parameters:**
 
-The timeout to use for apt commands
-Wait up to 300 seconds if the apt-get lock is held
+- apt - The apt command to use (optional)
+
+### `filterAndQualifyAptPackages` (function)
+
+Filter out the packages that are already installed and qualify the packages into a full package name/version
+
+**Parameters:**
+
+- packages (`AptPackage[]`)
+- apt (`string`)
+
+**returns:** Promise<string[]>
+
+### `qualifiedNeededAptPackage` (function)
+
+Qualify the package into full package name/version.
+If the package is not installed, return the full package name/version.
+If the package is already installed, return undefined
+
+**Parameters:**
+
+- pack (`AptPackage`)
+- apt (`string`)
+
+**returns:** Promise<string>
+
+### `initApt` (function)
+
+Install gnupg and certificates (usually missing from docker containers)
+
+**Parameters:**
+
+- apt (`string`)
+
+**returns:** Promise<void>
+
+### `initAptMemoized` (variable)
+
+Install gnupg and certificates (usually missing from docker containers) (memoized)
+
+### `addAptRepository` (function)
+
+**Parameters:**
+
+- repo (`string`)
+- apt (`string`)
+
+**returns:** Promise<void>
+
+### `installAddAptRepo` (function)
+
+**Parameters:**
+
+- apt (`string`)
+
+**returns:** Promise<void>
+
+### `InstallationInfo` (type)
+
+The information about an installation result
 
 ### `AptPackage` (type)
 
@@ -115,29 +203,6 @@ await installAptPack([
 ])
 ```
 
-### `hasNala` (function)
-
-Check if nala is installed
-
-**returns:** boolean
-
-### `getApt` (function)
-
-Get the apt command to use
-If nala is installed, use that, otherwise use apt-get
-
-**returns:** string
-
-### `getAptEnv` (function)
-
-Get the environment variables to use for the apt command
-
-**Parameters:**
-
-- apt (`string`) - The apt command to use
-
-**returns:** ProcessEnv
-
 ### `AddAptKeyOptions` (type)
 
 ### `addAptKey` (function)
@@ -151,10 +216,7 @@ Add an apt key
 **returns:** Promise<string>
 
 ```ts
-await addAptKey({
-  key: "3B4FE6ACC0B21F32"
-  fileName: "bazel-archive-keyring.gpg",
-})
+await addAptKey({ key: "3B4FE6ACC0B21F32" fileName: "bazel-archive-keyring.gpg"})
 ```
 
 ```ts

dist/legacy/setup-cpp.js

@@ -6,4 +6,5 @@ export * from "./get-apt.js"
 export * from "./init-apt.js"
 export * from "./install.js"
 export * from "./is-installed.js"
+export * from "./qualify-install.js"
 export * from "./update.js"

dist/legacy/setup-cpp.js.map

@@ -10,11 +10,11 @@ export async function initApt(apt: string) {
   // Update the repos
   updateAptReposMemoized(apt)
 
-  const toInstall = await filterAndQualifyAptPackages(apt, [
+  const toInstall = await filterAndQualifyAptPackages([
     { name: "ca-certificates" },
     { name: "gnupg" },
     { name: "apt-utils" },
-  ])
+  ], apt)
 
   if (toInstall.length !== 0) {
     execRootSync(apt, ["install", "-y", "--fix-broken", "-o", aptTimeout, ...toInstall], {