Merge branch 'feat-r1b' into 'main'

Push feat-rb1 to main - pending release 0.3.x

See merge request powershell/commitfusion!1

Author: gsnow

.github/workflows/converalls-report.yml

@@ -0,0 +1,33 @@
+name: Test Coveralls
+
+on:
+  push:
+    branches:
+      - main  # Replace with the main branch name if needed
+  pull_request:
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+
+      - name: Set up Node.js 16.x
+        uses: actions/setup-node@v2
+        with:
+          node-version: '16.x'
+
+      - name: Install npm dependencies
+        run: npm install
+
+      - name: Run tests and generate coverage report
+        run: make test-coverage
+
+      - name: Upload coverage report to Coveralls
+        env:
+          COVERALLS_REPO_TOKEN: ${{ secrets.COVERALLS_REPO_TOKEN }}
+        run: |
+          npm install -g coveralls
+          coveralls

.github/workflows/jekyll-gh-pages.yml

@@ -0,0 +1,51 @@
+# Sample workflow for building and deploying a Jekyll site to GitHub Pages
+name: Deploy Jekyll with GitHub Pages dependencies preinstalled
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+      - name: Setup Pages
+        uses: actions/configure-pages@v3
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./docs
+          destination: ./_site
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v2
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v2

.gitignore

@@ -1,2 +1,4 @@
 test/
-dist/
+dist/
+docs/_site/
+CHANGELOG-Test.md

.gitlab-ci.yml

@@ -1,42 +1,161 @@
-# author: mnoxx @ proton me
-# date: Saturday, 24 September 2022 2:24:20 AM
-# version: v1.0
-# env: powershell(5.x), pwsh(7.x)
 stages:
-  - build # dependancies
-  - pester # pester test script
-  - test_pwsh # test powershell core latest
-  - test_powershell # test powershell
-  - deploy_psprivate # deploy to psgallary private instance
-  - deploy_psgallary # deploy to psgallary
-build-job:
+  - tests
+  - build
+  - deploylocal
+  - deploy
+  - release
+
+pester_test:
+  stage: tests
+  tags:
+    - windows
+  script:
+    - pwsh
+    - install-module -name 'pester' -RequiredVersion '5.5.0' -Repository 'psgallery' -confirm:$false
+    - Import-Module -name pester -RequiredVersion '5.5.0'
+    - invoke-Pester -Script .\test\Test-Unit-Pester.ps1 -CI || exit 1
+
+# Pester Test Stage
+pester_test_coverage:
+  stage: tests
+  tags:
+    - windows
+  script:
+    - pwsh
+    - install-module -name 'pester' -RequiredVersion '5.5.0' -Repository 'psgallery' -confirm:$false
+    - Import-Module -name pester -RequiredVersion '5.5.0'
+    - invoke-Pester -Script .\build\bt0-ci-test-pester.ps1 -CI || exit 1
+  artifacts:
+    paths:
+    - ./coverage.xml
+
+# Script Analyzer Test Stage
+script_analyzer:
+  stage: tests
+  tags:
+    - windows
+  script:
+    - pwsh
+    - find-module -name PSScriptAnalyzer -Repository PSGallery | install-module -Scope CurrentUser -Force -SkipPublisherCheck
+    - Import-Module -Name PSScriptAnalyzer   
+    - .\build\bt1-p2-ci-test-pssa.ps1
+  artifacts:
+    paths:
+    - ./coverage.xml
+
+# Build Module Stage
+build_module:
   stage: build
