feat: add dotenv action to load environment variables (#632)

* feat: add dotenv action to load environment variables

* fix: update dotenv action path and add environment variables file

* refactor into workflow, not action

* refactor: reorganize GitHub workflows for OS-specific testing

* refactor: migrate BSD tests to reusable workflow structure

* refactor: standardize workflow names and update OS-specific configurations

* refactor: integrate dotenv action for dynamic Go version setup in workflows

* refactor: add documentation build badge to README

Author: creativeprojects

.github/workflows/BSD-tests.yml

@@ -50,11 +50,19 @@ jobs:
     - name: Checkout repository
       uses: actions/checkout@v6
 
-    - name: Set up Go (latest version)
+    - name: Dotenv Action
+      id: dotenv
+      uses: falti/dotenv-action@v1
+      with:
+        path: .github/workflows/env
+        log-variables: true
+
+    - name: Set up Go ${{ steps.dotenv.outputs.go_version }}
       uses: actions/setup-go@v6
       with:
-        go-version: '>=1.26.0'
+        go-version: ${{ steps.dotenv.outputs.go_version }}
         check-latest: true
+        cache: true
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL

.github/workflows/build.yml

@@ -1,4 +1,4 @@
-name: Documentation Build
+name: Build Documentation
 
 on:
   workflow_dispatch:
@@ -23,10 +23,19 @@ jobs:
           submodules: true  # Fetch Hugo themes (true OR recursive)
           fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod
 
-      - name: Set up Go
+      - name: Dotenv Action
+        id: dotenv
+        uses: falti/dotenv-action@v1
+        with:
+          path: .github/workflows/env
+          log-variables: true
+
+      - name: Set up Go ${{ steps.dotenv.outputs.go_version }}
         uses: actions/setup-go@v6
         with:
-          go-version: ~1.26
+          go-version: ${{ steps.dotenv.outputs.go_version }}
+          check-latest: true
+          cache: true
 
       - name: Check configuration snippets in documentation
         run: go run ./config/checkdoc -r docs/content -i changelog.md

.github/workflows/codeql.yml

@@ -8,6 +8,7 @@ on:
 
 jobs:
   goreleaser:
+    name: Rebuild docker image
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -21,11 +22,19 @@ jobs:
           export LATEST_TAG=`git describe --tags --abbrev=0`
           git checkout $LATEST_TAG
 
-      - name: Set up Go
+      - name: Dotenv Action
+        id: dotenv
+        uses: falti/dotenv-action@v1
+        with:
+          path: .github/workflows/env
+          log-variables: true
+
+      - name: Set up Go ${{ steps.dotenv.outputs.go_version }}
         uses: actions/setup-go@v6
         with:
-          go-version: ~1.26
+          go-version: ${{ steps.dotenv.outputs.go_version }}
           check-latest: true
+          cache: true
 
       - name: Set up QEMU
         uses: docker/setup-qemu-action@v4

.github/workflows/doc.yml

@@ -0,0 +1,2 @@
+go_version=1.26
+lint_version=v2.11.4

.github/workflows/docker.yml

@@ -0,0 +1,25 @@
+name: Test on FreeBSD
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ master ]
+    paths-ignore:
+      - 'docs/**'
+
+  pull_request:
+    types: [opened, synchronize, reopened]
+    paths-ignore:
+      - 'docs/**'
+
+jobs:
+  build:
+    name: Run tests
+    strategy:
+      matrix:
+        freebsd_version: ['14.3', '15.0']
+    uses: ./.github/workflows/run-tests-vm.yml
+    with:
+      os: 'freebsd'
+      os_version: '${{ matrix.freebsd_version }}'
+    secrets: inherit

.github/workflows/env

@@ -0,0 +1,20 @@
+name: Test on macOS
+
+on:
+  push:
+    branches: [ master ]
+    paths-ignore:
+      - 'docs/**'
+
+  pull_request:
+    types: [opened, synchronize, reopened]
+    paths-ignore:
+      - 'docs/**'
+
+jobs:
+  build:
+    name: Build and run tests on macOS
+    uses: ./.github/workflows/run-tests-os.yml
+    with:
+      os: 'macos-latest'
+    secrets: inherit

.github/workflows/freebsd.yml

@@ -0,0 +1,25 @@
+name: Test on NetBSD
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ master ]
+    paths-ignore:
+      - 'docs/**'
+
+  pull_request:
+    types: [opened, synchronize, reopened]
+    paths-ignore:
+      - 'docs/**'
+
+jobs:
+  build:
+    name: Run tests
+    strategy:
+      matrix:
+        netbsd_version: ['10.1']
+    uses: ./.github/workflows/run-tests-vm.yml
+    with:
+      os: 'netbsd'
+      os_version: '${{ matrix.netbsd_version }}'
+    secrets: inherit

.github/workflows/macos.yml

@@ -0,0 +1,25 @@
+name: Test on OpenBSD
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ master ]
+    paths-ignore:
+      - 'docs/**'
+
+  pull_request:
+    types: [opened, synchronize, reopened]
+    paths-ignore:
+      - 'docs/**'
+
+jobs:
+  build:
+    name: Run tests
+    strategy:
+      matrix:
+        openbsd_version: ['7.8']
+    uses: ./.github/workflows/run-tests-vm.yml
+    with:
+      os: 'openbsd'
+      os_version: '${{ matrix.openbsd_version }}'
+    secrets: inherit