aminya · aminya · Mar 23, 2025 · Mar 23, 2025 · Mar 23, 2025 · Mar 23, 2025
diff --git a/.github/workflows/CI.yml b/.github/workflows/CI.yml
@@ -244,6 +244,7 @@ jobs:
          - { distro: "ubuntu", image: "setup-cpp-ubuntu", BASE_VERSION: "20.04", tag: "20.04-1.3.0" }
          - { distro: "fedora", image: "setup-cpp-fedora", tag: "40-1.3.0" }
          - { distro: "arch", image: "setup-cpp-arch", tag: "base-1.3.0" }
+          - { distro: "alpine", image: "setup-cpp-alpine", BASE_VERSION: "22-alpine3.21", tag: "3.21-1.3.0" }
        include:
          - os: ubuntu-24.04-arm
            platform: linux/arm64
@@ -254,6 +255,9 @@ jobs:
          - os: ubuntu-24.04-arm
            platform: linux/arm64
            container: { distro: "ubuntu", image: "setup-cpp-ubuntu", BASE_VERSION: "20.04", tag: "20.04-1.3.0" }
+          - os: ubuntu-24.04-arm
+            platform: linux/arm64
+            container: { distro: "alpine", image: "setup-cpp-alpine", BASE_VERSION: "22-alpine3.21", tag: "3.21-1.3.0" }
    steps:
      - uses: actions/checkout@v4
        with:
@@ -300,7 +304,7 @@ jobs:
          docker tag aminya/${{ matrix.container.image }}:${{ matrix.container.tag }}-${{ steps.platform.outputs.suffix }} aminya/${{ matrix.container.image }}:latest

      - name: Push latest to Docker Hub
-        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' }}
+        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' && matrix.container.distro != 'alpine' }}
        run: docker push aminya/${{ matrix.container.image }}:latest

      - name: Docker Readme for setup-cpp-${{matrix.container.distro }}
@@ -331,7 +335,7 @@ jobs:
          docker tag aminya/${{ matrix.container.image }}-llvm:${{ matrix.container.tag }}-${{ steps.platform.outputs.suffix }} aminya/${{ matrix.container.image }}-llvm:latest

      - name: Push latest to Docker Hub
-        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' }}
+        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' && matrix.container.distro != 'alpine' }}
        run: docker push aminya/${{ matrix.container.image }}-llvm:latest

      - name: Docker Readme for setup-cpp-${{matrix.container.distro }}-llvm
@@ -372,7 +376,7 @@ jobs:
          docker tag aminya/${{ matrix.container.image }}-gcc:${{ matrix.container.tag }}-${{ steps.platform.outputs.suffix }} aminya/${{ matrix.container.image }}-gcc:latest

      - name: Push latest to Docker Hub
-        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' }}
+        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' && matrix.container.distro != 'alpine' }}
        run: docker push aminya/${{ matrix.container.image }}-gcc:latest

      - name: Docker Readme for setup-cpp-${{matrix.container.distro }}-gcc
@@ -396,7 +400,7 @@ jobs:

      - name: Build setup-cpp-${{matrix.container.distro }}-mingw
        id: build_mingw
-        if: ${{ matrix.container.distro != 'fedora' }}
+        if: ${{ matrix.container.distro != 'fedora' && !(matrix.container.distro == 'alpine' && matrix.platform == 'linux/arm64') }}
        uses: docker/build-push-action@v6
        with:
          context: .
@@ -410,16 +414,16 @@ jobs:
          cache-to: type=inline

      - name: Tag latest locally
-        if: ${{ matrix.container.distro != 'fedora' }}
+        if: ${{ matrix.container.distro != 'fedora' && !(matrix.container.distro == 'alpine' && matrix.platform == 'linux/arm64') }}
        run: |
          docker tag aminya/${{ matrix.container.image }}-mingw:${{ matrix.container.tag }}-${{ steps.platform.outputs.suffix }} aminya/${{ matrix.container.image }}-mingw:latest

      - name: Push latest to Docker Hub
-        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' && matrix.container.distro != 'fedora' }}
+        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' && matrix.container.distro != 'fedora' && matrix.container.distro != 'alpine' }}
        run: docker push aminya/${{ matrix.container.image }}-mingw:latest

      - name: Docker Readme for setup-cpp-${{matrix.container.distro }}-mingw
-        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'fedora' }}
+        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'fedora' && !(matrix.container.distro == 'alpine' && matrix.platform == 'linux/arm64') }}
        uses: peter-evans/dockerhub-description@v4
        with:
          username: aminya
