add github workflows for unit spec tests

Author: h0tw1r3

.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: "ci"
+
+on:
+  pull_request:
+    branches:
+      - "main"
+    paths-ignore:
+      - '**.md'
+      - 'examples/**'
+      - 'LICENSE'
+      - 'CODEOWNERS'
+      - 'AUTHORS'
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  Spec:
+    uses: ./.github/workflows/module_ci.yml
+    secrets: inherit

.github/workflows/module_ci.yml

@@ -0,0 +1,86 @@
+# This is a generic workflow for Puppet module CI operations.
+name: "Module CI"
+
+on:
+  workflow_call:
+    inputs:
+      runs_on:
+        description: "The operating system used for the runner."
+        required: false
+        default: "ubuntu-latest"
+        type: "string"
+      flags:
+        description: "Additional flags to pass to matrix_from_metadata_v2."
+        required: false
+        default: ''
+        type: "string"
+
+jobs:
+  setup_matrix:
+    name: "Setup Test Matrix"
+    runs-on: ${{ inputs.runs_on }}
+    outputs:
+      spec_matrix: ${{ steps.get-matrix.outputs.spec_matrix }}
+
+    steps:
+
+      - name: "Checkout"
+        uses: "actions/checkout@v4"
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+
+      - name: "Setup ruby"
+        uses: "ruby/setup-ruby@v1"
+        with:
+          ruby-version: "2.7"
+          bundler-cache: true
+
+      - name: "Bundle environment"
+        run: |
+          echo ::group::bundler environment
+          bundle env
+          echo ::endgroup::
+
+      - name: Setup Spec Test Matrix
+        id: get-matrix
+        run: |
+          bundle exec matrix_from_metadata_v2 ${{ inputs.flags }}
+
+  spec:
+    name: "Spec tests (Puppet: ${{matrix.puppet_version}}, Ruby Ver: ${{matrix.ruby_version}})"
+    needs: "setup_matrix"
+    runs-on: ${{ inputs.runs_on }}
+    strategy:
+      fail-fast: false
+      matrix: ${{ fromJson( needs.setup_matrix.outputs.spec_matrix ) }}
+
+    env:
+      PUPPET_GEM_VERSION: ${{ matrix.puppet_version }}
+      FACTER_GEM_VERSION: 'https://github.com/puppetlabs/facter#main'  # why is this set?
+
+    steps:
+      - name: "Checkout"
+        uses: "actions/checkout@v4"
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+
+      - name: "Setup ruby"
+        uses: "ruby/setup-ruby@v1"
+        with:
+          ruby-version: ${{matrix.ruby_version}}
+          bundler-cache: true
+
+      - name: "Bundle environment"
+        run: |
+          echo ::group::bundler environment
+          bundle env
+          echo ::endgroup::
+
+      - name: "Run Static & Syntax Tests"
+        run: |
+          bundle exec rake syntax lint metadata_lint check:symlinks check:git_ignore check:dot_underscore check:test_file rubocop
+          bundle exec dependency-checker metadata.json || true # temporarily allow to fail
+
+      - name: "Run tests"
+        run: |
+          bundle exec rake parallel_spec

.rspec_parallel

@@ -0,0 +1 @@
+--format progress

.rubocop.yml

@@ -7,6 +7,7 @@ AllCops:
   TargetRubyVersion: '2.6'
   Include:
   - "**/*.rb"
+  - "**/*.rake"
   Exclude:
   - bin/*
   - ".vendor/**/*"

.sync.yml

@@ -3,6 +3,8 @@
   default_configs:
     AllCops:
       NewCops: enable
+      Include:
+        - '**/*.rake'
 .pdkignore:
   paths:
     - /.*.yml

rakelib/common.rake

@@ -0,0 +1,33 @@
+require 'dependency_checker'
+require 'metadata_json_lint'
+
+# PDK validate behaviors
+MetadataJsonLint.options.fail_on_warnings = true
+MetadataJsonLint.options.strict_license = true
+MetadataJsonLint.options.strict_puppet_version = true
+MetadataJsonLint.options.strict_dependencies = true
+
+PuppetLint.configuration.log_forat = '%{path}:%{line}:%{check}:%{KIND}:%{message}'
+PuppetLint.configuration.fail_on_warnings = true
+
+desc 'Run dependency-checker'
+task :metadata_deps do
+  dpc = DependencyChecker::Runner.new
+  dpc.resolve_from_files(['metadata.json'])
+  dpc.run
+  raise 'dependency checker failed' unless dpc.problems.zero?
+end
+
+# output task execution
+unless Rake.application.options.trace
+  setup = ->(task, *_args) do
+    puts "===> rake: #{task}"
+  end
+
+  task :log_hooker do
+    Rake::Task.tasks.reject { |t| t.to_s == 'log_hooker' }.each do |a_task|
+      a_task.actions.prepend(setup)
+    end
+  end
+  Rake.application.top_level_tasks.prepend(:log_hooker)
+end