Improve opening description in README.

Removed the setting of the 'useConfigFile' input in example 2 as the input now has the correct default set.

.editorconfig

@@ -0,0 +1,16 @@
+# http://editorconfig.org
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.yml]
+indent_size = 2
+
+[*.md]
+indent_size = 2

.eslintrc.js

@@ -1,14 +0,0 @@
-module.exports = {
-    root: true,
-    parser: '@typescript-eslint/parser',
-    plugins: [
-        '@typescript-eslint',
-        'sort-keys-fix'
-    ],
-    extends: [
-        'eslint:recommended',
-        'plugin:@typescript-eslint/eslint-recommended',
-        'plugin:@typescript-eslint/recommended',
-        'prettier/@typescript-eslint',
-    ],
-};

.github/dependabot.yml

@@ -0,0 +1,7 @@
+version: 2
+updates:
+- package-ecosystem: npm
+  directory: "/"
+  schedule:
+    interval: daily
+  open-pull-requests-limit: 10

.github/stale.yml

@@ -0,0 +1,18 @@
+# Number of days of inactivity before an issue becomes stale
+daysUntilStale: 90
+# Number of days of inactivity before a stale issue is closed
+daysUntilClose: 30
+# Issues with these labels will never be considered stale
+exemptLabels:
+  - pinned
+  - security
+  - bug
+# Label to use when marking an issue as stale
+staleLabel: stale
+# Comment to post when marking an issue as stale. Set to `false` to disable
+markComment: >
+  This issue has been automatically marked as stale because it has not had
+  recent activity. After 30 days from now, it will be closed if no further
+  activity occurs. Thank you for your contributions.
+# Comment to post when closing a stale issue. Set to `false` to disable
+closeComment: false

.github/workflows/ci.yml

@@ -1,5 +1,12 @@
 name: CI
-on: [push, pull_request]
+on:
+  push:
+    branches:
+    - master
+
+  pull_request:
+    branches:
+    - master
 
 jobs:
   build:
@@ -16,13 +23,14 @@ jobs:
         git fetch --prune --unshallow
     - run: |
         npm install
-        npm run build:github 
+        npm run format-check
+        npm run build:github
         npm run build:azure
       name: Build code
     - name: Install GitVersion
       uses: ./gitversion/setup
       with:
-        versionSpec: '5.1.2'
+        versionSpec: '5.x'
     - name: Use GitVersion
       id: gitversion # step id used as reference for output values
       uses: ./gitversion/execute

.github/workflows/release.yml

@@ -17,13 +17,16 @@ jobs:
         git fetch --prune --unshallow
     - run: |
         npm install
-        npm run build:github 
+        npm run build:github
         npm run build:azure
+
+        # npm run compress:github
+        # npm run compress:azure
       name: Build code
     - name: Install GitVersion
       uses: ./gitversion/setup
       with:
-        versionSpec: '5.1.2'
+        versionSpec: '5.x'
     - name: Use GitVersion
       id: gitversion # step id used as reference for output values
       uses: ./gitversion/execute
@@ -32,11 +35,13 @@ jobs:
         $version = "${{steps.gitversion.outputs.majorMinorPatch}}.$date"
         $major = "${{steps.gitversion.outputs.major}}"
         $minor = "${{steps.gitversion.outputs.minor}}"
+        $patch = "${{steps.gitversion.outputs.patch}}"
 
         . .\dist\azure\update-version.ps1
         update-manifest .\dist\azure\vss-extension.json -Version $version
-        dir -r .\dist\**\task.json | % { update-task $_ -Major $major -Minor $minor }
+        dir -r .\dist\**\task.json | % { update-task $_ -Major $major -Minor $minor -Patch $patch }
 
         npm run publish:azure -- --token ${{ secrets.TFX_TOKEN }}
+
       shell: pwsh
       name: Publish Azure extension

.prettierignore

