diff --git a/install.ps1 b/install.ps1 index a27e1ce4b2a..5c48358ad5b 100644 --- a/install.ps1 +++ b/install.ps1 @@ -1,8 +1,32 @@ #Requires -Version 7.0 +<# +.Description + Download and install dagger. +.PARAMETER DaggerVersion + Semver version of dagger to install. +.PARAMETER DaggerCommit + Commit SHA for a dev build of dagger to install. +.EXAMPLE + .\install.ps1 + Install with default settings. +.EXAMPLE + .\install.ps1 -InstallPath path\to\dir + Install to path/to/dir. +.EXAMPLE + .\install.ps1 -DaggerVersion vX.Y.Z + Install specified version vX.Y.Z. +.EXAMPLE + .\install.ps1 -DaggerCommit head + Install latest dev build. +.EXAMPLE + .\install.ps1 -DaggerCommit [commit] + Install specified dev build [commit]. +#> + Param ( [Parameter(Mandatory = $false)][System.Management.Automation.SemanticVersion]$DaggerVersion, - [Parameter(Mandatory = $false)][string][ValidatePattern("^(?:[0-9a-fA-F]{40})?$")]$DaggerCommit, + [Parameter(Mandatory = $false)][string][ValidatePattern("^(?:head|(?:[0-9a-fA-F]{40}))?$")]$DaggerCommit, [Parameter(Mandatory = $false)][string]$DownloadPath = [System.IO.Path]::GetTempFileName(), [Parameter(Mandatory = $false)][string]$InstallPath = "$env:USERPROFILE\dagger", [Parameter(Mandatory = $false)][switch]$AddToPath = $false, @@ -412,7 +436,7 @@ if ($isInvoked) { function Install-Dagger { Param ( [Parameter(Mandatory = $false)][System.Management.Automation.SemanticVersion]$DaggerVersion, - [Parameter(Mandatory = $false)][string][ValidatePattern("^(?:[0-9a-fA-F]{40})?$")]$DaggerCommit, + [Parameter(Mandatory = $false)][string][ValidatePattern("^(?:head|(?:[0-9a-fA-F]{40}))?$")]$DaggerCommit, [Parameter(Mandatory = $false)][string]$DownloadPath = [System.IO.Path]::GetTempFileName(), [Parameter(Mandatory = $false)][string]$InstallPath = "$env:USERPROFILE\dagger", [Parameter(Mandatory = $false)][switch]$AddToPath = $false, diff --git a/install.sh b/install.sh index a33310a7ed3..5c9c1078d5f 100755 --- a/install.sh +++ b/install.sh @@ -235,6 +235,26 @@ End of functions from https://github.com/client9/shlib ------------------------------------------------------------------------ EOF +help() { + cat <: + BIN_DIR= $0 + +Install specified version : + DAGGER_VERSION= $0 + +Install latest dev build: + DAGGER_COMMIT=head $0 +Install specified dev build : + DAGGER_COMMIT= $0 +EOF +} + uname_os() { os=$(uname -s | tr '[:upper:]' '[:lower:]') case "$os" in @@ -374,4 +394,9 @@ execute() { rm -rf "${tmpdir}" } -execute +if [ "$1" = "-h" ] || [ "$1" = "--help" ]; then + help +else + execute +fi +