Merge branch 'stable'

* stable: (GH-1098) Get-FtpFile - change int to long / improve error handling (docs) update generated docs (GH-1187) Get-ChocolateyUnzip - support both archs (GH-1039) Remove quotes before testing path (GH-686) Upgrade Scenarios for Prereleases (GH-686) Upgrade Prereleases (GH-1151) Option - Stop on first package failure (GH-902) Fix: User changed to SYSTEM during env update
chocolatey · Mar 19, 2017 · 40918fb · 40918fb
2 parents f209c2b + e1e3865
commit 40918fb
Show file tree

Hide file tree

Showing 64 changed files with 2,098 additions and 141 deletions.
diff --git a/Scenarios.md b/Scenarios.md
@@ -647,7 +647,7 @@
 
  * should throw an error that it is not allowed
 
-### ChocolateyUpgradeCommand [ 29 Scenario(s), 226 Observation(s) ]
+### ChocolateyUpgradeCommand [ 35 Scenario(s), 286 Observation(s) ]
 
 #### when force upgrading a package
 
@@ -938,6 +938,20 @@
  * should report for all non skipped packages
  * should skip packages in except list
 
+#### when upgrading all packages with prereleases installed
+
+ * should report for all installed packages
+ * should skip packages without upgrades
+ * should upgrade packages with upgrades
+ * should upgrade upgradepackage
+
+#### when upgrading all packages with prereleases installed with excludeprerelease specified
+
+ * should not upgrade upgradepackage
+ * should report for all installed packages
+ * should skip packages without upgrades
+ * should upgrade packages with upgrades
+
 #### when upgrading an existing package happy path
 
  * config should match package result name
@@ -958,6 +972,70 @@
  * should upgrade the package
  * should upgrade where install location reports
 
+#### when upgrading an existing package with prerelease available and prerelease specified
+
+ * config should match package result name
+ * should contain a warning message that it upgraded successfully
+ * should contain a warning message with old and new versions
+ * should contain newer version in directory
+ * should delete the rollback
+ * should have a successful package result
+ * should have executed chocolateyBeforeModify before chocolateyInstall
+ * should have executed chocolateyBeforeModify script for original package
+ * should have executed chocolateyInstall script for new package
+ * should match the upgrade version of the new beta
+ * should not have executed chocolateyBeforeModify script for new package
+ * should not have executed chocolateyUninstall script for original package
+ * should not have inconclusive package result
+ * should not have warning package result
+ * should upgrade a package in the lib directory
+ * should upgrade the package
+ * should upgrade where install location reports
+
+#### when upgrading an existing package with prerelease available without prerelease specified
+
+ * should be the same version of the package
+ * should contain a message that no packages were upgraded
+ * should contain a message that you have the latest version available
+ * should have a successful package result
+ * should have inconclusive package result
+ * should match the original package version
+ * should not create a rollback
+ * should not have warning package result
+ * should not remove the package from the lib directory
+
+#### when upgrading an existing prerelease package with prerelease available with excludeprelease and without prerelease specified
+
+ * should be the same version of the package
+ * should contain a message that no packages were upgraded
+ * should contain a message that you have the latest version available
+ * should have a successful package result
+ * should have inconclusive package result
+ * should not create a rollback
+ * should not have warning package result
+ * should not remove the package from the lib directory
+ * should only find the last stable version
+
+#### when upgrading an existing prerelease package without prerelease specified
+
+ * config should match package result name
+ * should contain a warning message that it upgraded successfully
+ * should contain a warning message with old and new versions
+ * should contain newer version in directory
+ * should delete the rollback
+ * should have a successful package result
+ * should have executed chocolateyBeforeModify before chocolateyInstall
+ * should have executed chocolateyBeforeModify script for original package
+ * should have executed chocolateyInstall script for new package
+ * should match the upgrade version of the new beta
+ * should not have executed chocolateyBeforeModify script for new package
+ * should not have executed chocolateyUninstall script for original package
+ * should not have inconclusive package result
+ * should not have warning package result
+ * should upgrade a package in the lib directory
+ * should upgrade the package
+ * should upgrade where install location reports
+
 #### when upgrading packages with packages config
 
  * should throw an error that it is not allowed