@@ -0,0 +1,2 @@
+node_modules/
+src/*/node_modules/

.prettierrc.json

@@ -0,0 +1,11 @@
+{
+    "printWidth": 80,
+    "tabWidth": 4,
+    "useTabs": false,
+    "semi": false,
+    "singleQuote": true,
+    "trailingComma": "none",
+    "bracketSpacing": true,
+    "arrowParens": "avoid",
+    "parser": "typescript"
+}

README.md

@@ -2,88 +2,28 @@
 
 ![GitTools](docs/icon.png "GitTools")
 
-GitHub Actions that allow to install and use the GitVersion and GitReleaseManager tools
+GitHub Actions that allow the setup and use of the [GitVersion](https://github.com/GitTools/GitVersion) and [GitReleaseManager](https://github.com/GitTools/GitReleaseManager) tools.
 
 [![Build Status](https://github.com/GitTools/actions/workflows/CI/badge.svg)](https://github.com/GitTools/actions/actions)
 [![Build Status](https://github.com/GitTools/actions/workflows/release/badge.svg)](https://github.com/GitTools/actions/actions)
 
+[![GitHub Release](https://img.shields.io/github/v/release/gittools/actions?logo=github&sort=semver)](https://github.com/GitTools/actions/releases/latest)
+
+[![Azure Pipelines Task](https://img.shields.io/badge/marketplace-gittools.gittools-blue?logo=azure-pipelines)](https://marketplace.visualstudio.com/items?itemName=gittools.gittools)
+[![Github Action](https://img.shields.io/badge/marketplace-use--actions-blue?logo=github)](https://github.com/marketplace/actions/gittools)
+
 ## Usage
 
-See [setup](gitversion/setup/action.yml) and [usage](gitversion/execute/action.yml) for GitVersion
+### GitVersion
 
-and [setup](gitreleasemanager/setup/action.yml) for GitReleaseManager
+Examples for usage of **GitVersion**:
 
-## Dependency
+- [GitHub Actions](docs/examples/github/gitversion/index.md)
+- [Azure Pipelines tasks](docs/examples/azure/gitversion/index.md)
 
-There are two step dependencies that are required in your workflow before running this action. You must checkout your Git repository and then fetch the master branch and tags.
+### GitReleaseManager
 
-```yaml
+Examples for usage of **GitReleaseManager**:
-    steps:
-    - name: Checkout
-      uses: actions/checkout@v2
-    - name: Fetch all history for all tags and branches
-      run: git fetch --prune --unshallow
-```
 
-Basic:
+- [GitHub Actions](docs/examples/github/gitreleasemanager/index.md)
-
+- [Azure Pipelines tasks](docs/examples/azure/gitreleasemanager/index.md)
-```yaml
-    steps:
-    - name: Checkout
-      uses: actions/checkout@v2
-    - name: Fetch all history for all tags and branches
-      run: git fetch --prune --unshallow
-    - name: Install GitVersion
-      uses: gittools/actions/gitversion/setup@v0.6.1
-      with:
-          versionSpec: '5.1.x'
-    - name: Use GitVersion
-      id: gitversion # step id used as reference for output values
-      uses: gittools/actions/gitversion/execute@v0.6.1
-    - run: |
-        echo "Major: ${{ steps.gitversion.outputs.major }}"
-        echo "Minor: ${{ steps.gitversion.outputs.minor }}"
-        echo "Patch: ${{ steps.gitversion.outputs.patch }}"
-        echo "PreReleaseTag: ${{ steps.gitversion.outputs.preReleaseTag }}"
-        echo "PreReleaseTagWithDash: ${{ steps.gitversion.outputs.preReleaseTagWithDash }}"
-        echo "PreReleaseLabel: ${{ steps.gitversion.outputs.preReleaseLabel }}"
-        echo "PreReleaseNumber: ${{ steps.gitversion.outputs.preReleaseNumber }}"
-        echo "WeightedPreReleaseNumber: ${{ steps.gitversion.outputs.weightedPreReleaseNumber }}"
-        echo "BuildMetaData: ${{ steps.gitversion.outputs.buildMetaData }}"
-        echo "BuildMetaDataPadded: ${{ steps.gitversion.outputs.buildMetaDataPadded }}"
-        echo "FullBuildMetaData: ${{ steps.gitversion.outputs.fullBuildMetaData }}"
-        echo "MajorMinorPatch: ${{ steps.gitversion.outputs.majorMinorPatch }}"
-        echo "SemVer: ${{ steps.gitversion.outputs.semVer }}"
-        echo "LegacySemVer: ${{ steps.gitversion.outputs.legacySemVer }}"
-        echo "LegacySemVerPadded: ${{ steps.gitversion.outputs.legacySemVerPadded }}"
-        echo "AssemblySemVer: ${{ steps.gitversion.outputs.assemblySemVer }}"
-        echo "AssemblySemFileVer: ${{ steps.gitversion.outputs.assemblySemFileVer }}"
-        echo "FullSemVer: ${{ steps.gitversion.outputs.fullSemVer }}"
-        echo "InformationalVersion: ${{ steps.gitversion.outputs.informationalVersion }}"
-        echo "BranchName: ${{ steps.gitversion.outputs.branchName }}"
-        echo "Sha: ${{ steps.gitversion.outputs.sha }}"
-        echo "ShortSha: ${{ steps.gitversion.outputs.shortSha }}"
-        echo "NuGetVersionV2: ${{ steps.gitversion.outputs.nuGetVersionV2 }}"
-        echo "NuGetVersion: ${{ steps.gitversion.outputs.nuGetVersion }}"
-        echo "NuGetPreReleaseTagV2: ${{ steps.gitversion.outputs.nuGetPreReleaseTagV2 }}"
-        echo "NuGetPreReleaseTag: ${{ steps.gitversion.outputs.nuGetPreReleaseTag }}"
-        echo "VersionSourceSha: ${{ steps.gitversion.outputs.versionSourceSha }}"
-        echo "CommitsSinceVersionSource: ${{ steps.gitversion.outputs.commitsSinceVersionSource }}"
-        echo "CommitsSinceVersionSourcePadded: ${{ steps.gitversion.outputs.commitsSinceVersionSourcePadded }}"
-        echo "CommitDate: ${{ steps.gitversion.outputs.commitDate }}"
-
-```
-
-### Private Repositories
-
-Private repos require credentials before you can fetch the master branch and tags.  
-
-```yaml
-    steps:
-    - name: Checkout
-      uses: actions/checkout@v2
-    - name: Fetch all history for all tags and branches
-      run: |
-        git config remote.origin.url https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}
-        git fetch --prune --unshallow
-```

action.yml

@@ -1,18 +1,9 @@
-name: use-actions
+name: GitTools
-description: GitHub Action for Easy Semantic Versioning with GitVersion. Installs the specific version of GitVersion.Tool
+description: Build tasks for easy semantic versioning for projects using Git and release management.
 author: GitTools
 branding:
   color: gray-dark
   icon: git-pull-request
-inputs:
-  versionSpec:
-    description: Required version in the form of 5.x or exact version like 5.0.0
-    required: true
-    default: ''
-  includePrerelease:
-    description: Include pre-release versions when matching a version 
-    required: false
-    default: false
 runs:
   using: node12
   main: dist/github/setup/index.js

dist/azure/gitreleasemanager/addasset/lib.json

@@ -0,0 +1,46 @@
+{
+    "messages": {
+        "LIB_UnhandledEx": "Unhandled: %s",
+        "LIB_FailOnCode": "Failure return code: %d",
+        "LIB_MkdirFailed": "Unable to create directory '%s'. %s",
+        "LIB_MkdirFailedFileExists": "Unable to create directory '%s'. Conflicting file exists: '%s'",
+        "LIB_MkdirFailedInvalidDriveRoot": "Unable to create directory '%s'. Root directory does not exist: '%s'",
+        "LIB_MkdirFailedInvalidShare": "Unable to create directory '%s'. Unable to verify the directory exists: '%s'. If directory is a file share, please verify the share name is correct, the share is online, and the current process has permission to access the share.",
+        "LIB_MultilineSecret": "Secrets cannot contain multiple lines",
+        "LIB_ProcessError": "There was an error when attempting to execute the process '%s'. This may indicate the process failed to start. Error: %s",
+        "LIB_ProcessExitCode": "The process '%s' failed with exit code %s",
+        "LIB_ProcessStderr": "The process '%s' failed because one or more lines were written to the STDERR stream",
+        "LIB_ReturnCode": "Return code: %d",
+        "LIB_ResourceFileNotExist": "Resource file doesn\\'t exist: %s",
+        "LIB_ResourceFileAlreadySet": "Resource file has already set to: %s",
+        "LIB_ResourceFileNotSet": "Resource file haven\\'t set, can\\'t find loc string for key: %s",
+        "LIB_StdioNotClosed": "The STDIO streams did not close within %s seconds of the exit event from process '%s'. This may indicate a child process inherited the STDIO streams and has not yet exited.",
+        "LIB_WhichNotFound_Linux": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also check the file mode to verify the file is executable.",
+        "LIB_WhichNotFound_Win": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also verify the file has a valid extension for an executable file.",
+        "LIB_LocStringNotFound": "Can\\'t find loc string for key: %s",
+        "LIB_ParameterIsRequired": "%s not supplied",
+        "LIB_InputRequired": "Input required: %s",
+        "LIB_InvalidPattern": "Invalid pattern: '%s'",
+        "LIB_EndpointNotExist": "Endpoint not present: %s",
+        "LIB_EndpointDataNotExist": "Endpoint data parameter %s not present: %s",
+        "LIB_EndpointAuthNotExist": "Endpoint auth data not present: %s",
+        "LIB_InvalidEndpointAuth": "Invalid endpoint auth: %s",
+        "LIB_InvalidSecureFilesInput": "Invalid secure file input: %s",
+        "LIB_PathNotFound": "Not found %s: %s",
+        "LIB_PathHasNullByte": "Path cannot contain null bytes",
+        "LIB_OperationFailed": "Failed %s: %s",
+        "LIB_UseFirstGlobMatch": "Multiple workspace matches. using first.",
+        "LIB_MergeTestResultNotSupported": "Merging test results from multiple files to one test run is not supported on this version of build agent for OSX/Linux, each test result file will be published as a separate test run in VSO/TFS.",
+        "LIB_PlatformNotSupported": "Platform not supported: %s",
+        "TOOL_LIB_CachingTool": "Caching tool: %s %s %s",
+        "_TOOL_LIB_CachingTool.comment": "This informational log message indicates that a tool, that was just downloaded, is being copied into the cache directory. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_Downloading": "Downloading: %s",
+        "_TOOL_LIB_Downloading.comment": "This information log message indicates that a file is being downloaded. %s represents the URL being downloaded.",
+        "TOOL_LIB_ExtractingArchive": "Extracting archive",
+        "_TOOL_LIB_ExtractingArchive.comment": "This informational log message indicates that an archive file is being extracted. For example, a .zip file, .7z file, or .tar.gz file.",
+        "TOOL_LIB_FoundInCache": "Found tool in cache: %s %s %s",
+        "_TOOL_LIB_FoundInCache.comment": "This informational log message indicates that the request tool is already cached, and does not need to be downloaded again. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_PrependPath": "Prepending PATH environment variable with directory: %s",
+        "_TOOL_LIB_PrependPath.comment": "This informational log message indicates that a directory is being prepended to the front of the PATH environment variable. The directories specified by the PATH environment variable are used to resolve the location of command line tools."
+    }
+}

dist/azure/gitreleasemanager/addasset/task.json

@@ -0,0 +1,67 @@
+{
+    "id": "b803651c-21ac-4851-9fbf-c75b0e82e4c5",
+    "name": "gitreleasemanager/addasset",
+    "friendlyName": "Add Asset GitReleaseManager Task",
+    "description": "Tool for creating and exporting releases for software applications hosted on GitHub",
+    "author": "GitTools Contributors",
+    "helpMarkDown": "See the [documentation](https://gittools.github.io/GitReleaseManager/docs/) for help",
+    "category": "Build",
+    "demands": [],
+    "version": {
+        "Major": "1",
+        "Minor": "0",
+        "Patch": "0"
+    },
+    "minimumAgentVersion": "2.115.0",
+    "execution": {
+        "Node": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitreleasemanager/addasset",
+    "inputs": [{
+        "name": "owner",
+        "type": "string",
+        "label": "The owner of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The owner of the repository"
+    }, {
+        "name": "repository",
+        "type": "string",
+        "label": "The name of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the repository"
+    }, {
+        "name": "token",
+        "type": "string",
+        "label": "The access token to access GitHub with",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The access token to access GitHub with"
+    }, {
+        "name": "tagName",
+        "type": "string",
+        "label": "The name of the release",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the release"
+    }, {
+        "name": "assets",
+        "type": "multiLine",
+        "label": "Path(s) to the file(s) to include in the release",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "Path(s) to the file(s) to include in the release. Separated by newline"
+    }, {
+        "name": "targetDirectory",
+        "type": "string",
+        "label": "The directory on which GitReleaseManager should be executed. Defaults to current directory",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The directory on which GitReleaseManager should be executed. Defaults to current directory"
+    }]
+}

dist/azure/gitreleasemanager/close/lib.json

@@ -0,0 +1,46 @@
+{
+    "messages": {
+        "LIB_UnhandledEx": "Unhandled: %s",
+        "LIB_FailOnCode": "Failure return code: %d",
+        "LIB_MkdirFailed": "Unable to create directory '%s'. %s",
+        "LIB_MkdirFailedFileExists": "Unable to create directory '%s'. Conflicting file exists: '%s'",
+        "LIB_MkdirFailedInvalidDriveRoot": "Unable to create directory '%s'. Root directory does not exist: '%s'",
+        "LIB_MkdirFailedInvalidShare": "Unable to create directory '%s'. Unable to verify the directory exists: '%s'. If directory is a file share, please verify the share name is correct, the share is online, and the current process has permission to access the share.",
+        "LIB_MultilineSecret": "Secrets cannot contain multiple lines",
+        "LIB_ProcessError": "There was an error when attempting to execute the process '%s'. This may indicate the process failed to start. Error: %s",
+        "LIB_ProcessExitCode": "The process '%s' failed with exit code %s",
+        "LIB_ProcessStderr": "The process '%s' failed because one or more lines were written to the STDERR stream",
+        "LIB_ReturnCode": "Return code: %d",
+        "LIB_ResourceFileNotExist": "Resource file doesn\\'t exist: %s",
+        "LIB_ResourceFileAlreadySet": "Resource file has already set to: %s",
+        "LIB_ResourceFileNotSet": "Resource file haven\\'t set, can\\'t find loc string for key: %s",
+        "LIB_StdioNotClosed": "The STDIO streams did not close within %s seconds of the exit event from process '%s'. This may indicate a child process inherited the STDIO streams and has not yet exited.",
+        "LIB_WhichNotFound_Linux": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also check the file mode to verify the file is executable.",
+        "LIB_WhichNotFound_Win": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also verify the file has a valid extension for an executable file.",
+        "LIB_LocStringNotFound": "Can\\'t find loc string for key: %s",
+        "LIB_ParameterIsRequired": "%s not supplied",
+        "LIB_InputRequired": "Input required: %s",
+        "LIB_InvalidPattern": "Invalid pattern: '%s'",
+        "LIB_EndpointNotExist": "Endpoint not present: %s",
+        "LIB_EndpointDataNotExist": "Endpoint data parameter %s not present: %s",
+        "LIB_EndpointAuthNotExist": "Endpoint auth data not present: %s",
+        "LIB_InvalidEndpointAuth": "Invalid endpoint auth: %s",
+        "LIB_InvalidSecureFilesInput": "Invalid secure file input: %s",
+        "LIB_PathNotFound": "Not found %s: %s",
+        "LIB_PathHasNullByte": "Path cannot contain null bytes",
+        "LIB_OperationFailed": "Failed %s: %s",
+        "LIB_UseFirstGlobMatch": "Multiple workspace matches. using first.",
+        "LIB_MergeTestResultNotSupported": "Merging test results from multiple files to one test run is not supported on this version of build agent for OSX/Linux, each test result file will be published as a separate test run in VSO/TFS.",
+        "LIB_PlatformNotSupported": "Platform not supported: %s",
+        "TOOL_LIB_CachingTool": "Caching tool: %s %s %s",
+        "_TOOL_LIB_CachingTool.comment": "This informational log message indicates that a tool, that was just downloaded, is being copied into the cache directory. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_Downloading": "Downloading: %s",
+        "_TOOL_LIB_Downloading.comment": "This information log message indicates that a file is being downloaded. %s represents the URL being downloaded.",
+        "TOOL_LIB_ExtractingArchive": "Extracting archive",
+        "_TOOL_LIB_ExtractingArchive.comment": "This informational log message indicates that an archive file is being extracted. For example, a .zip file, .7z file, or .tar.gz file.",
+        "TOOL_LIB_FoundInCache": "Found tool in cache: %s %s %s",
+        "_TOOL_LIB_FoundInCache.comment": "This informational log message indicates that the request tool is already cached, and does not need to be downloaded again. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_PrependPath": "Prepending PATH environment variable with directory: %s",
+        "_TOOL_LIB_PrependPath.comment": "This informational log message indicates that a directory is being prepended to the front of the PATH environment variable. The directories specified by the PATH environment variable are used to resolve the location of command line tools."
+    }
+}

dist/azure/gitreleasemanager/close/task.json

@@ -0,0 +1,60 @@
+{
+    "id": "f5304356-f6e3-48e9-9b65-a9efa41ce7a2",
+    "name": "gitreleasemanager/close",
+    "friendlyName": "Close GitReleaseManager Task",
+    "description": "Tool for creating and exporting releases for software applications hosted on GitHub",
+    "author": "GitTools Contributors",
+    "helpMarkDown": "See the [documentation](https://gittools.github.io/GitReleaseManager/docs/) for help",
+    "category": "Build",
+    "demands": [],
+    "version": {
+        "Major": "1",
+        "Minor": "0",
+        "Patch": "0"
+    },
+    "minimumAgentVersion": "2.115.0",
+    "execution": {
+        "Node": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitreleasemanager/close",
+    "inputs": [{
+        "name": "owner",
+        "type": "string",
+        "label": "The owner of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The owner of the repository"
+    }, {
+        "name": "repository",
+        "type": "string",
+        "label": "The name of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the repository"
+    }, {
+        "name": "token",
+        "type": "string",
+        "label": "The access token to access GitHub with",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The access token to access GitHub with"
+    }, {
+        "name": "milestone",
+        "type": "string",
+        "label": "The milestone to use",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The milestone to use"
+    }, {
+        "name": "targetDirectory",
+        "type": "string",
+        "label": "The directory on which GitReleaseManager should be executed. Defaults to current directory",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The directory on which GitReleaseManager should be executed. Defaults to current directory"
+    }]
+}

dist/azure/gitreleasemanager/create/task.json

@@ -64,7 +64,7 @@
         "required": false,
         "helpMarkDown": "The path to the file to be used as the content of the release notes"
     }, {
-        "name": "pre",
+        "name": "isPreRelease",
         "type": "boolean",
         "label": "Creates the release as a pre-release",
         "defaultValue": "false",

dist/azure/gitreleasemanager/discard/lib.json

@@ -0,0 +1,46 @@
+{
+    "messages": {
+        "LIB_UnhandledEx": "Unhandled: %s",
+        "LIB_FailOnCode": "Failure return code: %d",
+        "LIB_MkdirFailed": "Unable to create directory '%s'. %s",
+        "LIB_MkdirFailedFileExists": "Unable to create directory '%s'. Conflicting file exists: '%s'",
+        "LIB_MkdirFailedInvalidDriveRoot": "Unable to create directory '%s'. Root directory does not exist: '%s'",
+        "LIB_MkdirFailedInvalidShare": "Unable to create directory '%s'. Unable to verify the directory exists: '%s'. If directory is a file share, please verify the share name is correct, the share is online, and the current process has permission to access the share.",
+        "LIB_MultilineSecret": "Secrets cannot contain multiple lines",
+        "LIB_ProcessError": "There was an error when attempting to execute the process '%s'. This may indicate the process failed to start. Error: %s",
+        "LIB_ProcessExitCode": "The process '%s' failed with exit code %s",
+        "LIB_ProcessStderr": "The process '%s' failed because one or more lines were written to the STDERR stream",
+        "LIB_ReturnCode": "Return code: %d",
+        "LIB_ResourceFileNotExist": "Resource file doesn\\'t exist: %s",
+        "LIB_ResourceFileAlreadySet": "Resource file has already set to: %s",
+        "LIB_ResourceFileNotSet": "Resource file haven\\'t set, can\\'t find loc string for key: %s",
+        "LIB_StdioNotClosed": "The STDIO streams did not close within %s seconds of the exit event from process '%s'. This may indicate a child process inherited the STDIO streams and has not yet exited.",
+        "LIB_WhichNotFound_Linux": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also check the file mode to verify the file is executable.",
+        "LIB_WhichNotFound_Win": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also verify the file has a valid extension for an executable file.",
+        "LIB_LocStringNotFound": "Can\\'t find loc string for key: %s",
+        "LIB_ParameterIsRequired": "%s not supplied",
+        "LIB_InputRequired": "Input required: %s",
+        "LIB_InvalidPattern": "Invalid pattern: '%s'",
+        "LIB_EndpointNotExist": "Endpoint not present: %s",
+        "LIB_EndpointDataNotExist": "Endpoint data parameter %s not present: %s",
+        "LIB_EndpointAuthNotExist": "Endpoint auth data not present: %s",
+        "LIB_InvalidEndpointAuth": "Invalid endpoint auth: %s",
+        "LIB_InvalidSecureFilesInput": "Invalid secure file input: %s",
+        "LIB_PathNotFound": "Not found %s: %s",
+        "LIB_PathHasNullByte": "Path cannot contain null bytes",
+        "LIB_OperationFailed": "Failed %s: %s",
+        "LIB_UseFirstGlobMatch": "Multiple workspace matches. using first.",
+        "LIB_MergeTestResultNotSupported": "Merging test results from multiple files to one test run is not supported on this version of build agent for OSX/Linux, each test result file will be published as a separate test run in VSO/TFS.",
+        "LIB_PlatformNotSupported": "Platform not supported: %s",
+        "TOOL_LIB_CachingTool": "Caching tool: %s %s %s",
+        "_TOOL_LIB_CachingTool.comment": "This informational log message indicates that a tool, that was just downloaded, is being copied into the cache directory. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_Downloading": "Downloading: %s",
+        "_TOOL_LIB_Downloading.comment": "This information log message indicates that a file is being downloaded. %s represents the URL being downloaded.",
+        "TOOL_LIB_ExtractingArchive": "Extracting archive",
+        "_TOOL_LIB_ExtractingArchive.comment": "This informational log message indicates that an archive file is being extracted. For example, a .zip file, .7z file, or .tar.gz file.",
+        "TOOL_LIB_FoundInCache": "Found tool in cache: %s %s %s",
+        "_TOOL_LIB_FoundInCache.comment": "This informational log message indicates that the request tool is already cached, and does not need to be downloaded again. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_PrependPath": "Prepending PATH environment variable with directory: %s",
+        "_TOOL_LIB_PrependPath.comment": "This informational log message indicates that a directory is being prepended to the front of the PATH environment variable. The directories specified by the PATH environment variable are used to resolve the location of command line tools."
+    }
+}

dist/azure/gitreleasemanager/discard/task.json

@@ -0,0 +1,60 @@
+{
+    "id": "9ae78b66-6100-4522-8106-b7ae00bbfcdf",
+    "name": "gitreleasemanager/discard",
+    "friendlyName": "Discard GitReleaseManager Task",
+    "description": "Tool for creating and exporting releases for software applications hosted on GitHub",
+    "author": "GitTools Contributors",
+    "helpMarkDown": "See the [documentation](https://gittools.github.io/GitReleaseManager/docs/) for help",
+    "category": "Build",
+    "demands": [],
+    "version": {
+        "Major": "1",
+        "Minor": "0",
+        "Patch": "0"
+    },
+    "minimumAgentVersion": "2.115.0",
+    "execution": {
+        "Node": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitreleasemanager/discard",
+    "inputs": [{
+        "name": "owner",
+        "type": "string",
+        "label": "The owner of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The owner of the repository"
+    }, {
+        "name": "repository",
+        "type": "string",
+        "label": "The name of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the repository"
+    }, {
+        "name": "token",
+        "type": "string",
+        "label": "The access token to access GitHub with",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The access token to access GitHub with"
+    }, {
+        "name": "milestone",
+        "type": "string",
+        "label": "The milestone to use",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The milestone to use"
+    }, {
+        "name": "targetDirectory",
+        "type": "string",
+        "label": "The directory on which GitReleaseManager should be executed. Defaults to current directory",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The directory on which GitReleaseManager should be executed. Defaults to current directory"
+    }]
+}

dist/azure/gitreleasemanager/open/lib.json

@@ -0,0 +1,46 @@
+{
+    "messages": {
+        "LIB_UnhandledEx": "Unhandled: %s",
+        "LIB_FailOnCode": "Failure return code: %d",
+        "LIB_MkdirFailed": "Unable to create directory '%s'. %s",
+        "LIB_MkdirFailedFileExists": "Unable to create directory '%s'. Conflicting file exists: '%s'",
+        "LIB_MkdirFailedInvalidDriveRoot": "Unable to create directory '%s'. Root directory does not exist: '%s'",
+        "LIB_MkdirFailedInvalidShare": "Unable to create directory '%s'. Unable to verify the directory exists: '%s'. If directory is a file share, please verify the share name is correct, the share is online, and the current process has permission to access the share.",
+        "LIB_MultilineSecret": "Secrets cannot contain multiple lines",
+        "LIB_ProcessError": "There was an error when attempting to execute the process '%s'. This may indicate the process failed to start. Error: %s",
+        "LIB_ProcessExitCode": "The process '%s' failed with exit code %s",
+        "LIB_ProcessStderr": "The process '%s' failed because one or more lines were written to the STDERR stream",
+        "LIB_ReturnCode": "Return code: %d",
+        "LIB_ResourceFileNotExist": "Resource file doesn\\'t exist: %s",
+        "LIB_ResourceFileAlreadySet": "Resource file has already set to: %s",
+        "LIB_ResourceFileNotSet": "Resource file haven\\'t set, can\\'t find loc string for key: %s",
+        "LIB_StdioNotClosed": "The STDIO streams did not close within %s seconds of the exit event from process '%s'. This may indicate a child process inherited the STDIO streams and has not yet exited.",
+        "LIB_WhichNotFound_Linux": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also check the file mode to verify the file is executable.",
+        "LIB_WhichNotFound_Win": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also verify the file has a valid extension for an executable file.",
+        "LIB_LocStringNotFound": "Can\\'t find loc string for key: %s",
+        "LIB_ParameterIsRequired": "%s not supplied",
+        "LIB_InputRequired": "Input required: %s",
+        "LIB_InvalidPattern": "Invalid pattern: '%s'",
+        "LIB_EndpointNotExist": "Endpoint not present: %s",
+        "LIB_EndpointDataNotExist": "Endpoint data parameter %s not present: %s",
+        "LIB_EndpointAuthNotExist": "Endpoint auth data not present: %s",
+        "LIB_InvalidEndpointAuth": "Invalid endpoint auth: %s",
+        "LIB_InvalidSecureFilesInput": "Invalid secure file input: %s",
+        "LIB_PathNotFound": "Not found %s: %s",
+        "LIB_PathHasNullByte": "Path cannot contain null bytes",
+        "LIB_OperationFailed": "Failed %s: %s",
+        "LIB_UseFirstGlobMatch": "Multiple workspace matches. using first.",
+        "LIB_MergeTestResultNotSupported": "Merging test results from multiple files to one test run is not supported on this version of build agent for OSX/Linux, each test result file will be published as a separate test run in VSO/TFS.",
+        "LIB_PlatformNotSupported": "Platform not supported: %s",
+        "TOOL_LIB_CachingTool": "Caching tool: %s %s %s",
+        "_TOOL_LIB_CachingTool.comment": "This informational log message indicates that a tool, that was just downloaded, is being copied into the cache directory. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_Downloading": "Downloading: %s",
+        "_TOOL_LIB_Downloading.comment": "This information log message indicates that a file is being downloaded. %s represents the URL being downloaded.",
+        "TOOL_LIB_ExtractingArchive": "Extracting archive",
+        "_TOOL_LIB_ExtractingArchive.comment": "This informational log message indicates that an archive file is being extracted. For example, a .zip file, .7z file, or .tar.gz file.",
+        "TOOL_LIB_FoundInCache": "Found tool in cache: %s %s %s",
+        "_TOOL_LIB_FoundInCache.comment": "This informational log message indicates that the request tool is already cached, and does not need to be downloaded again. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_PrependPath": "Prepending PATH environment variable with directory: %s",
+        "_TOOL_LIB_PrependPath.comment": "This informational log message indicates that a directory is being prepended to the front of the PATH environment variable. The directories specified by the PATH environment variable are used to resolve the location of command line tools."
+    }
+}

dist/azure/gitreleasemanager/open/task.json

@@ -0,0 +1,60 @@
+{
+    "id": "5d437bf5-f193-4449-b531-c4c69eebaa48",
+    "name": "gitreleasemanager/open",
+    "friendlyName": "Open GitReleaseManager Task",
+    "description": "Tool for creating and exporting releases for software applications hosted on GitHub",
+    "author": "GitTools Contributors",
+    "helpMarkDown": "See the [documentation](https://gittools.github.io/GitReleaseManager/docs/) for help",
+    "category": "Build",
+    "demands": [],
+    "version": {
+        "Major": "1",
+        "Minor": "0",
+        "Patch": "0"
+    },
+    "minimumAgentVersion": "2.115.0",
+    "execution": {
+        "Node": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitreleasemanager/open",
+    "inputs": [{
+        "name": "owner",
+        "type": "string",
+        "label": "The owner of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The owner of the repository"
+    }, {
+        "name": "repository",
+        "type": "string",
+        "label": "The name of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the repository"
+    }, {
+        "name": "token",
+        "type": "string",
+        "label": "The access token to access GitHub with",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The access token to access GitHub with"
+    }, {
+        "name": "milestone",
+        "type": "string",
+        "label": "The milestone to use",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The milestone to use"
+    }, {
+        "name": "targetDirectory",
+        "type": "string",
+        "label": "The directory on which GitReleaseManager should be executed. Defaults to current directory",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The directory on which GitReleaseManager should be executed. Defaults to current directory"
+    }]
+}

dist/azure/gitreleasemanager/publish/lib.json

@@ -0,0 +1,46 @@
+{
+    "messages": {
+        "LIB_UnhandledEx": "Unhandled: %s",
+        "LIB_FailOnCode": "Failure return code: %d",
+        "LIB_MkdirFailed": "Unable to create directory '%s'. %s",
+        "LIB_MkdirFailedFileExists": "Unable to create directory '%s'. Conflicting file exists: '%s'",
+        "LIB_MkdirFailedInvalidDriveRoot": "Unable to create directory '%s'. Root directory does not exist: '%s'",
+        "LIB_MkdirFailedInvalidShare": "Unable to create directory '%s'. Unable to verify the directory exists: '%s'. If directory is a file share, please verify the share name is correct, the share is online, and the current process has permission to access the share.",
+        "LIB_MultilineSecret": "Secrets cannot contain multiple lines",
+        "LIB_ProcessError": "There was an error when attempting to execute the process '%s'. This may indicate the process failed to start. Error: %s",
+        "LIB_ProcessExitCode": "The process '%s' failed with exit code %s",
+        "LIB_ProcessStderr": "The process '%s' failed because one or more lines were written to the STDERR stream",
+        "LIB_ReturnCode": "Return code: %d",
+        "LIB_ResourceFileNotExist": "Resource file doesn\\'t exist: %s",
+        "LIB_ResourceFileAlreadySet": "Resource file has already set to: %s",
+        "LIB_ResourceFileNotSet": "Resource file haven\\'t set, can\\'t find loc string for key: %s",
+        "LIB_StdioNotClosed": "The STDIO streams did not close within %s seconds of the exit event from process '%s'. This may indicate a child process inherited the STDIO streams and has not yet exited.",
+        "LIB_WhichNotFound_Linux": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also check the file mode to verify the file is executable.",
+        "LIB_WhichNotFound_Win": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also verify the file has a valid extension for an executable file.",
+        "LIB_LocStringNotFound": "Can\\'t find loc string for key: %s",
+        "LIB_ParameterIsRequired": "%s not supplied",
+        "LIB_InputRequired": "Input required: %s",
+        "LIB_InvalidPattern": "Invalid pattern: '%s'",
+        "LIB_EndpointNotExist": "Endpoint not present: %s",
+        "LIB_EndpointDataNotExist": "Endpoint data parameter %s not present: %s",
+        "LIB_EndpointAuthNotExist": "Endpoint auth data not present: %s",
+        "LIB_InvalidEndpointAuth": "Invalid endpoint auth: %s",
+        "LIB_InvalidSecureFilesInput": "Invalid secure file input: %s",
+        "LIB_PathNotFound": "Not found %s: %s",
+        "LIB_PathHasNullByte": "Path cannot contain null bytes",
+        "LIB_OperationFailed": "Failed %s: %s",
+        "LIB_UseFirstGlobMatch": "Multiple workspace matches. using first.",
+        "LIB_MergeTestResultNotSupported": "Merging test results from multiple files to one test run is not supported on this version of build agent for OSX/Linux, each test result file will be published as a separate test run in VSO/TFS.",
+        "LIB_PlatformNotSupported": "Platform not supported: %s",
+        "TOOL_LIB_CachingTool": "Caching tool: %s %s %s",
+        "_TOOL_LIB_CachingTool.comment": "This informational log message indicates that a tool, that was just downloaded, is being copied into the cache directory. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_Downloading": "Downloading: %s",
+        "_TOOL_LIB_Downloading.comment": "This information log message indicates that a file is being downloaded. %s represents the URL being downloaded.",
+        "TOOL_LIB_ExtractingArchive": "Extracting archive",
+        "_TOOL_LIB_ExtractingArchive.comment": "This informational log message indicates that an archive file is being extracted. For example, a .zip file, .7z file, or .tar.gz file.",
+        "TOOL_LIB_FoundInCache": "Found tool in cache: %s %s %s",
+        "_TOOL_LIB_FoundInCache.comment": "This informational log message indicates that the request tool is already cached, and does not need to be downloaded again. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_PrependPath": "Prepending PATH environment variable with directory: %s",
+        "_TOOL_LIB_PrependPath.comment": "This informational log message indicates that a directory is being prepended to the front of the PATH environment variable. The directories specified by the PATH environment variable are used to resolve the location of command line tools."
+    }
+}

dist/azure/gitreleasemanager/publish/task.json

@@ -0,0 +1,60 @@
+{
+    "id": "b3c54483-4140-45d8-b442-3a0b096b5f7f",
+    "name": "gitreleasemanager/publish",
+    "friendlyName": "Publish GitReleaseManager Task",
+    "description": "Tool for creating and exporting releases for software applications hosted on GitHub",
+    "author": "GitTools Contributors",
+    "helpMarkDown": "See the [documentation](https://gittools.github.io/GitReleaseManager/docs/) for help",
+    "category": "Build",
+    "demands": [],
+    "version": {
+        "Major": "1",
+        "Minor": "0",
+        "Patch": "0"
+    },
+    "minimumAgentVersion": "2.115.0",
+    "execution": {
+        "Node": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitreleasemanager/publish",
+    "inputs": [{
+        "name": "owner",
+        "type": "string",
+        "label": "The owner of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The owner of the repository"
+    }, {
+        "name": "repository",
+        "type": "string",
+        "label": "The name of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the repository"
+    }, {
+        "name": "token",
+        "type": "string",
+        "label": "The access token to access GitHub with",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The access token to access GitHub with"
+    }, {
+        "name": "tagName",
+        "type": "string",
+        "label": "The name of the release",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the release"
+    }, {
+        "name": "targetDirectory",
+        "type": "string",
+        "label": "The directory on which GitReleaseManager should be executed. Defaults to current directory",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The directory on which GitReleaseManager should be executed. Defaults to current directory"
+    }]
+}

dist/azure/overview.md

@@ -2,5 +2,10 @@ Versioning when using Git, solved. GitVersion looks at your Git history and work
 
 It works with most branching strategies but has been designed mainly around GitFlow and GitHubFlow (pull request workflow). The calculated version numbers can then be accessed through variables such as `$(GitVersion.NuGetVersion)` and `$(GitVersion.SemVer)`. It is also very configurable to allow it to work with most release workflows!
 
-![Build Task](https://raw.githubusercontent.com/GitTools/actions/master/dist/azure/images/build-task.png)
+## Azure Pipelines tasks
-![Builds](https://raw.githubusercontent.com/GitTools/actions/master/dist/azure/images/builds.png)
+
+![Azure Pipelines Tasks](images/pipeline-editor-tasks.png)
+
+## Azure Pipelines run examples
+
+![Azure Pipelines Runs](images/builds.png)

dist/azure/update-version.ps1

@@ -10,14 +10,19 @@ function update-task() {
 
     [Parameter(Mandatory=$True, Position=2, ValueFromPipeline=$false)]
     [System.String]
-    $minor
+    $minor,
+
+    [Parameter(Mandatory=$True, Position=3, ValueFromPipeline=$false)]
+    [System.String]
+    $patch
 )
     $file = Resolve-Path $file
     $jqMajor = '.version.Major=\"' + $major +'\"';
     $jqMinor = '.version.Minor=\"' + $minor +'\"';
-    Write-Host "Update task from $file to version $major.$minor"
+    $jqPatch = '.version.Patch=\"' + $patch +'\"';
+    Write-Host "Update task from $file to version $major.$minor.$patch"
 
-    Get-Content $file | jq $jqMajor | jq $jqMinor | Set-Content $file
+    Get-Content $file | jq $jqMajor | jq $jqMinor| jq $jqPatch | Set-Content $file
 }
 
 function update-manifest() {

dist/azure/vss-extension.json

@@ -14,7 +14,13 @@
         { "path": "gitversion/setup" },
         { "path": "gitversion/execute" },
         { "path": "gitreleasemanager/setup" },
-        { "path": "gitreleasemanager/create" }
+        { "path": "gitreleasemanager/create" },
+        { "path": "gitreleasemanager/discard" },
+        { "path": "gitreleasemanager/close" },
+        { "path": "gitreleasemanager/open" },
+        { "path": "gitreleasemanager/publish" },
+        { "path": "gitreleasemanager/addasset" },
+        { "path": "images", "addressable": true }
     ],
     "categories": [
         "Azure Pipelines"
@@ -30,7 +36,8 @@
         "git",
         "versioning",
         "gitflow",
-        "githubflow"
+        "githubflow",
+        "release"
     ],
     "links": {
         "learn": {
@@ -49,11 +56,18 @@
             "uri": "https://github.com/GitTools/actions/issues"
         }
     },
-    "screenshots": [{
+    "screenshots": [
-            "path": "images/builds.png"
+        {
+            "path": "screenshots/pipeline-editor-setup-gitversion-task.png"
         },
         {
-            "path": "images/build-task.png"
+            "path": "screenshots/pipeline-run-setup-gitversion-task.png"
+        },
+        {
+            "path": "screenshots/pipeline-editor-execute-gitversion-task.png"
+        },
+        {
+            "path": "screenshots/pipeline-run-execute-gitversion-task.png"
         }
     ],
     "content": {
@@ -97,5 +111,50 @@
         "properties": {
             "name": "gitreleasemanager/create"
         }
+    }, {
+        "id": "discard-gitreleasemanager-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "name": "gitreleasemanager/discard"
+        }
+    }, {
+        "id": "close-gitreleasemanager-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "name": "gitreleasemanager/close"
+        }
+    }, {
+        "id": "open-gitreleasemanager-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "name": "gitreleasemanager/open"
+        }
+    }, {
+        "id": "publish-gitreleasemanager-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "name": "gitreleasemanager/publish"
+        }
+    }, {
+        "id": "addasset-gitreleasemanager-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "name": "gitreleasemanager/addasset"
+        }
     }]
-}
+}

docs/examples/azure/gitreleasemanager/addasset.md

@@ -0,0 +1,14 @@
+# Example
+
+```yaml
+  steps:
+  - task: gitreleasemanager/addasset@0
+    inputs:
+      token: '$(GITHUB_TOKEN)'
+      owner: 'someOwner'
+      repository: 'someRepo'
+      tagName: '0.1.0'
+      assets: |
+        src/test.txt
+        src/test1.txt
+```

docs/examples/azure/gitreleasemanager/close.md

@@ -0,0 +1,11 @@
+# Example
+
+```yaml
+  steps:
+    - task: gitreleasemanager/close@0
+    inputs:
+      token: '$(GITHUB_TOKEN)'
+      owner: 'someOwner'
+      repository: 'someRepo'
+      milestone: '0.1.0'
+```

docs/examples/azure/gitreleasemanager/create.md

@@ -0,0 +1,16 @@
+# Example
+
+```yaml
+  steps:
+  - task: gitreleasemanager/create@0
+    displayName: Create release with GitReleaseManager
+    inputs:
+      token: $(GITHUB_TOKEN)
+      owner: 'someOwner'
+      repository: 'someRepo'
+      milestone: '0.1.0'
+      name: 'v0.1.0'
+      assets: |
+        src/test.txt
+        src/test1.txt
+```

docs/examples/azure/gitreleasemanager/discard.md

@@ -0,0 +1,11 @@
+# Example
+
+```yaml
+  steps:
+  - task: gitreleasemanager/discard@0
+    inputs:
+      token: '$(GITHUB_TOKEN)'
+      owner: 'someOwner'
+      repository: 'someRepo'
+      milestone: '0.1.0'
+```

docs/examples/azure/gitreleasemanager/index.md

@@ -0,0 +1,11 @@
+# GitReleaseManager Azure DevOps Action
+
+Below you'll find examples of how to do particular actions with GitReleaseManager:
+
+* [Add asset](addasset.md)
+* [Close](close.md)
+* [Create](create.md)
+* [Discard](discard.md)
+* [Open](open.md)
+* [Publish](publish.md)
+* [Setup](setup.md)

docs/examples/azure/gitreleasemanager/open.md

@@ -0,0 +1,11 @@
+# Example
+
+```yaml
+  steps:
+    - task: gitreleasemanager/open@0
+    inputs:
+      token: '$(GITHUB_TOKEN)'
+      owner: 'someOwner'
+      repository: 'someRepo'
+      milestone: '0.1.0'
+```

docs/examples/azure/gitreleasemanager/publish.md

@@ -0,0 +1,11 @@
+# Example
+
+```yaml
+  steps:
+  - task: gitreleasemanager/publish@0
+    inputs:
+      token: '$(GITHUB_TOKEN)'
+      owner: 'someOwner'
+      repository: 'someRepo'
+      tagName: '0.1.0'
+```

docs/examples/azure/gitreleasemanager/setup.md

@@ -0,0 +1,9 @@
+# Example
+
+```yaml
+  steps:
+  - task: gitreleasemanager/setup@0
+    displayName: Install GitReleaseManager
+    inputs:
+      versionSpec: '0.10.x'
+```

docs/examples/azure/gitversion/execute/usage-examples.md

@@ -0,0 +1,299 @@
+# Execute GitVersion Task (gitversion/execute) Usage Examples
+
+Find out how to use the **gitversion/execute** task using the examples below.
+
+> The examples use the latest _0.x_ version of the GitVersion Execute task.  It is recommended to use the latest released version in your own pipelines.
+
+## Inputs
+
+The Execute GitVersion task accepts the following inputs:
+
+```yaml
+targetPath:
+  description: Optionally supply the path to the working directory.
+  required: false
+  default: ''
+useConfigFile:
+  description: Whether to use a custom configuration file.
+  required: false
+  default: false
+configFilePath:
+  description: Optional path to config file (defaults to GitVersion.yml).
+  required: false
+  default: ''
+updateAssemblyInfo:
+  description: Whether to update versions in the AssemblyInfo files.
+  required: false
+  default: false
+updateAssemblyInfoFilename:
+  description: Update versions in specified file.
+  required: false
+  default: ''
+additionalArguments:
+  description: Additional arguments to send to GitVersion.
+  required: false
+  default: ''
+```
+
+## Outputs
+
+The Execute GitVersion task creates the following job-scoped variables and multi-job output variables:
+
+- GitVersion.Major
+- GitVersion.Minor
+- GitVersion.Patch
+- GitVersion.PreReleaseTag
+- GitVersion.PreReleaseTagWithDash
+- GitVersion.PreReleaseLabel
+- GitVersion.PreReleaseNumber
+- GitVersion.WeightedPreReleaseNumber
+- GitVersion.BuildMetaData
+- GitVersion.BuildMetaDataPadded
+- GitVersion.FullBuildMetaData
+- GitVersion.MajorMinorPatch
+- GitVersion.SemVer
+- GitVersion.LegacySemVer
+- GitVersion.LegacySemVerPadded
+- GitVersion.AssemblySemVer
+- GitVersion.AssemblySemFileVer
+- GitVersion.FullSemVer
+- GitVersion.InformationalVersion
+- GitVersion.BranchName
+- GitVersion.EscapedBranchName (since 5.2.0)
+- GitVersion.Sha
+- GitVersion.ShortSha
+- GitVersion.NuGetVersionV2
+- GitVersion.NuGetVersion
+- GitVersion.NuGetPreReleaseTagV2
+- GitVersion.NuGetPreReleaseTag
+- GitVersion.VersionSourceSha
+- GitVersion.CommitsSinceVersionSource
+- GitVersion.CommitsSinceVersionSourcePadded (since 5.2.0)
+- GitVersion.UncommittedChanges (since 5.5.0)
+- GitVersion.CommitDate
+
+The job-scoped variables can be accessed using the macro syntax `$(GitVersion.<variableName>)` in subsequent steps in the same job.  Azure Pipelines also creates environment variables of the form `GITVERSION_<VARIABLENAME>`.  See examples [5](#example-5) and [6](#example-6).
+
+The multi-job output variables can be accessed across jobs and stages, in both conditions and variables.  See examples [7](#example-7) to [10](#example-10).
+
+**GitVersion also automatically updates the pre-defined Build variable `Build.BuildNumber`.**
+
+---
+
+## Examples
+
+### Example 1
+
+Calculate the version for the build.
+
+```yaml
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Determine Version
+```
+
+### Example 2
+
+Calculate the version for the build using a config file with the default name **GitVersion.yml**.
+
+```yaml
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Determine Version
+    inputs:
+      useConfigFile: true
+```
+
+Example contents of **GitVersion.yml**:
+
+```yaml
+mode: Mainline
+branches:
+  master:
+    regex: ^latest$
+  pull-request:
+    tag: pr
+```
+
+### Example 3
+
+Calculate the version for the build using a config file named **VersionConfig.yml** in the root of the working folder.
+
+```yaml
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Determine Version
+    inputs:
+      useConfigFile: true
+      configFilePath: 'VersionConfig.yml'
+```
+
+### Example 4
+
+Show the effective configuration for GitVersion by running the **/showConfig** command (passed as an additional argument).
+
+```yaml
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Display GitVersion config
+    inputs:
+      additionalArguments: '/showConfig'
+```
+
+### Example 5
+
+Calculate the version for the build and display all the calculated variables in the next step.
+
+```yaml
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Determine Version
+
+  - script: |
+      echo Major: $(GitVersion.Major)
+      echo Minor: $(GitVersion.Minor)
+      echo Patch: $(GitVersion.Patch)
+      echo PreReleaseTag: $(GitVersion.PreReleaseTag)
+      echo PreReleaseTagWithDash: $(GitVersion.PreReleaseTagWithDash)
+      echo PreReleaseLabel: $(GitVersion.PreReleaseLabel)
+      echo PreReleaseNumber: $(GitVersion.PreReleaseNumber)
+      echo WeightedPreReleaseNumber: $(GitVersion.WeightedPreReleaseNumber)
+      echo BuildMetaData: $(GitVersion.BuildMetaData)
+      echo BuildMetaDataPadded: $(GitVersion.BuildMetaDataPadded)
+      echo FullBuildMetaData: $(GitVersion.FullBuildMetaData)
+      echo MajorMinorPatch: $(GitVersion.MajorMinorPatch)
+      echo SemVer: $(GitVersion.SemVer)
+      echo LegacySemVer: $(GitVersion.LegacySemVer)
+      echo LegacySemVerPadded: $(GitVersion.LegacySemVerPadded)
+      echo AssemblySemVer: $(GitVersion.AssemblySemVer)
+      echo AssemblySemFileVer: $(GitVersion.AssemblySemFileVer)
+      echo FullSemVer: $(GitVersion.FullSemVer)
+      echo InformationalVersion: $(GitVersion.InformationalVersion)
+      echo BranchName: $(GitVersion.BranchName)
+      echo EscapedBranchName: $(GitVersion.EscapedBranchName)
+      echo Sha: $(GitVersion.Sha)
+      echo ShortSha: $(GitVersion.ShortSha)
+      echo NuGetVersionV2: $(GitVersion.NuGetVersionV2)
+      echo NuGetVersion: $(GitVersion.NuGetVersion)
+      echo NuGetPreReleaseTagV2: $(GitVersion.NuGetPreReleaseTagV2)
+      echo NuGetPreReleaseTag: $(GitVersion.NuGetPreReleaseTag)
+      echo VersionSourceSha: $(GitVersion.VersionSourceSha)
+      echo CommitsSinceVersionSource: $(GitVersion.CommitsSinceVersionSource)
+      echo CommitsSinceVersionSourcePadded: $(GitVersion.CommitsSinceVersionSourcePadded)
+      echo UncommittedChanges: $(GitVersion.UncommittedChanges)
+      echo CommitDate: $(GitVersion.CommitDate)
+```
+
+### Example 6
+
+Calculate the version for the build and use the `GitVersion.NuGetVersion` variable to set the NuGet package version.
+
+```yaml
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Determine Version
+
+  - task: DotNetCoreCLI@2
+    displayName: Pack Example
+    inputs:
+      command: pack
+      packagesToPack: src/Example/LibExample.csproj
+      versioningScheme: byEnvVar
+      versionEnvVar: GitVersion.NuGetVersion # alternative syntax GITVERSION_NUGETVERSION (the former gets converted into the latter internally)
+```
+
+### Example 7
+
+Calculate the version for the build and use the `GitVersion.BranchName` variable in a condition for starting another job.
+
+```yaml
+job: CalculateVersion
+displayName: Calculate version using GitVersion
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Use GitVersion
+    name: Version # the step MUST be named to access its output variables in another job.
+
+job: CreateReleaseNotes
+condition: and(succeeded(), eq(dependencies.CalculateVersion.outputs['Version.GitVersion.BranchName'], 'main')
+dependsOn: CalculateVersion
+```
+
+### Example 8
+
+Calculate the version for the build and map the `GitVersion.SemVer` variable into a variable in another job.
+
+```yaml
+job: CalculateVersion
+displayName: Calculate version using GitVersion
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Use GitVersion
+    name: Version # the step MUST be named to access its output variables in another job.
+
+job: BuildAndPack
+variables:
+  Ver.MajorMinorPatch: $[ dependencies.CalculateVersion.outputs['Version.GitVersion.MajorMinorPatch'] ]
+```
+
+### Example 9
+
+Calculate the version for the build and use the `GitVersion.Major` output variable in a condition for starting another stage.
+
+```yaml
+stages:
+  - stage: S1
+    jobs:
+      - job: CalculateVersion
+        displayName: Calculate version number using GitVersion
+        steps:
+          # gitversion/setup@0 task omitted for brevity.
+
+          - task: gitversion/execute@0
+            displayName: Use GitVersion
+            name: Version # the step MUST be named to access its output variables in another stage.
+
+  - stage: S2
+    condition: and(succeeded(), gt(dependencies.S1.outputs['CalculateVersion.Version.GitVersion.Major'], 0))
+    dependsOn: S1
+```
+
+### Example 10
+
+Calculate the version for the build and map the `GitVersion.AssemblySemVer` variable into a variable in another job for a different stage.
+
+```yaml
+stages:
+  - stage: S1
+    jobs:
+      - job: CalculateVersion
+        displayName: Calculate version number using GitVersion
+        steps:
+          # gitversion/setup@0 task omitted for brevity.
+
+          - task: gitversion/execute@0
+            displayName: Use GitVersion
+            name: Version # the step MUST be named to access its output variables in another stage.
+  - stage: S2
+    dependsOn: S1
+    jobs:
+      - job: UpdateAssemblyVersions
+        variables:
+          Ver.AssemblyVer: $[ stageDependencies.S1.CalculateVersion.outputs['Version.GitVersion.AssemblySemVer'] ] # Note the 'stageDependencies.<jobName>' syntax.
+```

