Module.Taskfile.yaml

# https://taskfile.dev

#Called by the vnbuild system to produce builds for my website
#https://www.vaughnnugent.com/resources/software

#This taskfile performs the build operations for a module, it handles
#git code updates, msbuild on solutions, and sleet NuGet feed pushes.

#this file must be in the same directory as the solution file

version: '3'

vars:
  ARCHIVE_FILE_NAME: '{{ .ARCHIVE_FILE_NAME | default "archive.tgz" }}'

tasks:

  default:
    desc: 'Builds the managed libraries in this module for development'
    cmds:
      - cmd: dotnet build -c debug {{ .CLI_ARGS }}

  #called by build pipeline to sync repo
  update:
    cmds:
     - cmd: git reset --hard  #clean up any local changes
     - cmd: git remote update
     - cmd: git pull origin {{ .BRANCH_NAME }} --verify-signatures 
  
  tag-current-commit:
    desc: 'Tags the current commit with the current build version from gitversion'  
    vars:
    #get the current build version from gitversion
      BUILD_VERSION:
        sh: dotnet gitversion /showvariable FullSemver
    #ensure the current branch is master
    status:
      #see if tag already exists otherwise error on windows
      - git tag --list v{{ .BUILD_VERSION }} | findstr . >nul
    cmds:
     - cmd: echo "Tagging current commit with version v{{ .BUILD_VERSION }}"
     - cmd: git tag -s -a v{{ .BUILD_VERSION }} -m "CI Build version {{ .BUILD_VERSION }}"
     - cmd: git push origin v{{ .BUILD_VERSION }}
  
  configure-dep:
    desc: 'CI task to clone a dependency repo at a specific branch and version and initialzies it'
    dir: '{{ .USER_WORKING_DIR }}'
    requires:
      vars: [DEP_REPO, DEP_REVISION]
    vars:
      DEP_BRANCH: '{{ splitList "/" .DEP_REVISION | first }}'
      DEP_VERSION: '{{ splitList "/" .DEP_REVISION | last }}'
      IMPLICIT_DIR: '{{ splitList "/" .DEP_REPO | last }}'
      DEP_DIR: '{{ default .IMPLICIT_DIR .DEP_DIR }}'
    cmds:
      - cmd: git clone {{ .DEP_REPO }} --single-branch --branch {{ .DEP_BRANCH }} {{ .DEP_DIR }}
      - cmd: cd {{ .DEP_DIR }} && git fetch --tags 
      - cmd: cd {{ .DEP_DIR }} && git reset --hard {{ .DEP_VERSION }} 
      - cmd: cd {{ .DEP_DIR }} && dotnet gitversion /updateprojectfiles
  
#called by build pipeline to build module
  build:
    desc: "Used by vnbuild to build the entire module at CI time"
    vars:
      PACK_OUT: '{{ .OUTPUT_DIR }}/{{ .HEAD_SHA }}/pkg'
      INT_DIR: '{{ .SCRATCH_DIR }}/obj/{{ .MODULE_NAME }}/'
      MS_ARGS: '
        --nologo
        /p:UseCommonOutputDirectory=true 
        /p:IntermediateOutputPath="{{ .INT_DIR }}"'
    cmds:
     - cmd: echo "building module {{ .MODULE_NAME }}" 
       silent: true

     #re-write semver after hard reset
     - cmd: dotnet gitversion /updateprojectfiles

     #build debug mode first
     - cmd: dotnet publish -c debug {{ .MS_ARGS }}
     - cmd: dotnet publish -c release {{ .MS_ARGS }}

     # ONLY Pack release config with debug symbols
     # pack can be run without build or restore because the previous commands build it
     - cmd: dotnet pack 
        --no-build 
        --no-restore
        --include-symbols
        --configuration release
        --output "{{ .PACK_OUT }}/release/"
        {{ .MS_ARGS }}

  publish:
    desc: "Used by vnbuild to prepare the packages for build servers"      
    cmds:
     #git archive in the module directory
     - cmd: git archive --format {{ .ARCHIVE_FILE_FORMAT }} --output {{ .ARCHIVE_FILE_NAME }} HEAD

  test:
    desc: "Runs managed tests against the entire solution and all loaded test projects"
    vars:
      NATIVE_BUILD_PATH: 'build/{{ OS }}/{{ if eq OS "windows"}}Debug/{{end}}'
      LIB_PREFIX: '{{ if eq OS "windows"}}vnlib{{else}}libvn{{end}}'
      CONFIG_DIR: '{{ .USER_WORKING_DIR }}/tests/config'
      ARGON2_LIB_PATH: '{{ .USER_WORKING_DIR }}/../core/lib/Utils.Cryptography/argon2/{{ .NATIVE_BUILD_PATH }}argon2'
    cmds:
     - cmd: dotnet build 
        --configuration debug 
        --nologo 
        --verbosity normal
        --no-incremental

     - cmd: dotnet test
        --logger "console;verbosity=detailed"
        --no-build
        --nologo
        --configuration debug
        --verbosity normal
        --framework {{ .TARGET_FRAMEWORK | default "net8.0" }}
        --environment TEST_CONFIG_DIR="{{ .CONFIG_DIR }}"
        --environment VNLIB_ARGON2_DLL_PATH="{{ .ARGON2_LIB_PATH }}"
        {{ .CLI_ARGS }}

#called by build pipeline to clean module
  clean:
    desc: "Used by vnbuild to clean the entire module"
    ignore_error: true
    cmds:
    #clean solution
     - cmd: dotnet clean
     - cmd: rm -f '{{ .ARCHIVE_FILE_NAME }}'


  npm-update:
    desc: "Updates npm dependencies for all npm projects in the module"
    cmds:
     - cmd: cd lib/vnlib.browser && npm update
     - cmd: cd tests/api-tests && npm update
  
  write-changelog:
    cmds:
     - cmd: git-cliff
         --verbose
         --config ci/cliff.toml
         --output 'CHANGELOG.md'
         --tag v{{ .VERSION }}
         {{ .CLI_ARGS }}