feat: add integration tests

Author: jgfranco17

.dockerignore

@@ -0,0 +1,28 @@
+# Include any files or directories that you don't want to be copied to your
+# container here (e.g., local build artifacts, temporary files, etc.).
+#
+# For more help, visit the .dockerignore file reference guide at
+# https://docs.docker.com/go/build-context-dockerignore/
+
+**/.DS_Store
+**/.classpath
+**/.dockerignore
+**/.env*
+**/.git
+**/.github
+**/.gitignore
+**/.project
+**/.settings
+**/.toolstarget
+**/.vs
+**/.vscode
+**/*.*proj.user
+**/*.dbmdl
+**/*.jfm
+**/bin
+**/charts
+**/docker-compose*
+**/*Dockerfile
+**/docs
+LICENSE
+README.md

.github/workflows/integration-test.yaml

@@ -0,0 +1,41 @@
+---
+name: Integration Test
+"on":
+  workflow_dispatch:
+  pull_request:
+    branches:
+      - main
+    paths:
+      - "integration/**"
+      - "**/*.go"
+  push:
+    branches:
+      - main
+
+permissions:
+  id-token: write
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  integration-test:
+    name: Run integration tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install Just
+        uses: ./.github/actions/setup-workspace
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Run integration tests
+        working-directory: ./integration
+        run: |
+          just build
+          just test-all

integration/Dockerfile

@@ -0,0 +1,35 @@
+# ========== CLI BUILD STAGE ==========
+ARG GO_VERSION=1.25
+FROM golang:${GO_VERSION}-alpine AS build
+
+WORKDIR /src
+RUN --mount=type=cache,target=/go/pkg/mod/ \
+    --mount=type=bind,source=go.mod,target=go.mod \
+    go mod download -x
+COPY . .
+RUN --mount=type=cache,target=/go/pkg/mod/ \
+    CGO_ENABLED=0 go build -o /bin/hackstack .
+
+# ========== CLI RUN STAGE ==========
+FROM ubuntu:22.04 AS app
+
+ENV DEBIAN_FRONTEND=noninteractive
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends curl ca-certificates xz-utils && \
+    rm -rf /var/lib/apt/lists/*
+
+COPY --from=build /bin/hackstack /bin/hackstack
+
+# Tests should use non-root to simulate a real user.
+ARG USERNAME=testuser
+ARG USER_ID=1000
+ARG GROUP_ID=1000
+RUN addgroup --gid $GROUP_ID ${USERNAME} && \
+    adduser --disabled-password --gecos '' --uid ${USER_ID} --gid ${GROUP_ID} ${USERNAME}
+
+USER $USERNAME
+ENV HOME=/home/${USERNAME}
+WORKDIR ${HOME}/projects
+
+ENTRYPOINT [ "/bin/hackstack" ]
+CMD ["--help"]

integration/docker-compose.yaml

@@ -0,0 +1,8 @@
+# Integration test Docker suite
+services:
+  hackstack:
+    container_name: hackstack
+    image: hackstack:latest
+    build:
+      context: ..
+      dockerfile: integration/Dockerfile

integration/justfile

@@ -0,0 +1,42 @@
+# INTEGRATION TEST SCRIPTS
+
+CAPTURE_OUTPUT_FILE := "output.txt"
+
+# Default target to list available commands
+_default:
+    @just --list --unsorted
+
+##########################################################
+# TEST WORKSPACE SETUP
+##########################################################
+
+# Build the services in Docker
+build:
+	docker compose build
+
+# Workspace teardown
+clean:
+	-docker compose down
+	-rm {{ CAPTURE_OUTPUT_FILE }}
+
+##########################################################
+# INTERACTIVE COMMANDS
+##########################################################
+
+# Run the CLI image with envs
+hackstack *args:
+    @docker compose run \
+        --remove-orphans --rm \
+        hackstack {{ args }}
+
+##########################################################
+# TEST EXECUTION
+##########################################################
+
+# Run the full test suite
+test-all: test-base
+    @echo "hackstack CLI integration test completed!"
+
+test-base:
+    @just hackstack --version | grep -n "hackstack"
+    @just hackstack --help 2>&1 | grep -n "hackstack"

integration/sample.yaml

@@ -0,0 +1,17 @@
+name: devops-common
+description: DevOps CLI - Simplifying your CI/CD pipelines
+version: 0.0.2
+repo_url: https://github.com/jgfranco17/devops
+
+codebase:
+  language: bash
+  test:
+    fail_fast: true
+    steps:
+      - echo "Tests completed successfully"
+  build:
+    fail_fast: true
+    env:
+      FOO: BAR
+    steps:
+      - echo "Build completed successfully with $FOO"