docs/examples/azure/gitversion/index.md

@@ -0,0 +1,11 @@
+# GitVersion Tasks Usage Examples
+
+Use the following links to see usage examples of the Setup GitVersion (**gitversion/setup**) and Execute GitVersion (**gitversion/execute**) tasks.
+
+## Setup GitVersion (gitversion/setup)
+
+- [Usage examples](setup/usage-examples.md)
+
+## Execute GitVersion (gitversion/execute)
+
+- [Usage examples](execute/usage-examples.md)

docs/examples/azure/gitversion/setup/usage-examples.md

@@ -0,0 +1,61 @@
+# Setup GitVersion Task (gitversion/setup) Usage Examples
+
+Find out how to use the **gitversion/setup** task using the examples below.
+
+> The examples use the latest _0.x_ version of the GitVersion Setup task.  It is recommended to use the latest released version in your own pipelines.
+
+## Inputs
+
+The Setup GitVersion task accepts the following inputs:
+
+```yaml
+versionSpec:
+  description: Required version in the form of 5.x or exact version like 5.0.0.
+  required: true
+  default: ''
+includePrerelease:
+  description: Include pre-release versions when matching a version.
+  required: false
+  default: false
+```
+
+---
+
+## Usage examples
+
+### Example 1
+
+Install the latest GitVersion 5 version.
+
+```yaml
+steps:
+  - task: gitversion/setup@0
+    displayName: Install GitVersion
+    inputs:
+      versionSpec: '5.x'
+```
+
+### Example 2
+
+Install GitVersion 5.5.0.
+
+```yaml
+steps:
+  - task: gitversion/setup@0
+    displayName: Install GitVersion
+    inputs:
+      versionSpec: '5.5.0'
+```
+
+### Example 3
+
+Install the latest GitVersion 6 pre-release version.  For example **6.0.0-beta1.1**.
+
+```yaml
+steps:
+  - task: gitversion/setup@0
+    displayName: Install GitVersion
+    inputs:
+      versionSpec: '6.x'
+      includePrerelease: true
+```