diff --git a/docs/generated/CommandsApiKey.md b/docs/generated/CommandsApiKey.md
@@ -48,7 +48,13 @@ Includes [[default options/switches|CommandsReference#default-options-and-switch
      Debug - Show debug messaging.
 
  -v, --verbose
-     Verbose - Show verbose messaging.
+     Verbose - Show verbose messaging. Very verbose messaging, avoid using 
+       under normal circumstances.
+
+     --trace
+     Trace - Show trace messaging. Very, very verbose trace messaging. Avoid 
+       except when needing super low-level .NET Framework debugging. Available 
+       in 0.10.4+.
 
      --acceptlicense, --accept-license
      AcceptLicense - Accept license dialogs automatically. Reserved for 
@@ -71,7 +77,7 @@ Includes [[default options/switches|CommandsReference#default-options-and-switch
      --timeout, --execution-timeout=VALUE
      CommandExecutionTimeout (in seconds) - The time to allow a command to 
        finish before timing out. Overrides the default execution timeout in the 
-       configuration of 2700 seconds.
+       configuration of 2700 seconds. '0' for infinite starting in 0.10.4.
 
  -c, --cache, --cachelocation, --cache-location=VALUE
      CacheLocation - Location for download cache, defaults to %TEMP% or value 
@@ -91,6 +97,38 @@ Includes [[default options/switches|CommandsReference#default-options-and-switch
        instead of the built-in PowerShell host. Should only be used when 
        internal host is failing. Available in 0.9.10+.
 
+     --no-progress
+     Do Not Show Progress - Do not show download progress percentages. 
+       Available in 0.10.4+.
+
+     --proxy=VALUE
+     Proxy Location - Explicit proxy location. Overrides the default proxy 
+       location of ''. Available for config settings in 0.9.9.9+, this CLI 
+       option available in 0.10.4+.
+
+     --proxy-user=VALUE
+     Proxy User Name - Explicit proxy user (optional). Requires explicity 
+       proxy (`--proxy` or config setting). Overrides the default proxy user of 
+       '123'. Available for config settings in 0.9.9.9+, this CLI option 
+       available in 0.10.4+.
+
+     --proxy-password=VALUE
+     Proxy Password - Explicit proxy password (optional) to be used with 
+       username. Requires explicity proxy (`--proxy` or config setting) and 
+       user name.  Overrides the default proxy password (encrypted in settings 
+       if set). Available for config settings in 0.9.9.9+, this CLI option 
+       available in 0.10.4+.
+
+     --proxy-bypass-list=VALUE
+     ProxyBypassList - Comma separated list of regex locations to bypass on 
+       proxy. Requires explicity proxy (`--proxy` or config setting). Overrides 
+       the default proxy bypass list of ''. Available in 0.10.4+.
+
+     --proxy-bypass-on-local
+     Proxy Bypass On Local - Bypass proxy for local connections. Requires 
+       explicity proxy (`--proxy` or config setting). Overrides the default 
+       proxy bypass on local setting of 'True'. Available in 0.10.4+.
+
  -s, --source=VALUE
      Source [REQUIRED] - The source location for the key
 

diff --git a/docs/generated/CommandsConfig.md b/docs/generated/CommandsConfig.md
@@ -48,7 +48,13 @@ Includes [[default options/switches|CommandsReference#default-options-and-switch
      Debug - Show debug messaging.
 
  -v, --verbose
-     Verbose - Show verbose messaging.
+     Verbose - Show verbose messaging. Very verbose messaging, avoid using 
+       under normal circumstances.
+
+     --trace
+     Trace - Show trace messaging. Very, very verbose trace messaging. Avoid 
+       except when needing super low-level .NET Framework debugging. Available 
+       in 0.10.4+.
 
      --acceptlicense, --accept-license
      AcceptLicense - Accept license dialogs automatically. Reserved for 
@@ -71,7 +77,7 @@ Includes [[default options/switches|CommandsReference#default-options-and-switch
      --timeout, --execution-timeout=VALUE
      CommandExecutionTimeout (in seconds) - The time to allow a command to 
        finish before timing out. Overrides the default execution timeout in the 
-       configuration of 2700 seconds.
+       configuration of 2700 seconds. '0' for infinite starting in 0.10.4.
 
  -c, --cache, --cachelocation, --cache-location=VALUE
      CacheLocation - Location for download cache, defaults to %TEMP% or value 
@@ -91,6 +97,38 @@ Includes [[default options/switches|CommandsReference#default-options-and-switch
        instead of the built-in PowerShell host. Should only be used when 
        internal host is failing. Available in 0.9.10+.
 
+     --no-progress
+     Do Not Show Progress - Do not show download progress percentages. 
+       Available in 0.10.4+.
+
+     --proxy=VALUE
+     Proxy Location - Explicit proxy location. Overrides the default proxy 
+       location of ''. Available for config settings in 0.9.9.9+, this CLI 
+       option available in 0.10.4+.
+
+     --proxy-user=VALUE
+     Proxy User Name - Explicit proxy user (optional). Requires explicity 
+       proxy (`--proxy` or config setting). Overrides the default proxy user of 
+       '123'. Available for config settings in 0.9.9.9+, this CLI option 
+       available in 0.10.4+.
+
+     --proxy-password=VALUE
+     Proxy Password - Explicit proxy password (optional) to be used with 
+       username. Requires explicity proxy (`--proxy` or config setting) and 
+       user name.  Overrides the default proxy password (encrypted in settings 
+       if set). Available for config settings in 0.9.9.9+, this CLI option 
+       available in 0.10.4+.
+
+     --proxy-bypass-list=VALUE
+     ProxyBypassList - Comma separated list of regex locations to bypass on 
+       proxy. Requires explicity proxy (`--proxy` or config setting). Overrides 
+       the default proxy bypass list of ''. Available in 0.10.4+.
+
+     --proxy-bypass-on-local
+     Proxy Bypass On Local - Bypass proxy for local connections. Requires 
+       explicity proxy (`--proxy` or config setting). Overrides the default 
+       proxy bypass on local setting of 'True'. Available in 0.10.4+.
+
      --name=VALUE
      Name - the name of the config setting. Required with some actions. 
        Defaults to empty.

diff --git a/docs/generated/CommandsDownload.md b/docs/generated/CommandsDownload.md
@@ -2,21 +2,23 @@
 
 # Download Command (choco download)
 
-Package Internalizer
+### Package Copy / Package Downloader
+
+[Chocolatey Professional](https://chocolatey.org/compare) and up starting in version 1.7.1.
+
+Downloads a package from a source and unpacks it.
+
+### Package Internalizer
 
 [Chocolatey for Business](https://chocolatey.org/compare) starting at licensed version 1.5.0.
 
-Downloads a package from a source, optionally downloading remote 
- resources and recompiling the package to use internal resources. This 
- takes an existing package and makes it available without any internet 
+Downloads a package from a source, optionally downloading remote
+ resources and recompiling the package to use internal resources. This
+ takes an existing package and makes it available without any internet
  requirement.
 
 See https://chocolatey.org/docs/features-automatically-recompile-packages
 
-Package Copy / Package Downloader
-[Chocolatey Professional](https://chocolatey.org/compare) and up starting in version 1.7.1.
-
-Downloads a package from a source and unpacks it. 
 
 ## Usage
 
@@ -58,7 +60,13 @@ Includes [[default options/switches|CommandsReference#default-options-and-switch
      Debug - Show debug messaging.
 
  -v, --verbose
-     Verbose - Show verbose messaging.
+     Verbose - Show verbose messaging. Very verbose messaging, avoid using 
+       under normal circumstances.
+
+     --trace
+     Trace - Show trace messaging. Very, very verbose trace messaging. Avoid 
+       except when needing super low-level .NET Framework debugging. Available 
+       in 0.10.4+.
 
      --acceptlicense, --accept-license
      AcceptLicense - Accept license dialogs automatically. Reserved for 
@@ -81,7 +89,7 @@ Includes [[default options/switches|CommandsReference#default-options-and-switch
      --timeout, --execution-timeout=VALUE
      CommandExecutionTimeout (in seconds) - The time to allow a command to 
        finish before timing out. Overrides the default execution timeout in the 
-       configuration of 2700 seconds.
+       configuration of 2700 seconds. '0' for infinite starting in 0.10.4.
 
  -c, --cache, --cachelocation, --cache-location=VALUE
      CacheLocation - Location for download cache, defaults to %TEMP% or value 
@@ -101,6 +109,38 @@ Includes [[default options/switches|CommandsReference#default-options-and-switch
        instead of the built-in PowerShell host. Should only be used when 
        internal host is failing. Available in 0.9.10+.
 
+     --no-progress
+     Do Not Show Progress - Do not show download progress percentages. 
+       Available in 0.10.4+.
+
+     --proxy=VALUE
+     Proxy Location - Explicit proxy location. Overrides the default proxy 
+       location of ''. Available for config settings in 0.9.9.9+, this CLI 
+       option available in 0.10.4+.
+
+     --proxy-user=VALUE
+     Proxy User Name - Explicit proxy user (optional). Requires explicity 
+       proxy (`--proxy` or config setting). Overrides the default proxy user of 
+       '123'. Available for config settings in 0.9.9.9+, this CLI option 
+       available in 0.10.4+.
+
+     --proxy-password=VALUE
+     Proxy Password - Explicit proxy password (optional) to be used with 
+       username. Requires explicity proxy (`--proxy` or config setting) and 
+       user name.  Overrides the default proxy password (encrypted in settings 
+       if set). Available for config settings in 0.9.9.9+, this CLI option 
+       available in 0.10.4+.
+
+     --proxy-bypass-list=VALUE
+     ProxyBypassList - Comma separated list of regex locations to bypass on 
+       proxy. Requires explicity proxy (`--proxy` or config setting). Overrides 
+       the default proxy bypass list of ''. Available in 0.10.4+.
+
+     --proxy-bypass-on-local
+     Proxy Bypass On Local - Bypass proxy for local connections. Requires 
+       explicity proxy (`--proxy` or config setting). Overrides the default 
+       proxy bypass on local setting of 'True'. Available in 0.10.4+.
+
  -s, --source=VALUE
      Source - The source to find the package(s) to download. Defaults to 
        default feeds.
@@ -125,23 +165,39 @@ Includes [[default options/switches|CommandsReference#default-options-and-switch
      Certificate Password - the client certificate's password to the source. 
        Defaults to empty.
 
-     --outputdirectory=VALUE
+     --out, --outdir, --outputdirectory, --output-directory=VALUE
      OutputDirectory - Specifies the directory for the downloaded Chocolatey 
        package file. If not specified, uses the current directory.
 
+ -i, --ignoredependencies, --ignore-dependencies
+     IgnoreDependencies - Ignore dependencies when installing package(s). 
+       [Licensed editions](https://chocolatey.org/compare) v1.9.0+ Defaults to false.
+
      --recompile, --internalize
      Recompile / Internalize - Download all external resources and recompile 
-       the package to use the local resources instead.
+       the package to use the local resources instead. Business editions only 
+       (licensed version 1.5.0+).
 
      --resources-location=VALUE
-     Resources Location - When recompiling, use this location for resources 
-       instead of embedding the downloaded resources into the package.
+     Resources Location - When internalizing, use this location for resources 
+       instead of embedding the downloaded resources into the package. Can be a 
+       file share or an internal url location. When it is a file share, it will 
+       attempt to download to that location. When it is an internal url, it 
+       will download locally and give further instructions on where it should 
+       be uploaded to match package edits. Business editions only (licensed 
+       version 1.5.1+).
+
+     --download-location=VALUE
+     Download Location - OPTIONAL - when internalizing, download the 
+       resources to this location. Used with Resources Location (and defaults 
+       to Resources Location when not set). Business editions only (licensed 
+       version 1.8.3+). 
 
      --append-useoriginallocation, --append-use-original-location
      Append -UseOriginalLocation - When `Install-ChocolateyPackage` is 
        internalized, append the `-UseOriginalLocation` parameter to the 
        function. Business editions only (licensed version 1.7.0+). Requires at 
-       least Chocolatey v0.10.1 for `Install-ChocolateyPacakge` to recognize 
+       least Chocolatey v0.10.1 for `Install-ChocolateyPackage` to recognize 
        the switch appropriately. Overrides the feature 
        'internalizeAppendUseOriginalLocation' set to by default to 'False'.