@@ -428,7 +432,7 @@ jobs:
          readme-filepath: ./README_DOCKER.md

      - name: Test Mingw
-        if: ${{ !contains(github.event.head_commit.message, '[skip test]') && matrix.container.distro != 'fedora' }}
+        if: ${{ !contains(github.event.head_commit.message, '[skip test]') && matrix.container.distro != 'fedora' && matrix.container.distro != 'alpine' }}
        uses: docker/build-push-action@v6
        with:
          context: .
@@ -459,6 +463,11 @@ jobs:
          - { distro: "ubuntu", image: "setup-cpp-ubuntu", tag: "24.04-1.3.0", suffix: "-llvm", latest: true }
          - { distro: "ubuntu", image: "setup-cpp-ubuntu", tag: "24.04-1.3.0", suffix: "-gcc", latest: true }
          - { distro: "ubuntu", image: "setup-cpp-ubuntu", tag: "24.04-1.3.0", suffix: "-mingw", latest: true }
+
+          - { distro: "alpine", image: "setup-cpp-alpine", tag: "3.21-1.3.0", suffix: "", latest: true }
+          - { distro: "alpine", image: "setup-cpp-alpine", tag: "3.21-1.3.0", suffix: "-llvm", latest: true }
+          - { distro: "alpine", image: "setup-cpp-alpine", tag: "3.21-1.3.0", suffix: "-gcc", latest: true }
+          - { distro: "alpine", image: "setup-cpp-alpine", tag: "3.21-1.3.0", suffix: "-mingw", latest: true }
    steps:
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3