docs/examples/github/gitreleasemanager/addasset.md

@@ -0,0 +1,15 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/addasset@v0.9.2
+    name: Add asset to a release with GitReleaseManager
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      owner: 'someOwner'
+      repository: 'someRepository'
+      tagName: '0.1.0'
+      assets: |
+        src/test.txt
+        src/test1.txt
+```

docs/examples/github/gitreleasemanager/close.md

@@ -0,0 +1,12 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/close@v0.9.2
+    name: Close release with GitReleaseManager
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      owner: 'someOwner'
+      repository: 'someRepository'
+      milestone: '0.1.0'
+```

docs/examples/github/gitreleasemanager/create.md

@@ -0,0 +1,16 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/create@v0.9.2
+    name: Create release with GitReleaseManager
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      owner: 'someOwner'
+      repository: 'someRepository'
+      milestone: '0.1.0'
+      name: 'v0.1.0'
+      assets:  |
+        src/test.txt
+        src/test1.txt
+```

docs/examples/github/gitreleasemanager/discard.md

@@ -0,0 +1,12 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/discard@v0.9.2
+    name: Discard release with GitReleaseManager
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      owner: 'someOwner'
+      repository: 'someRepository'
+      milestone: '0.1.0'
+```

docs/examples/github/gitreleasemanager/index.md