+  tags:
+    - windows
+  rules:
+    - if: '$CI_BUILD_STAGE == "tests" && $CI_BUILD_STATUS == "success"'
+  script:
+    - pwsh
+    - Find-Module -name 'psmpacker' -repository 'powershell' | install-Module -force
+    - import-module -name 'psmpacker'
+    - .\build\bt1-ci-build-module.ps1
+  artifacts:
+    paths:
+    - ./dist/*
+    - ./coverage.xml
+
+# Create Nuget Package Stage
+create_nuget:
+  stage: build
+  tags:
+    - windows
+  rules:
+    - if: '$CI_BUILD_STAGE == "tests" && $CI_BUILD_STATUS == "success"'
   script:
     - pwsh.exe
-    - write-host -f green "template ci\cd config successfull"
-pester-job:
-  stage: pester
+    - find-Module -Repository 'powershell' -Name 'nupsforge' | Install-module -force
+    - Import-Module -Name 'nupsforge' -force
+    - .\build\bt2-ci-create-packages.ps1
+  artifacts:
+    paths:
+    - ./dist/*
+    - ./coverage.xml
+
+# Deploy GitLab Package Stage
+deploy_gitlab:
+  stage: deploylocal
+  tags:
+    - windows
   script:
     - pwsh.exe
-    - write-host -f green "template ci\cd config successfull"
-test-pwsh-job:
-  stage: test_pwsh
+    - .\build\bt3-ci-deploy-pushtogitlab.ps1
+  rules:
+    - if: '$CI_BUILD_STAGE == "build" && $CI_BUILD_STATUS == "success"'
+  artifacts:
+    paths:
+    - ./dist/*
+    - ./coverage.xml
+
+# Deploy Proget Packages Stage
+deploy_proget:
+  stage: deploylocal
+  tags:
+    - windows
   script:
     - pwsh.exe
-    - write-host -f green "template ci\cd config successfull"
-test-powershell-job:
-  stage: test_powershell
+    - .\build\bt4-ci-deploy-pushtoproget.ps1
+  rules:
+    - if: '$CI_BUILD_STAGE == "build" && $CI_BUILD_STATUS == "success"'
+  artifacts:
+    paths:
+    - ./dist/*
+    - ./coverage.xml
+
+# Deploy Chocolatey Package Stage
+deploy_chocolatey:
+  stage: deploy
+  tags:
+    - windows
   script:
-    - powershell.exe
-    - write-host -f green "template ci\cd config successfull"
-psgallary-deploy-job:
-  stage: deploy_psgallary
+    - pwsh.exe
+    - .\build\BT5-CI-deploy-PushToChoco.ps1
+  rules:
+    - if: '$CI_COMMIT_BRANCH == "main" && $CI_BUILD_STAGE == "deploylocal" && $CI_BUILD_STATUS == "success"'
+  artifacts:
+    paths:
+    - ./dist/*
+    - ./coverage.xml
+
+# Deploy PSGallary Package Stage
+deploy_psgallary:
+  stage: deploy
+  tags:
+    - windows
   script:
     - pwsh.exe
-psprivate-deploy-job:
-  stage: deploy_psprivate
+    - .\build\bt6-ci-deploy-psgallary.ps1
+  rules:
+    - if: '$CI_COMMIT_BRANCH == "main" && $CI_BUILD_STAGE == "deploylocal" && $CI_BUILD_STATUS == "success"'
+
+# Create Release Stage
+create_release:
+  stage: release
+  tags:
+    - windows
+  script: 
+    - pwsh.exe
+    - Compress-Archive -Path .\ -DestinationPath Build.gz
+  rules:
+    - if: '$CI_COMMIT_BRANCH == "main" && $CI_BUILD_STAGE == "deploy" && $CI_BUILD_STATUS == "success"'
+  artifacts:
+    paths:
+      - Build.gz
+      - ./dist/*
+
+# Deploy Coverage to Coverails.io Stage
+deploy_coverage:
+  stage: release
+  tags:
+    - windows
   script:
     - pwsh.exe
-    - write-host -f green "template ci\cd config successfull"
-#include:
-#  - template: auto-devops.gitlab-ci.yml
+    - .\bt8-ci-deploy-coveralls-report.ps1
+  rules:
+    - if: '$CI_COMMIT_BRANCH == "main" && $CI_BUILD_STAGE == "deploy" && $CI_BUILD_STATUS == "success"'
+