diff --git a/dev/docker/ci/alpine-gcc.dockerfile b/dev/docker/ci/alpine-gcc.dockerfile
@@ -0,0 +1,10 @@
+FROM aminya/setup-cpp-alpine:latest AS setup-cpp-alpine-gcc
+
+# install gcc
+RUN node --enable-source-maps /usr/lib/setup-cpp/setup-cpp.mjs \
+    --compiler gcc && \
+# cleanup
+    rm -rf /var/cache/apk/*
+
+SHELL ["/entrypoint.sh", "/bin/sh", "-c"]
+ENTRYPOINT ["/entrypoint.sh", "/bin/sh"]
diff --git a/dev/docker/ci/alpine-llvm.dockerfile b/dev/docker/ci/alpine-llvm.dockerfile
@@ -0,0 +1,10 @@
+FROM aminya/setup-cpp-alpine:latest AS setup-cpp-alpine-llvm
+
+# install llvm
+RUN node --enable-source-maps /usr/lib/setup-cpp/setup-cpp.mjs \
+    --compiler llvm && \
+# cleanup
+    rm -rf /var/cache/apk/*
+
+SHELL ["/entrypoint.sh", "/bin/sh", "-c"]
+ENTRYPOINT ["/entrypoint.sh", "/bin/sh"]
diff --git a/dev/docker/ci/alpine-mingw.dockerfile b/dev/docker/ci/alpine-mingw.dockerfile
@@ -0,0 +1,11 @@
+FROM aminya/setup-cpp-alpine:latest AS setup-cpp-alpine-mingw
+
+# install mingw/powershell
+RUN node --enable-source-maps /usr/lib/setup-cpp/setup-cpp.mjs \
+    --compiler mingw \
+    --powershell true && \
+# cleanup
+    rm -rf /var/cache/apk/*
+
+SHELL ["/entrypoint.sh", "/bin/sh", "-c"]
+ENTRYPOINT ["/entrypoint.sh", "/bin/sh"]
diff --git a/dev/docker/ci/alpine.dockerfile b/dev/docker/ci/alpine.dockerfile
@@ -0,0 +1,34 @@
+ARG BASE_VERSION=22-alpine3.21
+
+#### Base Image with Node.js
+FROM --platform=$BUILDPLATFORM node:${BASE_VERSION} AS alpine-nodejs
+
+#### Base Image with Tools
+FROM alpine-nodejs AS setup-cpp-alpine
+
+COPY "./dist/modern" "/usr/lib/setup-cpp/"
+
+# install the cpp tools
+RUN node --enable-source-maps /usr/lib/setup-cpp/setup-cpp.mjs \
+        --cmake true \
+        --ninja true \
+        --task true \
+        --python true \
+        --make true \
+        --cppcheck true \
+        --gcovr true \
+        --doxygen true \
+        --vcpkg true \
+        --ccache true \
+        --conan true \
+        --cmakelang true \
+        --meson true && \
+# cleanup
+    rm -rf /var/cache/apk/*
+
+# Custom entrypoint due to bash -l limitations on Alpine
+RUN printf '#!/bin/bash\nsource $HOME/.cpprc\nexec "$@"\n' > /entrypoint.sh && \
+    chmod +x /entrypoint.sh
+
+SHELL ["/entrypoint.sh", "/bin/sh", "-c"]
+ENTRYPOINT ["/entrypoint.sh", "/bin/sh"]
diff --git a/dev/docker/examples/alpine-gcc.dockerfile b/dev/docker/examples/alpine-gcc.dockerfile
@@ -0,0 +1,15 @@
+#### Building (example)
+FROM aminya/setup-cpp-alpine-gcc AS builder
+
+COPY ./dev/cpp_vcpkg_project /home/app
+WORKDIR /home/app
+RUN task build
+
+#### Running environment
+# use a fresh image as the runner
+FROM alpine:3.21 AS runner
+
+# copy the built binaries and their runtime dependencies
+COPY --from=builder /home/app/build/my_exe/Release/ /home/app/
+WORKDIR /home/app/
+ENTRYPOINT ["./my_exe"]
diff --git a/dev/docker/examples/alpine-llvm.dockerfile b/dev/docker/examples/alpine-llvm.dockerfile
@@ -0,0 +1,15 @@
+#### Building (example)
+FROM aminya/setup-cpp-alpine-llvm AS builder
+
+COPY ./dev/cpp_vcpkg_project /home/app
+WORKDIR /home/app
+RUN task build
+
+#### Running environment
+# use a fresh image as the runner
+FROM alpine:3.21 AS runner
+
+# copy the built binaries and their runtime dependencies
+COPY --from=builder /home/app/build/my_exe/Release/ /home/app/
+WORKDIR /home/app/
+ENTRYPOINT ["./my_exe"]
diff --git a/dev/docker/examples/alpine-mingw.dockerfile b/dev/docker/examples/alpine-mingw.dockerfile
@@ -0,0 +1,7 @@
+#### Cross Building (example)
+FROM aminya/setup-cpp-alpine-mingw AS builder-mingw
+
+COPY ./dev/cpp_vcpkg_project /home/app
+WORKDIR /home/app
+RUN bash -c 'source ~/.cpprc \
+    && task build_cross_mingw'
diff --git a/dist/legacy/setup-cpp.js b/dist/legacy/setup-cpp.js
diff --git a/dist/legacy/setup-cpp.js.map b/dist/legacy/setup-cpp.js.map
diff --git a/dist/modern/setup-cpp.mjs b/dist/modern/setup-cpp.mjs
diff --git a/dist/modern/setup-cpp.mjs.map b/dist/modern/setup-cpp.mjs.map
diff --git a/package.json b/package.json
@@ -135,6 +135,7 @@
    "safe-stable-stringify": "^2.5.0",
    "semver": "7.7.1",
    "setup-apt": "workspace:*",
+    "setup-alpine": "workspace:*",
    "setup-brew": "workspace:*",
    "setup-python": "github:aminya/setup-python#9700887",
    "shx": "0.4.0",
@@ -184,6 +185,7 @@
    "retry-as-promised",
    "semver",
    "setup-apt",
+    "setup-alpine",
    "setup-brew",
    "setup-python",
    "simple-update-notifier",

diff --git a/packages/envosman/package.json b/packages/envosman/package.json
@@ -1,6 +1,6 @@
 {
  "name": "envosman",
-  "version": "1.0.3",
+  "version": "1.0.4",
  "description": "Manage environment variables, PATH, and rc files",
  "repository": "https://github.com/aminya/setup-cpp",
  "homepage": "https://github.com/aminya/setup-cpp/tree/master/packages/envosman",

diff --git a/packages/envosman/src/add-env.ts b/packages/envosman/src/add-env.ts
@@ -89,6 +89,8 @@ async function addEnvSystem(name: string, valGiven: string | undefined, options:
        await appendFile(options.rcPath, `\nexport ${name}="${val}"\n`)
        info(`${name}="${val}" was added to "${options.rcPath}`)
      }
+      // eslint-disable-next-line require-atomic-updates
+      process.env[name] = val
      return
    }
    default: {

diff --git a/packages/setup-alpine/.eslintrc.json b/packages/setup-alpine/.eslintrc.json
@@ -0,0 +1,3 @@
+{
+  "extends": "../../.eslintrc.json"
+}
diff --git a/packages/setup-alpine/package.json b/packages/setup-alpine/package.json
@@ -0,0 +1,55 @@
+{
+  "name": "setup-alpine",
+  "version": "1.0.0",
+  "description": "Setup apk packages and repositories in Alpine Linux distributions",
+  "repository": "https://github.com/aminya/setup-cpp",
+  "homepage": "https://github.com/aminya/setup-cpp/tree/master/packages/setup-alpine",
+  "license": "Apache-2.0",
+  "author": "Amin Yahyaabadi",
+  "main": "./dist/index.js",
+  "source": "./src/index.ts",
+  "type": "module",
+  "files": [
+    "dist",
+    "src",
+    "tsconfig.json"
+  ],
+  "scripts": {
+    "build": "tsc --pretty",
+    "dev": "tsc --watch --pretty",
+    "lint.tsc": "tsc --noEmit --pretty",
+    "lint.eslint": "eslint '**/*.{ts,tsx,js,jsx,cjs,mjs,json,yaml}' --no-error-on-unmatched-pattern --cache --cache-location ./.cache/eslint/ --fix",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "@types/node": "22.13.11",
+    "admina": "^1.0.1",
+    "ci-info": "^4.0.0",
+    "path-exists": "^5.0.0",
+    "ci-log": "workspace:*",
+    "envosman": "workspace:*",
+    "which": "4.0.0",
+    "execa": "7.2.0",
+    "memoizee": "^0.4.17"
+  },
+  "engines": {
+    "node": ">=12"
+  },
+  "keywords": [
+    "setup",
+    "apk",
+    "apk-add",
+    "repository",
+    "alpine",
+    "install",
+    "setup-apk",
+    "repositories",
+    "linux",
+    "alpine-linux",
+    "package"
+  ],
+  "devDependencies": {
+    "@types/memoizee": "0.4.11",
+    "@types/which": "~3.0.4"
+  }
+}
diff --git a/packages/setup-alpine/src/apk-repository.ts b/packages/setup-alpine/src/apk-repository.ts
@@ -0,0 +1,60 @@
+import { info } from "ci-log"
+import { appendFile, readFile } from "fs/promises"
+import { pathExists } from "path-exists"
+import { hasApk } from "./has-apk.js"
+import { updateApkMemoized } from "./update.js"
+
+/**
+ * Add an APK repository
+ * @param repoUrl The URL of the repository to add
+ * @returns Whether the repository was added successfully
+ */
+
+export async function addApkRepository(repoUrl: string): Promise<boolean> {
+  if (!(await hasApk())) {
+    throw new Error("apk is not available on this system")
+  }
+
+  try {
+    // Check if repositories file exists
+    const reposFile = "/etc/apk/repositories"
+    if (!(await pathExists(reposFile))) {
+      throw new Error(`APK repositories file not found at ${reposFile}`)
+    }
+
+    // Add repository to the file
+    info(`Adding repository: ${repoUrl}`)
+    await appendFile(reposFile, `${repoUrl}\n`)
+
+    // Update package index after adding repository
+    await updateApkMemoized.clear()
+    await updateApkMemoized()
+
+    info(`Successfully added repository: ${repoUrl}`)
+    return true
+  } catch (error) {
+    throw new Error(`Failed to add repository ${repoUrl}: ${error}`)
+  }
+}
+
+/**
+ * Enable the community repository
+ * @returns Whether the repository was added successfully
+ */
+export async function enableCommunityRepository() {
+  const alpineVersion = (await getAlpineVersion()).split(".").slice(0, 2).join(".")
+
+  return addApkRepository(`https://dl-cdn.alpinelinux.org/alpine/v${alpineVersion}/community/`)
+}
+
+/**
+ * Get the Alpine version
+ * @returns The Alpine version
+ */
+export async function getAlpineVersion() {
+  const releaseFile = "/etc/alpine-release"
+  if (!(await pathExists(releaseFile))) {
+    throw new Error(`Alpine release file not found at ${releaseFile}`)
+  }
+  return readFile(releaseFile, "utf8")
+}
diff --git a/packages/setup-alpine/src/has-apk.ts b/packages/setup-alpine/src/has-apk.ts
@@ -0,0 +1,15 @@
+import memoizee from "memoizee"
+import which from "which"
+
+async function hasApk_() {
+  try {
+    await which("apk")
+    return true
+  } catch (error) {
+    return false
+  }
+}
+/**
+ * Check if apk is available on the system
+ */
+export const hasApk = memoizee(hasApk_, { promise: true })
diff --git a/packages/setup-alpine/src/index.ts b/packages/setup-alpine/src/index.ts
@@ -0,0 +1,6 @@
+export * from "./apk-repository.js"
+export * from "./has-apk.js"
+export * from "./init-apt.js"
+export * from "./install-package.js"
+export * from "./qualify-install.js"
+export * from "./update.js"