@@ -0,0 +1,11 @@
+# GitReleaseManager GitHub Action
+
+Below you'll find examples of how to do particular actions with GitReleaseManager:
+
+* [Add asset](addasset.md)
+* [Close](close.md)
+* [Create](create.md)
+* [Discard](discard.md)
+* [Open](open.md)
+* [Publish](publish.md)
+* [Setup](setup.md)

docs/examples/github/gitreleasemanager/open.md

@@ -0,0 +1,12 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/open@v0.9.2
+    name: Open release with GitReleaseManager
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      owner: 'someOwner'
+      repository: 'someRepository'
+      milestone: '0.1.0'
+```

docs/examples/github/gitreleasemanager/publish.md

@@ -0,0 +1,12 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/publish@v0.9.2
+    name: Publish release with GitReleaseManager
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      owner: 'someOwner'
+      repository: 'someRepository'
+      tagName: '0.1.0'
+```

docs/examples/github/gitreleasemanager/setup.md

@@ -0,0 +1,9 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/setup@v0.9.2
+    name: Install GitReleaseManager
+    with:
+      versionSpec: '0.10.x'
+```

docs/examples/github/gitversion/execute/usage-examples.md

@@ -0,0 +1,283 @@
+# Execute GitVersion Action (gitversion/execute) Usage Examples
+
+Find out how to use the **gitversion/execute** action using the examples below.
+
+For the GitVersion workflow to execute successfully, you must checkout your Git repository with `fetch-depth: 0` to fetch all history for all tags and branches, as follows:
+
+```yaml
+steps:
+  - name: Checkout
+    uses: actions/checkout@v2
+    with:
+      fetch-depth: 0
+```
+
+This step is omitted from the examples for brevity.
+
+> The examples use version _0.9.6_ of the GitVersion Execute action.  It is recommended to use the latest released version in your own workflows.
+
+## Inputs
+
+The Execute GitVersion action accepts the following inputs:
+
+```yaml
+targetPath:
+  description: Optionally supply the path to the working directory.
+  required: false
+  default: ''
+useConfigFile:
+  description: Whether to use a custom configuration file.
+  required: false
+  default: false
+configFilePath:
+  description: Optional path to config file (defaults to GitVersion.yml).
+  required: false
+  default: 'GitVersion.yml'
+updateAssemblyInfo:
+  description: Whether to update versions in the AssemblyInfo files.
+  required: false
+  default: false
+updateAssemblyInfoFilename:
+  description: Update versions in specified file.
+  required: false
+  default: ''
+additionalArguments:
+  description: Additional arguments to send to GitVersion.
+  required: false
+  default: ''
+```
+
+## Outputs
+
+The Execute GitVersion action creates the following outputs:
+
+- major
+- minor
+- patch
+- preReleaseTag
+- preReleaseTagWithDash
+- preReleaseLabel
+- preReleaseNumber
+- weightedPreReleaseNumber
+- buildMetaData
+- buildMetaDataPadded
+- fullBuildMetaData
+- majorMinorPatch
+- semVer
+- legacySemVer
+- legacySemVerPadded
+- assemblySemVer
+- assemblySemFileVer
+- fullSemVer
+- informationalVersion
+- branchName
+- escapedBranchName (since 5.2.0)
+- sha
+- shortSha
+- nuGetVersionV2
+- nuGetVersion
+- nuGetPreReleaseTagV2
+- nuGetPreReleaseTag
+- versionSourceSha
+- commitsSinceVersionSource
+- commitsSinceVersionSourcePadded (since 5.2.0)
+- uncommittedChanges (since 5.5.0)
+- commitDate
+
+The outputs can be accessed using the syntax `${{ steps.<id>.outputs.<outputName> }}`, where `<id>` is the ID assigned to the step that calls the action, by subsequent steps later in the same job.  See example [5](#example-5).
+
+The action also creates environment variables of the form `GITVERSION_<OUTPUTNAME>` for use by other steps in the same job.  See example [6](#example-6).
+
+The outputs can be accessed across jobs by mapping them to job outputs and referencing the job outputs using the `needs` context in dependent jobs.  See examples [7](#example-7) and [8](#example-8).
+
+---
+
+## Examples
+
+### Example 1
+
+Calculate the version for the build.
+
+```yaml
+steps:
+  # gitversion/setup@v0.9.6 action omitted for brevity.
+
+  - name: Determine Version
+    uses: gittools/actions/gitversion/execute@v0.9.6
+```
+
+### Example 2
+
+Calculate the version for the build using a config file with the default name **GitVersion.yml**.
+
+```yaml
+steps:
+  - name: Determine Version
+    uses: gittools/actions/gitversion/execute@v0.9.6
+    with:
+      useConfigFile: true
+```
+
+Example contents of **GitVersion.yml**:
+
+```yaml
+mode: Mainline
+branches:
+  master:
+    regex: ^latest$
+  pull-request:
+    tag: pr
+```
+
+### Example 3
+
+Calculate the version for the build using a config file named **VersionConfig.yml** in the root of the working folder.
+
+```yaml
+steps:
+  # gitversion/setup@v0.9.6 action omitted for brevity.
+
+  - name: Determine Version
+    uses: gittools/actions/gitversion/execute@v0.9.6
+    with:
+      useConfigFile: true
+      configFilePath: VersionConfig.yml
+```
+
+### Example 4
+
+Show the effective configuration for GitVersion by running the **/showConfig** command (passed as an additional argument).
+
+```yaml
+steps:
+  # gitversion/setup@v0.9.6 action omitted for brevity.
+
+  - name: Display GitVersion config
+    uses: gittools/actions/gitversion/execute@v0.9.6
+    with:
+      useConfigFile: true
+      additionalArguments: '/showConfig'
+```
+
+### Example 5
+
+Calculate the version for the build and display all the calculated variables in the next step.
+
+```yaml
+steps:
+  # gitversion/setup@v0.9.6 action omitted for brevity.
+
+  - name: Determine Version
+    id:   gitversion
+    uses: gittools/actions/gitversion/execute@v0.9.6
+
+  - name: Display GitVersion outputs
+    run: |
+      echo "Major: ${{ steps.gitversion.outputs.major }}"
+      echo "Minor: ${{ steps.gitversion.outputs.minor }}"
+      echo "Patch: ${{ steps.gitversion.outputs.patch }}"
+      echo "PreReleaseTag: ${{ steps.gitversion.outputs.preReleaseTag }}"
+      echo "PreReleaseTagWithDash: ${{ steps.gitversion.outputs.preReleaseTagWithDash }}"
+      echo "PreReleaseLabel: ${{ steps.gitversion.outputs.preReleaseLabel }}"
+      echo "PreReleaseNumber: ${{ steps.gitversion.outputs.preReleaseNumber }}"
+      echo "WeightedPreReleaseNumber: ${{ steps.gitversion.outputs.weightedPreReleaseNumber }}"
+      echo "BuildMetaData: ${{ steps.gitversion.outputs.buildMetaData }}"
+      echo "BuildMetaDataPadded: ${{ steps.gitversion.outputs.buildMetaDataPadded }}"
+      echo "FullBuildMetaData: ${{ steps.gitversion.outputs.fullBuildMetaData }}"
+      echo "MajorMinorPatch: ${{ steps.gitversion.outputs.majorMinorPatch }}"
+      echo "SemVer: ${{ steps.gitversion.outputs.semVer }}"
+      echo "LegacySemVer: ${{ steps.gitversion.outputs.legacySemVer }}"
+      echo "LegacySemVerPadded: ${{ steps.gitversion.outputs.legacySemVerPadded }}"
+      echo "AssemblySemVer: ${{ steps.gitversion.outputs.assemblySemVer }}"
+      echo "AssemblySemFileVer: ${{ steps.gitversion.outputs.assemblySemFileVer }}"
+      echo "FullSemVer: ${{ steps.gitversion.outputs.fullSemVer }}"
+      echo "InformationalVersion: ${{ steps.gitversion.outputs.informationalVersion }}"
+      echo "BranchName: ${{ steps.gitversion.outputs.branchName }}"
+      echo "EscapedBranchName: ${{ steps.gitversion.outputs.escapedBranchName }}"
+      echo "Sha: ${{ steps.gitversion.outputs.sha }}"
+      echo "ShortSha: ${{ steps.gitversion.outputs.shortSha }}"
+      echo "NuGetVersionV2: ${{ steps.gitversion.outputs.nuGetVersionV2 }}"
+      echo "NuGetVersion: ${{ steps.gitversion.outputs.nuGetVersion }}"
+      echo "NuGetPreReleaseTagV2: ${{ steps.gitversion.outputs.nuGetPreReleaseTagV2 }}"
+      echo "NuGetPreReleaseTag: ${{ steps.gitversion.outputs.nuGetPreReleaseTag }}"
+      echo "VersionSourceSha: ${{ steps.gitversion.outputs.versionSourceSha }}"
+      echo "CommitsSinceVersionSource: ${{ steps.gitversion.outputs.commitsSinceVersionSource }}"
+      echo "CommitsSinceVersionSourcePadded: ${{ steps.gitversion.outputs.commitsSinceVersionSourcePadded }}"
+      echo "UncommittedChanges: ${{ steps.gitversion.outputs.uncommittedChanges }}"
+      echo "CommitDate: ${{ steps.gitversion.outputs.commitDate }}"
+```
+
+### Example 6
+
+Calculate the version for the build and display the value of the `GITVERSION_SEMVER` environment variable.
+
+```yaml
+steps:
+  # gitversion/setup@v0.9.6 action omitted for brevity.
+
+  - name: Determine Version
+    uses: gittools/actions/gitversion/execute@v0.9.6
+
+  - name: Display SemVer
+    run: |
+      echo "SemVer: $GITVERSION_SEMVER"
+```
+
+### Example 7
+
+Calculate the version for the build and use the `branchName` output in a condition for starting another job.
+
+```yaml
+jobs:
+  calculate-version:
+    name: Calculate Version
+    runs-on: ubuntu-latest
+    outputs:
+      branchName: ${{ steps.gitversion.outputs.branchName }} # To use an output in another job, you have to map it to a job output.
+    steps:
+      # gitversion/execute step omitted for brevity
+
+      - name: Determine Version
+        id: gitversion
+        uses: gittools/actions/gitversion/execute@v0.9.6
+
+  create-release-notes:
+    name: Create Release Notes
+    runs-on: ubuntu-latest
+    needs: calculate-version
+    if: contains(needs.calculate-version.outputs.branchName, 'main') # Output variable accessed via `needs` context.
+    steps:
+      - run: |
+          # Output variables can also be accessed in steps, using an expression.
+          echo "Creating release notes for ${{ needs.calculate-version.outputs.branchName }} branch."
+```
+
+### Example 8
+
+Calculate the version for the build and map the `semVer` output into an environment variable in another job.
+
+```yaml
+jobs:
+  calculate-version:
+    name: Calculate Version
+    runs-on: ubuntu-latest
+    outputs:
+      semVer: ${{ steps.gitversion.outputs.semVer }}
+    steps:
+      # gitversion/execute step omitted for brevity
+
+      - name: Determine Version
+        id: gitversion
+        uses: gittools/actions/gitversion/execute@v0.9.6
+
+  display-semver:
+    name: Display Semantic Version
+    runs-on: ubuntu-latest
+    needs: calculate-version
+    env:
+      SEMVER: ${{ needs.calculate-version.outputs.semVer }}
+    steps:
+      - name: Display version
+        run: |
+          echo SemVer: $SEMVER
+```

docs/examples/github/gitversion/index.md

@@ -0,0 +1,11 @@
+# GitVersion Actions Usage Examples
+
+Use the following links to see usage examples of the Setup GitVersion (**gitversion/setup**) and Execute GitVersion (**gitversion/execute**) actions.
+
+## Setup GitVersion (gitversion/setup)
+
+- [Usage examples](setup/usage-examples.md)
+
+## Execute GitVersion (gitversion/execute)
+
+- [Usage examples](execute/usage-examples.md)

docs/examples/github/gitversion/setup/usage-examples.md

@@ -0,0 +1,61 @@
+# Setup GitVersion Action (gitversion/setup) Usage Examples
+
+Find out how to use the **gitversion/setup** action using the examples below.
+
+> The examples use version _0.9.6_ of the GitVersion Execute action.  It is recommended to use the latest released version in your own workflows.
+
+## Inputs
+
+The Setup GitVersion action accepts the following inputs:
+
+```yaml
+versionSpec:
+  description: Required version in the form of 5.x or exact version like 5.0.0.
+  required: true
+  default: ''
+includePrerelease:
+  description: Include pre-release versions when matching a version.
+  required: false
+  default: false
+```
+
+---
+
+## Usage examples
+
+### Example 1
+
+Install the latest GitVersion 5 version.
+
+```yaml
+steps:
+  - name: Install GitVersion
+    uses: gittools/actions/gitversion/setup@v0.9.6
+    with:
+      versionSpec: '5.x'
+```
+
+### Example 2
+
+Install GitVersion 5.5.0.
+
+```yaml
+steps:
+  - name: Install GitVersion
+    uses: gittools/actions/gitversion/setup@v0.9.6
+    with:
+      versionSpec: '5.5.0'
+```
+
+### Example 3
+
+Install the latest GitVersion 6 pre-release version.  For example **6.0.0-beta1.1**.
+
+```yaml
+steps:
+  - name: Install GitVersion
+    uses: gittools/actions/gitversion/setup@v0.9.6
+    with:
+      versionSpec: '6.x'
+      includePrerelease: true
+```

gitreleasemanager/addasset/action.yml

@@ -0,0 +1,34 @@
+name: gitreleasemanager-addasset
+description: GitHub Action for creating and exporting releases for software applications hosted on GitHub. Adds assets to a release
+author: GitTools
+branding:
+  color: gray-dark
+  icon: git-pull-request
+runs:
+  using: node12
+  main: ../../dist/github/gitreleasemanager/addasset/bundle.js
+inputs:
+  owner:
+    description: The owner of the repository
+    required: true
+    default: ''
+  repository:
+    description: The name of the repository
+    required: true
+    default: ''
+  token:
+    description: The access token to access GitHub with
+    required: true
+    default: ''
+  milestone:
+    description: The milestone to use
+    required: true
+    default: ''
+  assets:
+    description: Path(s) to the file(s) to include in the release
+    required: true
+    default: ''
+  targetDirectory:
+    description: The directory on which GitReleaseManager should be executed. Defaults to current directory
+    required: false
+    default: ''

gitreleasemanager/close/action.yml

@@ -0,0 +1,30 @@
+name: gitreleasemanager-close
+description: GitHub Action for creating and exporting releases for software applications hosted on GitHub. Closes a release
+author: GitTools
+branding:
+  color: gray-dark
+  icon: git-pull-request
+runs:
+  using: node12
+  main: ../../dist/github/gitreleasemanager/close/bundle.js
+inputs:
+  owner:
+    description: The owner of the repository
+    required: true
+    default: ''
+  repository:
+    description: The name of the repository
+    required: true
+    default: ''
+  token:
+    description: The access token to access GitHub with
+    required: true
+    default: ''
+  milestone:
+    description: The milestone to use
+    required: true
+    default: ''
+  targetDirectory:
+    description: The directory on which GitReleaseManager should be executed. Defaults to current directory
+    required: false
+    default: ''

gitreleasemanager/create/action.yml

@@ -23,7 +23,7 @@ inputs:
   milestone:
     description: The milestone to use
     required: false
-    default: ''  
+    default: ''
   name:
     description: The name of the release
     required: false
@@ -32,7 +32,7 @@ inputs:
     description: The path to the file to be used as the content of the release notes
     required: false
     default: ''
-  pre:
+  isPreRelease:
     description: Creates the release as a pre-release
     required: false
     default: 'false'
@@ -40,7 +40,11 @@ inputs:
     description: The commit to tag. Can be a branch or SHA. Defaults to repository's default branch
     required: false
     default: ''
+  assets:
+    description: Path(s) to the file(s) to include in the release
+    required: false
+    default: ''
   targetDirectory:
     description: The directory on which GitReleaseManager should be executed. Defaults to current directory
     required: false
-    default: ''
+    default: ''

gitreleasemanager/discard/action.yml

@@ -0,0 +1,30 @@
+name: gitreleasemanager-discard
+description: GitHub Action for creating and exporting releases for software applications hosted on GitHub. Discards a release
+author: GitTools
+branding:
+  color: gray-dark
+  icon: git-pull-request
+runs:
+  using: node12
+  main: ../../dist/github/gitreleasemanager/discard/bundle.js
+inputs:
+  owner:
+    description: The owner of the repository
+    required: true
+    default: ''
+  repository:
+    description: The name of the repository
+    required: true
+    default: ''
+  token:
+    description: The access token to access GitHub with
+    required: true
+    default: ''
+  milestone:
+    description: The milestone to use
+    required: true
+    default: ''
+  targetDirectory:
+    description: The directory on which GitReleaseManager should be executed. Defaults to current directory
+    required: false
+    default: ''

gitreleasemanager/open/action.yml

@@ -0,0 +1,30 @@
+name: gitreleasemanager-open
+description: GitHub Action for creating and exporting releases for software applications hosted on GitHub. Opens a release
+author: GitTools
+branding:
+  color: gray-dark
+  icon: git-pull-request
+runs:
+  using: node12
+  main: ../../dist/github/gitreleasemanager/open/bundle.js
+inputs:
+  owner:
+    description: The owner of the repository
+    required: true
+    default: ''
+  repository:
+    description: The name of the repository
+    required: true
+    default: ''
+  token:
+    description: The access token to access GitHub with
+    required: true
+    default: ''
+  milestone:
+    description: The milestone to use
+    required: true
+    default: ''
+  targetDirectory:
+    description: The directory on which GitReleaseManager should be executed. Defaults to current directory
+    required: false
+    default: ''

gitreleasemanager/publish/action.yml

@@ -0,0 +1,30 @@
+name: gitreleasemanager-publish
+description: GitHub Action for creating and exporting releases for software applications hosted on GitHub. Publish a release
+author: GitTools
+branding:
+  color: gray-dark
+  icon: git-pull-request
+runs:
+  using: node12
+  main: ../../dist/github/gitreleasemanager/publish/bundle.js
+inputs:
+  owner:
+    description: The owner of the repository
+    required: true
+    default: ''
+  repository:
+    description: The name of the repository
+    required: true
+    default: ''
+  token:
+    description: The access token to access GitHub with
+    required: true
+    default: ''
+  milestone:
+    description: The milestone to use
+    required: true
+    default: ''
+  targetDirectory:
+    description: The directory on which GitReleaseManager should be executed. Defaults to current directory
+    required: false
+    default: ''

gitreleasemanager/setup/action.yml

@@ -13,6 +13,6 @@ inputs:
     required: true
     default: ''
   includePrerelease:
-    description: Include pre-release versions when matching a version 
+    description: Include pre-release versions when matching a version
     required: false
-    default: false
+    default: 'false'

gitversion/execute/action.yml

@@ -19,7 +19,7 @@ inputs:
   configFilePath:
     description: Optional path to config file (defaults to GitVersion.yml)
     required: false
-    default: ''
+    default: 'GitVersion.yml'
   updateAssemblyInfo:
     description: Whether to update versions in the AssemblyInfo files
     required: false
@@ -73,6 +73,8 @@ outputs:
     description: 'The InformationalVersion value'
   branchName:
     description: 'The BranchName value'
+  escapedBranchName:
+    description: 'The EscapedBranchName value'
   sha:
     description: 'The Sha value'
   shortSha:
@@ -91,5 +93,7 @@ outputs:
     description: 'The CommitsSinceVersionSource value'
   commitsSinceVersionSourcePadded:
     description: 'The CommitsSinceVersionSourcePadded value'
+  uncommittedChanges:
+    description: 'The UncommittedChanges value'
   commitDate:
     description: 'The CommitDate value'

gitversion/setup/action.yml

@@ -1,5 +1,5 @@
 name: gitversion-setup
-description: GitHub Action for Easy Semantic Versioning with GitVersion. Installs the specific version of GitVersion.Tool
+description: GitHub Action for Easy Semantic Versioning with GitVersion. Installs the specific version of GitVersion tool
 author: GitTools
 branding:
   color: gray-dark
@@ -13,6 +13,6 @@ inputs:
     required: true
     default: ''
   includePrerelease:
-    description: Include pre-release versions when matching a version 
+    description: Include pre-release versions when matching a version
     required: false
-    default: false
+    default: 'false'

package.json

@@ -8,14 +8,16 @@
     },
     "main": "main.js",
     "scripts": {
-        "build:mock": "webpack --config webpack.config.js --env.agent=mock",
+        "format": "prettier --write src/**/*.ts",
-        "build:azure": "webpack --config webpack.config.js --env.agent=azure",
+        "format-check": "prettier --check src/**/*.ts",
-        "build:github": "webpack --config webpack.config.js --env.agent=github",
+        "build:mock": "webpack --config webpack.config.js --env agent=mock",
-        "build:mock:prod": "npm run build:mock -- --env.mode=production",
+        "build:azure": "webpack --config webpack.config.js --env agent=azure",
-        "build:azure:prod": "npm run build:azure -- --env.mode=production",
+        "build:github": "webpack --config webpack.config.js --env agent=github",
-        "build:github:prod": "npm run build:github -- --env.mode=production",
+        "compress:mock": "npm run build:mock -- --env task=compress",
+        "compress:azure": "npm run build:azure -- --env task=compress",
+        "compress:github": "npm run build:github -- --env task=compress",
         "build": "npm run build:mock && npm run build:azure && npm run build:github",
-        "build:prod": "npm run build:mock:prod && npm run build:azure:prod && npm run build:github:prod",
+        "compress": "npm run compress:mock && npm run compress:azure && npm run compress:github",
         "publish:azure": "tfx extension publish --root ./dist/azure --no-wait-validation --auth-type pat"
     },
     "author": "GitTools",
@@ -24,29 +26,30 @@
     ],
     "license": "MIT",
     "dependencies": {
-        "@actions/core": "^1.2.2",
+        "@actions/core": "^1.2.6",
-        "@actions/exec": "^1.0.3",
+        "@actions/exec": "^1.0.4",
         "@actions/io": "^1.0.2",
-        "@actions/tool-cache": "^1.3.1",
+        "@actions/tool-cache": "^1.6.1",
-        "azure-pipelines-task-lib": "^2.9.3",
+        "azure-pipelines-task-lib": "^2.11.3",
-        "azure-pipelines-tool-lib": "^0.12.0",
+        "azure-pipelines-tool-lib": "^0.13.2",
         "inversify": "^5.0.1",
-        "typed-rest-client": "^1.7.1",
+        "typed-rest-client": "^1.8.0",
-        "uuid": "^3.4.0"
+        "uuid": "^8.3.1"
     },
     "devDependencies": {
-        "@types/node": "^13.7.0",
+        "@types/node": "^14.14.9",
-        "@types/q": "^1.5.2",
+        "@types/q": "^1.5.4",
         "@types/semver-compare": "^1.0.1",
-        "@types/uuid": "^3.4.7",
+        "@types/uuid": "^8.3.0",
-        "json-update": "^5.3.0",
+        "minimist": "^1.2.5",
+        "prettier": "^2.2.0",
         "reflect-metadata": "^0.1.13",
         "replace-in-file-webpack-plugin": "^1.0.6",
-        "tfx-cli": "^0.7.11",
+        "terser-webpack-plugin": "^5.0.3",
-        "ts-loader": "^6.2.1",
+        "tfx-cli": "^0.8.3",
-        "tslint": "^6.0.0",
+        "ts-loader": "^8.0.11",
-        "typescript": "^3.7.5",
+        "typescript": "^4.1.2",
-        "webpack": "^4.41.5",
+        "webpack": "^5.6.0",
-        "webpack-cli": "^3.3.10"
+        "webpack-cli": "^4.2.0"
     }
 }

src/agent/azure/build-agent.ts

@@ -1,106 +1,117 @@
-import { injectable } from "inversify";
+import { injectable } from 'inversify'
 
-import * as taskLib from "azure-pipelines-task-lib/task";
+import * as taskLib from 'azure-pipelines-task-lib/task'
-import * as toolLib from "azure-pipelines-tool-lib/tool";
+import * as toolLib from 'azure-pipelines-tool-lib/tool'
 
-import { IBuildAgent, IExecResult } from "../../core/models";
+import { IBuildAgent, IExecResult } from '../../core/models'
+import { IRequestOptions } from 'typed-rest-client/Interfaces'
 
 @injectable()
 class BuildAgent implements IBuildAgent {
-
     public get agentName(): string {
-        return "Azure Pipelines";
+        return 'Azure Pipelines'
+    }
+
+    public proxyConfiguration(url: string): IRequestOptions {
+        return {
+            proxy: taskLib.getHttpProxyConfiguration(url),
+            cert: taskLib.getHttpCertConfiguration(),
+            ignoreSslError: !!taskLib.getVariable('Agent.SkipCertValidation')
+        }
     }
 
     public find(toolName: string, versionSpec: string, arch?: string): string {
-        return toolLib.findLocalTool(toolName, versionSpec, arch);
+        return toolLib.findLocalTool(toolName, versionSpec, arch)
     }
 
-    public cacheDir(sourceDir: string, tool: string, version: string, arch?: string): Promise<string> {
+    public cacheDir(
-        return toolLib.cacheDir(sourceDir, tool, version, arch);
+        sourceDir: string,
+        tool: string,
+        version: string,
+        arch?: string
+    ): Promise<string> {
+        return toolLib.cacheDir(sourceDir, tool, version, arch)
     }
 
     public createTempDir(): Promise<string> {
-        return Promise.resolve(taskLib.getVariable("Agent.TempDirectory"));
+        return Promise.resolve(taskLib.getVariable('Agent.TempDirectory'))
     }
 
     public debug(message: string): void {
-        taskLib.debug(message);
+        taskLib.debug(message)
     }
 
     public setFailed(message: string, done?: boolean): void {
-        taskLib.setResult(taskLib.TaskResult.Failed, message, done);
+        taskLib.setResult(taskLib.TaskResult.Failed, message, done)
     }
 
     public setSucceeded(message: string, done?: boolean): void {
-        taskLib.setResult(taskLib.TaskResult.Succeeded, message, done);
+        taskLib.setResult(taskLib.TaskResult.Succeeded, message, done)
     }
 
     public exportVariable(name: string, val: string): void {
-        taskLib.setVariable(name, val);
+        taskLib.setVariable(name, val)
     }
 
     public getVariable(name: string): string {
-        return taskLib.getVariable(name);
+        return taskLib.getVariable(name)
     }
 
     public addPath(inputPath: string): void {
-        toolLib.prependPath(inputPath);
+        toolLib.prependPath(inputPath)
     }
 
     public which(tool: string, check?: boolean): Promise<string> {
-        return Promise.resolve(taskLib.which(tool, check));
+        return Promise.resolve(taskLib.which(tool, check))
     }
 
     public exec(exec: string, args: string[]): Promise<IExecResult> {
-        const tr = taskLib.tool(exec);
+        const tr = taskLib.tool(exec)
-        tr.arg(args);
+        tr.arg(args)
 
-        const result = tr.execSync();
+        const result = tr.execSync()
         return Promise.resolve({
             code: result.code,
             error: result.error,
             stderr: result.stderr,
-            stdout: result.stdout,
+            stdout: result.stdout
-        });
+        })
     }
 
     public getSourceDir(): string {
-        return this.getVariable("Build.SourcesDirectory");
+        return this.getVariable('Build.SourcesDirectory')
     }
 
     public setOutput(name: string, value: string): void {
-        taskLib.setVariable(name, value);
+        taskLib.setVariable(name, value)
     }
 
     public getInput(input: string, required?: boolean): string {
-        return taskLib.getInput(input, required);
+        return taskLib.getInput(input, required)?.trim()
     }
 
     public getListInput(input: string, required?: boolean): string[] {
         return taskLib
             .getInput(input, required)
-            .split("\n")
+            .split('\n')
-            .filter(x => x !== "");
+            .filter(x => x !== '')
     }
 
     public getBooleanInput(input: string, required?: boolean): boolean {
-        return taskLib.getBoolInput(input, required);
+        return taskLib.getBoolInput(input, required)
     }
 
     public isValidInputFile(input: string, file: string): boolean {
-        return taskLib.filePathSupplied(input) && this.fileExists(file);
+        return taskLib.filePathSupplied(input) && this.fileExists(file)
     }
 
     public fileExists(file: string): boolean {
-        return taskLib.exist(file) && taskLib.stats(file).isFile();
+        return taskLib.exist(file) && taskLib.stats(file).isFile()
     }
 
     public directoryExists(file: string): boolean {
-        return taskLib.exist(file) && taskLib.stats(file).isDirectory();
+        return taskLib.exist(file) && taskLib.stats(file).isDirectory()
     }
 }
 
-export {
+export { BuildAgent }
-    BuildAgent,
-};

src/agent/github/build-agent.ts

@@ -1,62 +1,122 @@
-import * as fs from "fs";
+import * as fs from 'fs'
-import * as path from "path";
+import * as path from 'path'
+import * as urlApi from 'url'
 
-import uuidv4 from "uuid";
+import { v4 as uuidv4 } from 'uuid'
 
-import * as core from "@actions/core";
+import * as core from '@actions/core'
-import * as exe from "@actions/exec";
+import * as exe from '@actions/exec'
-import * as io from "@actions/io";
+import * as io from '@actions/io'
-import * as toolCache from "@actions/tool-cache";
+import * as toolCache from '@actions/tool-cache'
 
-import { injectable } from "inversify";
+import { injectable } from 'inversify'
 
-import { IBuildAgent, IExecResult } from "../../core/models";
+import { IBuildAgent, IExecResult } from '../../core/models'
+import {
+    IRequestOptions,
+    IProxyConfiguration
+} from 'typed-rest-client/Interfaces'
 
 @injectable()
 class BuildAgent implements IBuildAgent {
-
     public get agentName(): string {
-        return "GitHub Actions";
+        return 'GitHub Actions'
     }
 
     public find(toolName: string, versionSpec: string, arch?: string): string {
-        return toolCache.find(toolName, versionSpec, arch);
+        return toolCache.find(toolName, versionSpec, arch)
     }
 
-    public cacheDir(sourceDir: string, tool: string, version: string, arch?: string): Promise<string> {
+    public proxyConfiguration(url: string): IRequestOptions {
-        return toolCache.cacheDir(sourceDir, tool, version, arch);
+        return {
+            proxy: this.getProxyConfiguration(url),
+            cert: undefined,
+            ignoreSslError: undefined
+        }
+    }
+
+    private getProxyConfiguration(requestedUrl: string): IProxyConfiguration {
+        let noProxy = process.env.NO_PROXY || process.env.no_proxy || null
+        let allowedHostsWithoutProxy
+        let dontUseProxy = false
+        if (noProxy) {
+            if (noProxy === '*') {
+                dontUseProxy = true
+            } else {
+                allowedHostsWithoutProxy = noProxy.split(',')
+                if (requestedUrl) {
+                    allowedHostsWithoutProxy.forEach(host => {
+                        if (new RegExp(host, 'i').test(requestedUrl)) {
+                            dontUseProxy = true
+                        }
+                    })
+                }
+            }
+        }
+
+        if (dontUseProxy) {
+            return undefined
+        }
+
+        let proxyURL =
+            process.env.HTTP_PROXY ||
+            process.env.http_proxy ||
+            process.env.HTTPS_PROXY ||
+            process.env.https_proxy ||
+            null
+
+        if (proxyURL) {
+            let url = new urlApi.URL(requestedUrl)
+
+            return {
+                proxyUrl: `${url.protocol}//${url.hostname}:${url.port}`,
+                proxyUsername: url.username,
+                proxyPassword: url.password,
+                proxyBypassHosts: allowedHostsWithoutProxy
+            }
+        }
+        return undefined
+    }
+
+    public cacheDir(
+        sourceDir: string,
+        tool: string,
+        version: string,
+        arch?: string
+    ): Promise<string> {
+        return toolCache.cacheDir(sourceDir, tool, version, arch)
     }
 
     public async createTempDir(): Promise<string> {
-        const IS_WINDOWS = process.platform === "win32";
+        const IS_WINDOWS = process.platform === 'win32'
 
-        let tempDirectory: string = process.env.RUNNER_TEMP || "";
+        let tempDirectory: string = process.env.RUNNER_TEMP || ''
 
         if (!tempDirectory) {
-            let baseLocation: string;
+            let baseLocation: string
             if (IS_WINDOWS) {
                 // On Windows use the USERPROFILE env variable
-                baseLocation = process.env.USERPROFILE || "C:\\";
+                baseLocation = process.env.USERPROFILE || 'C:\\'
             } else {
-                if (process.platform === "darwin") {
+                if (process.platform === 'darwin') {
-                    baseLocation = "/Users";
+                    baseLocation = '/Users'
                 } else {
-                    baseLocation = "/home";
+                    baseLocation = '/home'
                 }
             }
-            tempDirectory = path.join(baseLocation, "actions", "temp");
+            tempDirectory = path.join(baseLocation, 'actions', 'temp')
         }
-        const dest = path.join(tempDirectory, uuidv4());
+        const dest = path.join(tempDirectory, uuidv4())
-        await io.mkdirP(dest);
+        await io.mkdirP(dest)
-        return dest;
+        return dest
     }
 
     public debug(message: string): void {
-        core.debug(message);
+        core.debug(message)
     }
 
     public setFailed(message: string, done?: boolean): void {
-        core.setFailed(message);
+        core.setFailed(message)
     }
 
     public setSucceeded(message: string, done?: boolean): void {
@@ -64,108 +124,104 @@ class BuildAgent implements IBuildAgent {
     }
 
     public exportVariable(name: string, val: string): void {
-        core.exportVariable(name, val);
+        core.exportVariable(name, val)
     }
 
     public getVariable(name: string): string {
-        return process.env[name];
+        return process.env[name]
     }
 
     public addPath(inputPath: string): void {
-        core.addPath(inputPath);
+        core.addPath(inputPath)
     }
 
     public which(tool: string, check?: boolean): Promise<string> {
-        return io.which(tool, check);
+        return io.which(tool, check)
     }
 
     public async exec(exec: string, args: string[]): Promise<IExecResult> {
-        const dotnetPath = await io.which(exec, true);
+        const dotnetPath = await io.which(exec, true)
-        let resultCode = 0;
+        let resultCode = 0
-        let stdout = "";
+        let stdout = ''
-        let stderr = "";
+        let stderr = ''
-        resultCode = await exe.exec(
+        resultCode = await exe.exec(`"${dotnetPath}"`, args, {
-            `"${dotnetPath}"`,
+            listeners: {
-            args,
+                stderr: (data: Buffer) => {
-            {
+                    stderr += data.toString()
-                listeners: {
-                    stderr: (data: Buffer) => {
-                        stderr += data.toString();
-                    },
-                    stdout: (data: Buffer) => {
-                        stdout += data.toString();
-                    },
                 },
-            });
+                stdout: (data: Buffer) => {
+                    stdout += data.toString()
+                }
+            }
+        })
         return {
             code: resultCode,
             error: null,
             stderr,
-            stdout,
+            stdout
-        };
+        }
     }
 
     public getSourceDir(): string {
-        return this.getVariable("GITHUB_WORKSPACE");
+        return this.getVariable('GITHUB_WORKSPACE')
     }
 
     public setOutput(name: string, value: string): void {
-        core.setOutput(name, value);
+        core.setOutput(name, value)
+        core.exportVariable(`GITVERSION_${name.toUpperCase()}`, value)
     }
 
     public getInput(input: string, required?: boolean): string {
-        return core.getInput(input,  { required } as core.InputOptions);
+        return core.getInput(input, { required } as core.InputOptions)?.trim()
     }
 
     public getListInput(input: string, required?: boolean): string[] {
         return core
             .getInput(input, { required } as core.InputOptions)
-            .split("\n")
+            .split('\n')
-            .filter(x => x !== "");
+            .filter(x => x !== '')
     }
 
     public getBooleanInput(input: string, required?: boolean): boolean {
-        const inputValue = this.getInput(input, required);
+        const inputValue = this.getInput(input, required)
-        return (inputValue || "false").toLowerCase() === "true";
+        return (inputValue || 'false').toLowerCase() === 'true'
     }
 
     public isValidInputFile(input: string, file: string): boolean {
-        return this.filePathSupplied(input) && this.fileExists(file);
+        return this.filePathSupplied(input) && this.fileExists(file)
     }
 
     public filePathSupplied(file: string): boolean {
-        const pathValue = path.resolve(this.getInput(file) || "");
+        const pathValue = path.resolve(this.getInput(file) || '')
-        const repoRoot = this.getSourceDir();
+        const repoRoot = this.getSourceDir()
-        return pathValue !== repoRoot;
+        return pathValue !== repoRoot
     }
 
     public fileExists(file: string): boolean {
-        return this._exist(file) && this._stats(file).isFile();
+        return this._exist(file) && this._stats(file).isFile()
     }
 
     public directoryExists(file: string): boolean {
-        return this._exist(file) && this._stats(file).isDirectory();
+        return this._exist(file) && this._stats(file).isDirectory()
     }
 
     private _exist(file: string): boolean {
-        let exist = false;
+        let exist = false
         try {
-            exist = !!(file && fs.statSync(file) != null);
+            exist = !!(file && fs.statSync(file) != null)
         } catch (err) {
-            if (err && err.code === "ENOENT") {
+            if (err && err.code === 'ENOENT') {
-                exist = false;
+                exist = false
             } else {
-                throw err;
+                throw err
             }
         }
-        return exist;
+        return exist
     }
 
     private _stats(file: string): fs.Stats {
-        return fs.statSync(file);
+        return fs.statSync(file)
     }
- }
+}
 
-export {
+export { BuildAgent }
-    BuildAgent,
-};

src/agent/mock/build-agent.ts

@@ -1,109 +1,116 @@
-import { injectable } from "inversify";
+import { injectable } from 'inversify'
 
-import { IBuildAgent, IExecResult } from "../../core/models";
+import { IBuildAgent, IExecResult } from '../../core/models'
+import { IRequestOptions } from 'typed-rest-client/Interfaces'
 
 @injectable()
 class BuildAgent implements IBuildAgent {
-
+    proxyConfiguration(url: string): IRequestOptions {
+        console.log('proxyConfiguration')
+        return undefined
+    }
     public get agentName(): string {
-        console.log("getAgentName");
+        console.log('getAgentName')
-        return "Mock";
+        return 'Mock'
     }
 
     public find(toolName: string, versionSpec: string, arch?: string): string {
-        console.log("find");
+        console.log('find')
-        return "find";
+        return 'find'
     }
 
-    public cacheDir(sourceDir: string, tool: string, version: string, arch?: string): Promise<string> {
+    public cacheDir(
-        console.log("cacheDir");
+        sourceDir: string,
-        return Promise.resolve("cacheDir");
+        tool: string,
+        version: string,
+        arch?: string
+    ): Promise<string> {
+        console.log('cacheDir')
+        return Promise.resolve('cacheDir')
     }
 
     public createTempDir(): Promise<string> {
-        console.log("createTempDir");
+        console.log('createTempDir')
-        return Promise.resolve("createTempDir");
+        return Promise.resolve('createTempDir')
     }
 
     public debug(message: string): void {
-        console.log("debug");
+        console.log('debug')
     }
 
     public setFailed(message: string, done?: boolean): void {
-        console.log("setFailed");
+        console.log('setFailed')
     }
 
     public setSucceeded(message: string, done?: boolean): void {
-        console.log("setSucceeded");
+        console.log('setSucceeded')
     }
 
     public exportVariable(name: string, val: string): void {
-        console.log("exportVariable");
+        console.log('exportVariable')
     }
 
     public getVariable(name: string): string {
-        console.log("getVariable");
+        console.log('getVariable')
-        return "getVariable";
+        return 'getVariable'
     }
 
     public addPath(inputPath: string): void {
-        console.log("addPath");
+        console.log('addPath')
     }
 
     public which(tool: string, check?: boolean): Promise<string> {
-        console.log("which");
+        console.log('which')
-        return Promise.resolve("which");
+        return Promise.resolve('which')
     }
 
     public exec(exec: string, args: string[]): Promise<IExecResult> {
         return Promise.resolve({
             code: 0,
             error: null,
-            stderr: "result.stderr",
+            stderr: 'result.stderr',
-            stdout: "result.stdout",
+            stdout: 'result.stdout'
-        });
+        })
     }
 
     public getSourceDir(): string {
-        console.log("getSourceDir");
+        console.log('getSourceDir')
-        return "getSourceDir";
+        return 'getSourceDir'
     }
 
     public setOutput(name: string, value: string): void {
-        console.log("setOutput");
+        console.log('setOutput')
     }
 
     public getInput(input: string, required?: boolean): string {
-        console.log("getInput");
+        console.log('getInput')
-        return "getInput";
+        return 'getInput'
     }
 
     public getListInput(input: string, required?: boolean): string[] {
-        console.log("getListInput");
+        console.log('getListInput')
-        return ["getInput"];
+        return ['getInput']
     }
 
     public getBooleanInput(input: string, required?: boolean): boolean {
-        console.log("getBooleanInput");
+        console.log('getBooleanInput')
-        return false;
+        return false
     }
 
     public isValidInputFile(input: string, file: string) {
-        console.log("isValidInputFile");
+        console.log('isValidInputFile')
-        return false;
+        return false
     }
 
     public fileExists(file: string) {
-        console.log("fileExists");
+        console.log('fileExists')
-        return false;
+        return false
     }
 
     public directoryExists(file: string) {
-        console.log("directoryExists");
+        console.log('directoryExists')
-        return false;
+        return false
     }
 }
 
