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" }}'
  MS_ARGS: 
    /p:RunAnalyzersDuringBuild=false
    /p:BuildInParallel=true 
    /p:MultiProcessorCompilation=true 
    /p:ErrorOnDuplicatePublishOutputFiles=false

  # the directories where native projects exist and need to be built
  # (compress must come after rpmalloc because it's a dep)
  NATIVE_LIB_DIRS: '
    lib/Utils.Memory/vnlib_rpmalloc
    lib/Utils.Memory/vnlib_mimalloc
    lib/Utils.Cryptography/monocypher
    lib/Utils.Cryptography/argon2
    lib/Net.Compression/vnlib_compress'

tasks:

  default:
    desc: 'Builds the managed libraries in this module for development'
    cmds:
     - cmd: dotnet build -c debug {{ .MS_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 

#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: '
        {{ .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.exe /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/" 
        -p:PackageVersion={{ .BUILD_VERSION }}
        {{ .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}}'
      #these are native library paths produced when the child modules are built
      RPMALLOC_LIB_PATH: '{{ .USER_WORKING_DIR }}/lib/Utils.Memory/vnlib_rpmalloc/{{ .NATIVE_BUILD_PATH }}{{ .LIB_PREFIX }}_rpmalloc'
      MIMALLOC_LIB_PATH: '{{ .USER_WORKING_DIR }}/lib/Utils.Memory/vnlib_mimalloc/{{ .NATIVE_BUILD_PATH}}{{ .LIB_PREFIX }}_mimalloc'
      VNCOMPRESS_LIB_PATH: '{{ .USER_WORKING_DIR }}/lib/Net.Compression/vnlib_compress/{{ .NATIVE_BUILD_PATH }}{{ .LIB_PREFIX }}_compress'
      MONOCYPHER_LIB_PATH: '{{ .USER_WORKING_DIR }}/lib/Utils.Cryptography/monocypher/{{ .NATIVE_BUILD_PATH }}{{ .LIB_PREFIX }}_monocypher'
      ARGON2_LIB_PATH: '{{ .USER_WORKING_DIR }}/lib/Utils.Cryptography/argon2/{{ .NATIVE_BUILD_PATH }}argon2'
    cmds:
     - cmd: echo "Ensure you have run 'task dev-init' before running tests to build native libraries"
       silent: true
     - cmd: dotnet test
        {{ .CLI_ARGS }}
        --configuration debug
        --verbosity normal
        --framework {{ .FRAMEWORK | default "net8.0" }}        
        --environment VNLIB_SHARED_HEAP_DIAGNOSTICS="1"
        --environment TEST_RPMALLOC_LIB_PATH="{{ .RPMALLOC_LIB_PATH }}"
        --environment TEST_MIMALLOC_LIB_PATH="{{ .MIMALLOC_LIB_PATH }}"
        --environment VNLIB_COMPRESS_DLL_PATH="{{ .VNCOMPRESS_LIB_PATH }}"
        --environment VNLIB_MONOCYPHER_DLL_PATH="{{ .MONOCYPHER_LIB_PATH }}"
        --environment VNLIB_ARGON2_DLL_PATH="{{ .ARGON2_LIB_PATH }}"

#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 /p:BuildInParallel=true /p:MultiProcessorCompilation=true
     - cmd: powershell rm '{{ .ARCHIVE_FILE_NAME }}' --Force 

  dev-init:
    desc: 'Configures the module for local development'
    cmds:
     #build native libs for development
     - for: { var: NATIVE_LIB_DIRS }
       cmd: cd '{{ .ITEM }}' && task dev-init

     - cmd: dotnet restore

     - cmd: echo "Module developer initialization complete"
       silent: true

  run-dev-init:
    internal: true
    cmds:
     - cmd: cd '{{ .ITEM }}' && task dev-init

  clean-native:
    desc: 'Cleans the native libraries for the module'
    cmds:
     - for: { var: NATIVE_LIB_DIRS }
       cmd: cd {{ .ITEM }} && task clean