-export {
+export { BuildAgent }
-    BuildAgent,
-};

src/core/dotnet-tool.ts

@@ -1,68 +1,83 @@
-import * as fs from "fs";
+import * as fs from 'fs'
-import * as os from "os";
+import * as os from 'os'
-import * as path from "path";
+import * as path from 'path'
-import * as http from "typed-rest-client/HttpClient";
+import * as http from 'typed-rest-client/HttpClient'
 
-import { inject, injectable } from "inversify";
+import { inject, injectable } from 'inversify'
-import { TYPES, IExecResult, IBuildAgent } from "./models";
+import { TYPES, IExecResult, IBuildAgent } from './models'
-import { IVersionManager } from "./versionManager";
+import { IVersionManager } from './versionManager'
 
 export interface IDotnetTool {
-    disableTelemetry(): void;
+    disableTelemetry(): void
-    toolInstall(toolName: string, versionSpec: string, checkLatest: boolean, includePre: boolean): Promise<string>;
+    toolInstall(
+        toolName: string,
+        versionSpec: string,
+        checkLatest: boolean,
+        includePre: boolean
+    ): Promise<string>
 }
 
 @injectable()
 export class DotnetTool implements IDotnetTool {
+    protected buildAgent: IBuildAgent
+    protected versionManager: IVersionManager
+    private httpClient: http.HttpClient
 
-    protected buildAgent: IBuildAgent;
+    private static readonly nugetRoot: string =
-    protected versionManager: IVersionManager;
+        'https://api-v2v3search-0.nuget.org/'
-    private httpClient: http.HttpClient;
 
     constructor(
         @inject(TYPES.IBuildAgent) buildAgent: IBuildAgent,
-        @inject(TYPES.IVersionManager) versionManager: IVersionManager,
+        @inject(TYPES.IVersionManager) versionManager: IVersionManager
     ) {
-        this.buildAgent = buildAgent;
+        this.buildAgent = buildAgent
-        this.versionManager = versionManager;
+        this.versionManager = versionManager
-        this.httpClient = new http.HttpClient("dotnet");
+        this.httpClient = new http.HttpClient(
+            'dotnet',
+            undefined,
+            this.buildAgent.proxyConfiguration(DotnetTool.nugetRoot)
+        )
     }
 
     public disableTelemetry(): void {
-        this.buildAgent.exportVariable("DOTNET_CLI_TELEMETRY_OPTOUT", "1");
+        this.buildAgent.exportVariable('DOTNET_CLI_TELEMETRY_OPTOUT', '1')
     }
 
     public execute(cmd: string, args: string[]): Promise<IExecResult> {
-        console.log(`Command: ${cmd} ${args.join(' ')}`);
+        console.log(`Command: ${cmd} ${args.join(' ')}`)
-        return this.buildAgent.exec(cmd, args);
+        return this.buildAgent.exec(cmd, args)
     }
 
-    public async toolInstall(toolName: string, versionSpec: string, checkLatest: boolean, includePre: boolean)
+    public async toolInstall(
-    : Promise<string> {
+        toolName: string,
-        console.log("");
+        versionSpec: string,
-        console.log("--------------------------");
+        checkLatest: boolean,
-        console.log(`Installing ${toolName} version ` + versionSpec);
+        includePre: boolean
-        console.log("--------------------------");
+    ): Promise<string> {
+        console.log('')
+        console.log('--------------------------')
+        console.log(`Installing ${toolName} version ` + versionSpec)
+        console.log('--------------------------')
 
         if (this.versionManager.isExplicitVersion(versionSpec)) {
-            checkLatest = false; // check latest doesn't make sense when explicit version
+            checkLatest = false // check latest doesn't make sense when explicit version
         }
 
-        let toolPath: string;
+        let toolPath: string
         if (!checkLatest) {
             //
             // Let's try and resolve the version spec locally first
             //
-            toolPath = this.buildAgent.find(toolName, versionSpec);
+            toolPath = this.buildAgent.find(toolName, versionSpec)
         }
 
         if (!toolPath) {
-            let version: string;
+            let version: string
             if (this.versionManager.isExplicitVersion(versionSpec)) {
                 //
                 // Explicit version was specified. No need to query for list of versions.
                 //
-                version = versionSpec;
+                version = versionSpec
             } else {
                 //
                 // Let's query and resolve the latest version for the versionSpec.
@@ -70,21 +85,27 @@ export class DotnetTool implements IDotnetTool {
                 // If your tool doesn't offer a mechanism to query,
                 // then it can only support exact version inputs.
                 //
-                version = await this.queryLatestMatch(toolName, versionSpec, includePre);
+                version = await this.queryLatestMatch(
+                    toolName,
+                    versionSpec,
+                    includePre
+                )
                 if (!version) {
-                    throw new Error(`Unable to find ${toolName} version '${versionSpec}'.`);
+                    throw new Error(
+                        `Unable to find ${toolName} version '${versionSpec}'.`
+                    )
                 }
 
                 //
                 // Check the cache for the resolved version.
                 //
-                toolPath = this.buildAgent.find(toolName, version);
+                toolPath = this.buildAgent.find(toolName, version)
             }
             if (!toolPath) {
                 //
                 // Download, extract, cache
                 //
-                toolPath = await this.acquireTool(toolName, version);
+                toolPath = await this.acquireTool(toolName, version)
             }
         }
 
@@ -92,60 +113,82 @@ export class DotnetTool implements IDotnetTool {
         // Prepend the tools path. This prepends the PATH for the current process and
         // instructs the agent to prepend for each task that follows.
         //
-        this.buildAgent.debug(`toolPath: ${toolPath}`);
+        this.buildAgent.debug(`toolPath: ${toolPath}`)
 
-        if (os.platform() !== "win32") {
+        if (
-            const dotnetRoot = path.dirname(fs.readlinkSync(await this.buildAgent.which("dotnet")));
+            os.platform() !== 'win32' &&
-            this.buildAgent.exportVariable("DOTNET_ROOT", dotnetRoot);
+            !this.buildAgent.getVariable('DOTNET_ROOT')
+        ) {
+            let dotnetPath = await this.buildAgent.which('dotnet')
+            dotnetPath = fs.readlinkSync(dotnetPath) || dotnetPath
+            const dotnetRoot = path.dirname(dotnetPath)
+            this.buildAgent.exportVariable('DOTNET_ROOT', dotnetRoot)
         }
-        this.buildAgent.addPath(toolPath);
+        this.buildAgent.addPath(toolPath)
 
-        return toolPath;
+        return toolPath
     }
 
-    private async queryLatestMatch(toolName: string, versionSpec: string, includePrerelease: boolean): Promise<string> {
+    private async queryLatestMatch(
-        this.buildAgent.debug(`querying tool versions for ${toolName}${versionSpec ? `@${versionSpec}` : ""} ${includePrerelease ? "including pre-releases" : ""}`);
+        toolName: string,
+        versionSpec: string,
+        includePrerelease: boolean
+    ): Promise<string> {
+        this.buildAgent.debug(
+            `querying tool versions for ${toolName}${
+                versionSpec ? `@${versionSpec}` : ''
+            } ${includePrerelease ? 'including pre-releases' : ''}`
+        )
 
-        const downloadPath = `https://api-v2v3search-0.nuget.org/query?q=${encodeURIComponent(toolName.toLowerCase())}&prerelease=${includePrerelease ? "true" : "false"}&semVerLevel=2.0.0`;
+        const downloadPath = `${
-        const res = await this.httpClient.get(downloadPath);
+            DotnetTool.nugetRoot
+        }query?q=${encodeURIComponent(toolName.toLowerCase())}&prerelease=${
+            includePrerelease ? 'true' : 'false'
+        }&semVerLevel=2.0.0`
+
+        const res = await this.httpClient.get(downloadPath)
 
         if (!res || res.message.statusCode !== 200) {
-            return null;
+            return null
         }
 
-        const body: string = await res.readBody();
+        const body: string = await res.readBody()
-        const data = JSON.parse(body).data;
+        const data = JSON.parse(body).data
 
-        const versions = (data[0].versions as { version: string }[]).map((x) => x.version);
+        const versions = (data[0].versions as { version: string }[]).map(
+            x => x.version
+        )
         if (!versions || !versions.length) {
-            return null;
+            return null
         }
 
-        this.buildAgent.debug(`got versions: ${versions.join(", ")}`);
+        this.buildAgent.debug(`got versions: ${versions.join(', ')}`)
 
-        return this.versionManager.evaluateVersions(versions, versionSpec);
+        return this.versionManager.evaluateVersions(versions, versionSpec)
     }
 
-    private async acquireTool(toolName: string, version: string): Promise<string> {
+    private async acquireTool(
-
+        toolName: string,
-        const tempDirectory = await this.buildAgent.createTempDir();
+        version: string
-        let args = ["tool", "install", toolName, "--tool-path", tempDirectory];
+    ): Promise<string> {
+        const tempDirectory = await this.buildAgent.createTempDir()
+        let args = ['tool', 'install', toolName, '--tool-path', tempDirectory]
 
         if (version) {
-            version = this.versionManager.cleanVersion(version);
+            version = this.versionManager.cleanVersion(version)
-            args = args.concat(["--version", version]);
+            args = args.concat(['--version', version])
         }
 
-        const result = await this.execute("dotnet", args);
+        const result = await this.execute('dotnet', args)
-        const status = result.code === 0 ? "success" : "failure";
+        const status = result.code === 0 ? 'success' : 'failure'
-        const message = result.code === 0 ? result.stdout : result.stderr;
+        const message = result.code === 0 ? result.stdout : result.stderr
 
-        this.buildAgent.debug(`tool install result: ${status} ${message}`);
+        this.buildAgent.debug(`tool install result: ${status} ${message}`)
 
         if (result.code) {
-            throw new Error("Error installing tool");
+            throw new Error('Error installing tool')
         }
 
-        return await this.buildAgent.cacheDir(tempDirectory, toolName, version);
+        return await this.buildAgent.cacheDir(tempDirectory, toolName, version)
     }
-}
+}

src/core/ioc.ts

@@ -1,11 +1,11 @@
-import { Container } from "inversify";
+import { Container } from 'inversify'
-import { IVersionManager, VersionManager } from "./versionManager";
+import { IVersionManager, VersionManager } from './versionManager'
-import { TYPES, IBuildAgent } from "./models";
+import { TYPES, IBuildAgent } from './models'
-import { BuildAgent } from "../agent/mock/build-agent";
+import { BuildAgent } from '../agent/mock/build-agent'
 
-const container = new Container();
+const container = new Container()
 
-container.bind<IVersionManager>(TYPES.IVersionManager).to(VersionManager);
+container.bind<IVersionManager>(TYPES.IVersionManager).to(VersionManager)
-container.bind<IBuildAgent>(TYPES.IBuildAgent).to(BuildAgent);
+container.bind<IBuildAgent>(TYPES.IBuildAgent).to(BuildAgent)
 
-export default container;
+export default container