Merge pull request chocolatey#2463 from TheCakeIsNaOH/install-pin

gep13 · web-flow · commit 974a3bce1f8a · 2022-08-11T22:41:29.000+01:00
(chocolatey#798) Add parameter to install and upgrade commands to pin after install
diff --git a/src/chocolatey.tests/infrastructure.app/commands/ChocolateyInstallCommandSpecs.cs b/src/chocolatey.tests/infrastructure.app/commands/ChocolateyInstallCommandSpecs.cs
@@ -235,6 +235,24 @@ public void should_add_short_version_of_password_to_the_option_set()
             {
                 optionSet.Contains("p").ShouldBeTrue();
             }
+
+            [Fact]
+            public void should_add_pin_to_the_option_set()
+            {
+                optionSet.Contains("pinpackage").ShouldBeTrue();
+            }
+
+            [Fact]
+            public void should_add_long_version_of_pin_to_the_option_set()
+            {
+                optionSet.Contains("pin-package").ShouldBeTrue();
+            }
+
+            [Fact]
+            public void should_add_short_version_of_pin_to_the_option_set()
+            {
+                optionSet.Contains("pin").ShouldBeTrue();
+            }
         }
 
         public class when_handling_additional_argument_parsing : ChocolateyInstallCommandSpecsBase
diff --git a/src/chocolatey.tests/infrastructure.app/commands/ChocolateyUpgradeCommandSpecs.cs b/src/chocolatey.tests/infrastructure.app/commands/ChocolateyUpgradeCommandSpecs.cs
@@ -217,6 +217,24 @@ public void should_add_short_version_of_password_to_the_option_set()
             {
                 optionSet.Contains("p").ShouldBeTrue();
             }
+
+            [Fact]
+            public void should_add_pin_to_the_option_set()
+            {
+                optionSet.Contains("pinpackage").ShouldBeTrue();
+            }
+
+            [Fact]
+            public void should_add_long_version_of_pin_to_the_option_set()
+            {
+                optionSet.Contains("pin-package").ShouldBeTrue();
+            }
+
+            [Fact]
+            public void should_add_short_version_of_pin_to_the_option_set()
+            {
+                optionSet.Contains("pin").ShouldBeTrue();
+            }
         }
 
         public class when_handling_additional_argument_parsing : ChocolateyUpgradeCommandSpecsBase
diff --git a/src/chocolatey/infrastructure.app/commands/ChocolateyInstallCommand.cs b/src/chocolatey/infrastructure.app/commands/ChocolateyInstallCommand.cs
@@ -108,7 +108,7 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon
                       {
                           if (option != null) configuration.Features.AllowEmptyChecksums = true;
                       })
-                 .Add("allowemptychecksumsecure|allowemptychecksumssecure|allow-empty-checksums-secure",
+                .Add("allowemptychecksumsecure|allowemptychecksumssecure|allow-empty-checksums-secure",
                       "Allow Empty Checksums Secure - Allow packages to have empty checksums for downloaded resources from secure locations (HTTPS). Overrides the default feature '{0}' set to '{1}'. Available in 0.10.0+.".format_with(ApplicationParameters.Features.AllowEmptyChecksumsSecure, configuration.Features.AllowEmptyChecksumsSecure.to_string()),
                       option =>
                       {
@@ -146,20 +146,20 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon
                              configuration.Features.UsePackageExitCodes = false;
                          }
                      })
-                 .Add("usepackagecodes|usepackageexitcodes|use-package-codes|use-package-exit-codes",
+                .Add("usepackagecodes|usepackageexitcodes|use-package-codes|use-package-exit-codes",
                      "UsePackageExitCodes - Package scripts can provide exit codes. Use those for choco's exit code when non-zero (this value can come from a dependency package). Chocolatey defines valid exit codes as 0, 1605, 1614, 1641, 3010.  Overrides the default feature '{0}' set to '{1}'. Available in 0.9.10+.".format_with(ApplicationParameters.Features.UsePackageExitCodes, configuration.Features.UsePackageExitCodes.to_string()),
                      option => configuration.Features.UsePackageExitCodes = option != null
                      )
-                 .Add("stoponfirstfailure|stop-on-first-failure|stop-on-first-package-failure",
+                .Add("stoponfirstfailure|stop-on-first-failure|stop-on-first-package-failure",
                      "Stop On First Package Failure - stop running install, upgrade or uninstall on first package failure instead of continuing with others. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.4+.".format_with(ApplicationParameters.Features.StopOnFirstPackageFailure, configuration.Features.StopOnFirstPackageFailure.to_string()),
                      option => configuration.Features.StopOnFirstPackageFailure = option != null
                      )
-                 .Add("exitwhenrebootdetected|exit-when-reboot-detected",
+                .Add("exitwhenrebootdetected|exit-when-reboot-detected",
                      "Exit When Reboot Detected - Stop running install, upgrade, or uninstall when a reboot request is detected. Requires '{0}' feature to be turned on. Will exit with either {1} or {2}. Overrides the default feature '{3}' set to '{4}'. Available in 0.10.12+.".format_with
                      (ApplicationParameters.Features.UsePackageExitCodes, ApplicationParameters.ExitCodes.ErrorFailNoActionReboot, ApplicationParameters.ExitCodes.ErrorInstallSuspend, ApplicationParameters.Features.ExitOnRebootDetected, configuration.Features.ExitOnRebootDetected.to_string()),
                      option => configuration.Features.ExitOnRebootDetected = option != null
                      )
-                 .Add("ignoredetectedreboot|ignore-detected-reboot",
+                .Add("ignoredetectedreboot|ignore-detected-reboot",
                      "Ignore Detected Reboot - Ignore any detected reboots if found. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.12+.".format_with
                      (ApplicationParameters.Features.ExitOnRebootDetected, configuration.Features.ExitOnRebootDetected.to_string()),
                      option =>
@@ -179,6 +179,10 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon
                              configuration.Features.UsePackageRepositoryOptimizations = false;
                          }
                      })
+                .Add("pin|pinpackage|pin-package",
+                    "Pin Package - Add a pin to the package after install. Available in 1.2.0+",
+                    option => configuration.PinPackage = option != null
+                    )
                 ;
 
             //todo: #770 package name can be a url / installertype
diff --git a/src/chocolatey/infrastructure.app/commands/ChocolateyUpgradeCommand.cs b/src/chocolatey/infrastructure.app/commands/ChocolateyUpgradeCommand.cs
@@ -152,23 +152,23 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon
                              configuration.Features.UsePackageExitCodes = false;
                          }
                      })
-                 .Add("usepackagecodes|usepackageexitcodes|use-package-codes|use-package-exit-codes",
+                .Add("usepackagecodes|usepackageexitcodes|use-package-codes|use-package-exit-codes",
                      "UsePackageExitCodes - Package scripts can provide exit codes. Use those for choco's exit code when non-zero (this value can come from a dependency package). Chocolatey defines valid exit codes as 0, 1605, 1614, 1641, 3010. Overrides the default feature '{0}' set to '{1}'. Available in 0.9.10+.".format_with(ApplicationParameters.Features.UsePackageExitCodes, configuration.Features.UsePackageExitCodes.to_string()),
                      option => configuration.Features.UsePackageExitCodes = option != null
                      )
-                 .Add("except=",
+                .Add("except=",
                      "Except - a comma-separated list of package names that should not be upgraded when upgrading 'all'. Overrides the configuration setting '{0}' set to '{1}'. Available in 0.9.10+.".format_with(ApplicationParameters.ConfigSettings.UpgradeAllExceptions, configuration.UpgradeCommand.PackageNamesToSkip.to_string()),
                      option => configuration.UpgradeCommand.PackageNamesToSkip = option.remove_surrounding_quotes()
                      )
-                 .Add("stoponfirstfailure|stop-on-first-failure|stop-on-first-package-failure",
+                .Add("stoponfirstfailure|stop-on-first-failure|stop-on-first-package-failure",
                      "Stop On First Package Failure - stop running install, upgrade or uninstall on first package failure instead of continuing with others. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.4+.".format_with(ApplicationParameters.Features.StopOnFirstPackageFailure, configuration.Features.StopOnFirstPackageFailure.to_string()),
                      option => configuration.Features.StopOnFirstPackageFailure = option != null
                      )
-                 .Add("skip-if-not-installed|only-upgrade-installed|skip-when-not-installed",
+                .Add("skip-if-not-installed|only-upgrade-installed|skip-when-not-installed",
                      "Skip Packages Not Installed - if a package is not installed, do not install it during the upgrade process. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.12+.".format_with(ApplicationParameters.Features.SkipPackageUpgradesWhenNotInstalled, configuration.Features.SkipPackageUpgradesWhenNotInstalled.to_string()),
                      option => configuration.Features.SkipPackageUpgradesWhenNotInstalled = option != null
                      )
-                 .Add("install-if-not-installed",
+                .Add("install-if-not-installed",
                      "Install Missing Packages When Not Installed - if a package is not installed, install it as part of running upgrade (typically default behavior). Overrides the default feature '{0}' set to '{1}'. Available in 0.10.12+.".format_with(ApplicationParameters.Features.SkipPackageUpgradesWhenNotInstalled, configuration.Features.SkipPackageUpgradesWhenNotInstalled.to_string()),
                      option =>
                      {
@@ -177,28 +177,28 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon
                              configuration.Features.SkipPackageUpgradesWhenNotInstalled = false;
                          }
                      })
-                 .Add("exclude-pre|exclude-prerelease|exclude-prereleases",
+                .Add("exclude-pre|exclude-prerelease|exclude-prereleases",
                      "Exclude Prerelease - Should prerelease be ignored for upgrades? Will be ignored if you pass `--pre`. Available in 0.10.4+.",
                      option => configuration.UpgradeCommand.ExcludePrerelease = option != null
                      )
-                 .Add("userememberedargs|userememberedarguments|userememberedoptions|use-remembered-args|use-remembered-arguments|use-remembered-options",
+                .Add("userememberedargs|userememberedarguments|userememberedoptions|use-remembered-args|use-remembered-arguments|use-remembered-options",
                      "Use Remembered Options for Upgrade - use the arguments and options used during install for upgrade. Does not override arguments being passed at runtime. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.4+.".format_with(ApplicationParameters.Features.UseRememberedArgumentsForUpgrades, configuration.Features.UseRememberedArgumentsForUpgrades.to_string()),
                      option =>
                      {
                          if (option != null) configuration.Features.UseRememberedArgumentsForUpgrades = true;
                      })
-                 .Add("ignorerememberedargs|ignorerememberedarguments|ignorerememberedoptions|ignore-remembered-args|ignore-remembered-arguments|ignore-remembered-options",
+                .Add("ignorerememberedargs|ignorerememberedarguments|ignorerememberedoptions|ignore-remembered-args|ignore-remembered-arguments|ignore-remembered-options",
                      "Ignore Remembered Options for Upgrade - ignore the arguments and options used during install for upgrade. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.4+.".format_with(ApplicationParameters.Features.UseRememberedArgumentsForUpgrades, configuration.Features.UseRememberedArgumentsForUpgrades.to_string()),
                      option =>
                      {
                          if (option != null) configuration.Features.UseRememberedArgumentsForUpgrades = false;
                      })
-                 .Add("exitwhenrebootdetected|exit-when-reboot-detected",
+                .Add("exitwhenrebootdetected|exit-when-reboot-detected",
                      "Exit When Reboot Detected - Stop running install, upgrade, or uninstall when a reboot request is detected. Requires '{0}' feature to be turned on. Will exit with either {1} or {2}. Overrides the default feature '{3}' set to '{4}'. Available in 0.10.12+.".format_with
                          (ApplicationParameters.Features.UsePackageExitCodes, ApplicationParameters.ExitCodes.ErrorFailNoActionReboot, ApplicationParameters.ExitCodes.ErrorInstallSuspend, ApplicationParameters.Features.ExitOnRebootDetected, configuration.Features.ExitOnRebootDetected.to_string()),
                      option => configuration.Features.ExitOnRebootDetected = option != null
                      )
-                 .Add("ignoredetectedreboot|ignore-detected-reboot",
+                .Add("ignoredetectedreboot|ignore-detected-reboot",
                      "Ignore Detected Reboot - Ignore any detected reboots if found. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.12+.".format_with
                          (ApplicationParameters.Features.ExitOnRebootDetected, configuration.Features.ExitOnRebootDetected.to_string()),
                      option =>
@@ -208,7 +208,7 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon
                              configuration.Features.ExitOnRebootDetected = false;
                          }
                      })
-                 .Add("disable-repository-optimizations|disable-package-repository-optimizations",
+                .Add("disable-repository-optimizations|disable-package-repository-optimizations",
                      "Disable Package Repository Optimizations - Do not use optimizations for reducing bandwidth with repository queries during package install/upgrade/outdated operations. Should not generally be used, unless a repository needs to support older methods of query. When disabled, this makes queries similar to the way they were done in Chocolatey v0.10.11 and before. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.14+.".format_with
                          (ApplicationParameters.Features.UsePackageRepositoryOptimizations, configuration.Features.UsePackageRepositoryOptimizations.to_string()),
                      option =>
@@ -218,6 +218,10 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon
                              configuration.Features.UsePackageRepositoryOptimizations = false;
                          }
                      })
+                .Add("pin|pinpackage|pin-package",
+                    "Pin Package - Add a pin to the package after upgrade. Available in 1.2.0+",
+                    option => configuration.PinPackage = option != null
+                    )
                 ;
         }
 
diff --git a/src/chocolatey/infrastructure.app/configuration/ChocolateyConfiguration.cs b/src/chocolatey/infrastructure.app/configuration/ChocolateyConfiguration.cs
@@ -235,6 +235,7 @@ private void append_output(StringBuilder propertyValues, string append)
         public string DownloadChecksum64 { get; set; }
         public string DownloadChecksumType { get; set; }
         public string DownloadChecksumType64 { get; set; }
+        public bool PinPackage { get; set; }
 
         /// <summary>
         ///   Configuration values provided by choco.
diff --git a/src/chocolatey/infrastructure.app/configuration/PackagesConfigFilePackageSetting.cs b/src/chocolatey/infrastructure.app/configuration/PackagesConfigFilePackageSetting.cs
@@ -59,6 +59,9 @@ public sealed class PackagesConfigFilePackageSetting
         [XmlAttribute(AttributeName = "disabled")]
         public bool Disabled { get; set; }
 
+        [XmlAttribute(AttributeName = "pinPackage")]
+        public bool PinPackage { get; set; }
+        
         [System.ComponentModel.DefaultValue(-1)]
         [XmlAttribute(AttributeName = "executionTimeout")]
         public int ExecutionTimeout { get; set; }
diff --git a/src/chocolatey/infrastructure.app/services/ChocolateyPackageService.cs b/src/chocolatey/infrastructure.app/services/ChocolateyPackageService.cs
@@ -408,6 +408,7 @@ public virtual void handle_package_result(PackageResult packageResult, Chocolate
                 handle_extension_packages(config, packageResult);
                 handle_template_packages(config, packageResult);
                 pkgInfo.Arguments = capture_arguments(config, packageResult);
+                pkgInfo.IsPinned = config.PinPackage;
             }
 
             var toolsLocation = Environment.GetEnvironmentVariable(ApplicationParameters.Environment.ChocolateyToolsLocation);
@@ -737,8 +738,9 @@ private IEnumerable<ChocolateyConfiguration> get_packages_from_config(string pac
                     if (pkgSettings.ApplyPackageParametersToDependencies) packageConfig.ApplyPackageParametersToDependencies = true;
                     SourceType sourceType;
                     if (Enum.TryParse(pkgSettings.Source, true, out sourceType)) packageConfig.SourceType = sourceType;
+                    if (pkgSettings.PinPackage) packageConfig.PinPackage = true;
                     if (pkgSettings.Force) packageConfig.Force = true;
-                    packageConfig.CommandExecutionTimeoutSeconds = pkgSettings.ExecutionTimeout == -1 ? packageConfig.ExecutionTimeout : pkgSettings.CommandExecutionTimeoutSeconds;
+                    packageConfig.CommandExecutionTimeoutSeconds = pkgSettings.ExecutionTimeout == -1 ? packageConfig.CommandExecutionTimeoutSeconds : pkgSettings.ExecutionTimeout;
                     if (pkgSettings.Prerelease) packageConfig.Prerelease = true;
                     if (pkgSettings.OverrideArguments) packageConfig.OverrideArguments = true;
                     if (pkgSettings.NotSilent) packageConfig.NotSilent = true;

Original file line number	Diff line number	Diff line change
`@@ -108,7 +108,7 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon`
`108`	`108`	`{`
`109`	`109`	`if (option != null) configuration.Features.AllowEmptyChecksums = true;`
`110`	`110`	`})`
`111`		`- .Add("allowemptychecksumsecure\|allowemptychecksumssecure\|allow-empty-checksums-secure",`
	`111`	`+ .Add("allowemptychecksumsecure\|allowemptychecksumssecure\|allow-empty-checksums-secure",`
`112`	`112`	`"Allow Empty Checksums Secure - Allow packages to have empty checksums for downloaded resources from secure locations (HTTPS). Overrides the default feature '{0}' set to '{1}'. Available in 0.10.0+.".format_with(ApplicationParameters.Features.AllowEmptyChecksumsSecure, configuration.Features.AllowEmptyChecksumsSecure.to_string()),`
`113`	`113`	`option =>`
`114`	`114`	`{`
`@@ -146,20 +146,20 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon`
`146`	`146`	`configuration.Features.UsePackageExitCodes = false;`
`147`	`147`	`}`
`148`	`148`	`})`
`149`		`- .Add("usepackagecodes\|usepackageexitcodes\|use-package-codes\|use-package-exit-codes",`
	`149`	`+ .Add("usepackagecodes\|usepackageexitcodes\|use-package-codes\|use-package-exit-codes",`
`150`	`150`	`"UsePackageExitCodes - Package scripts can provide exit codes. Use those for choco's exit code when non-zero (this value can come from a dependency package). Chocolatey defines valid exit codes as 0, 1605, 1614, 1641, 3010. Overrides the default feature '{0}' set to '{1}'. Available in 0.9.10+.".format_with(ApplicationParameters.Features.UsePackageExitCodes, configuration.Features.UsePackageExitCodes.to_string()),`
`151`	`151`	`option => configuration.Features.UsePackageExitCodes = option != null`
`152`	`152`	`)`
`153`		`- .Add("stoponfirstfailure\|stop-on-first-failure\|stop-on-first-package-failure",`
	`153`	`+ .Add("stoponfirstfailure\|stop-on-first-failure\|stop-on-first-package-failure",`
`154`	`154`	`"Stop On First Package Failure - stop running install, upgrade or uninstall on first package failure instead of continuing with others. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.4+.".format_with(ApplicationParameters.Features.StopOnFirstPackageFailure, configuration.Features.StopOnFirstPackageFailure.to_string()),`
`155`	`155`	`option => configuration.Features.StopOnFirstPackageFailure = option != null`
`156`	`156`	`)`
`157`		`- .Add("exitwhenrebootdetected\|exit-when-reboot-detected",`
	`157`	`+ .Add("exitwhenrebootdetected\|exit-when-reboot-detected",`
`158`	`158`	`"Exit When Reboot Detected - Stop running install, upgrade, or uninstall when a reboot request is detected. Requires '{0}' feature to be turned on. Will exit with either {1} or {2}. Overrides the default feature '{3}' set to '{4}'. Available in 0.10.12+.".format_with`
`159`	`159`	`(ApplicationParameters.Features.UsePackageExitCodes, ApplicationParameters.ExitCodes.ErrorFailNoActionReboot, ApplicationParameters.ExitCodes.ErrorInstallSuspend, ApplicationParameters.Features.ExitOnRebootDetected, configuration.Features.ExitOnRebootDetected.to_string()),`
`160`	`160`	`option => configuration.Features.ExitOnRebootDetected = option != null`
`161`	`161`	`)`
`162`		`- .Add("ignoredetectedreboot\|ignore-detected-reboot",`
	`162`	`+ .Add("ignoredetectedreboot\|ignore-detected-reboot",`
`163`	`163`	`"Ignore Detected Reboot - Ignore any detected reboots if found. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.12+.".format_with`
`164`	`164`	`(ApplicationParameters.Features.ExitOnRebootDetected, configuration.Features.ExitOnRebootDetected.to_string()),`
`165`	`165`	`option =>`
`@@ -179,6 +179,10 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon`
`179`	`179`	`configuration.Features.UsePackageRepositoryOptimizations = false;`
`180`	`180`	`}`
`181`	`181`	`})`
	`182`	`+ .Add("pin\|pinpackage\|pin-package",`
	`183`	`+ "Pin Package - Add a pin to the package after install. Available in 1.2.0+",`
	`184`	`+ option => configuration.PinPackage = option != null`
	`185`	`+ )`
`182`	`186`	`;`
`183`	`187`
`184`	`188`	`//todo: #770 package name can be a url / installertype`
Original file line number	Diff line number	Diff line change
`@@ -152,23 +152,23 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon`
`152`	`152`	`configuration.Features.UsePackageExitCodes = false;`
`153`	`153`	`}`
`154`	`154`	`})`
`155`		`- .Add("usepackagecodes\|usepackageexitcodes\|use-package-codes\|use-package-exit-codes",`
	`155`	`+ .Add("usepackagecodes\|usepackageexitcodes\|use-package-codes\|use-package-exit-codes",`
`156`	`156`	`"UsePackageExitCodes - Package scripts can provide exit codes. Use those for choco's exit code when non-zero (this value can come from a dependency package). Chocolatey defines valid exit codes as 0, 1605, 1614, 1641, 3010. Overrides the default feature '{0}' set to '{1}'. Available in 0.9.10+.".format_with(ApplicationParameters.Features.UsePackageExitCodes, configuration.Features.UsePackageExitCodes.to_string()),`
`157`	`157`	`option => configuration.Features.UsePackageExitCodes = option != null`
`158`	`158`	`)`
`159`		`- .Add("except=",`
	`159`	`+ .Add("except=",`
`160`	`160`	`"Except - a comma-separated list of package names that should not be upgraded when upgrading 'all'. Overrides the configuration setting '{0}' set to '{1}'. Available in 0.9.10+.".format_with(ApplicationParameters.ConfigSettings.UpgradeAllExceptions, configuration.UpgradeCommand.PackageNamesToSkip.to_string()),`
`161`	`161`	`option => configuration.UpgradeCommand.PackageNamesToSkip = option.remove_surrounding_quotes()`
`162`	`162`	`)`
`163`		`- .Add("stoponfirstfailure\|stop-on-first-failure\|stop-on-first-package-failure",`
	`163`	`+ .Add("stoponfirstfailure\|stop-on-first-failure\|stop-on-first-package-failure",`
`164`	`164`	`"Stop On First Package Failure - stop running install, upgrade or uninstall on first package failure instead of continuing with others. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.4+.".format_with(ApplicationParameters.Features.StopOnFirstPackageFailure, configuration.Features.StopOnFirstPackageFailure.to_string()),`
`165`	`165`	`option => configuration.Features.StopOnFirstPackageFailure = option != null`
`166`	`166`	`)`
`167`		`- .Add("skip-if-not-installed\|only-upgrade-installed\|skip-when-not-installed",`
	`167`	`+ .Add("skip-if-not-installed\|only-upgrade-installed\|skip-when-not-installed",`
`168`	`168`	`"Skip Packages Not Installed - if a package is not installed, do not install it during the upgrade process. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.12+.".format_with(ApplicationParameters.Features.SkipPackageUpgradesWhenNotInstalled, configuration.Features.SkipPackageUpgradesWhenNotInstalled.to_string()),`
`169`	`169`	`option => configuration.Features.SkipPackageUpgradesWhenNotInstalled = option != null`
`170`	`170`	`)`
`171`		`- .Add("install-if-not-installed",`
	`171`	`+ .Add("install-if-not-installed",`
`172`	`172`	`"Install Missing Packages When Not Installed - if a package is not installed, install it as part of running upgrade (typically default behavior). Overrides the default feature '{0}' set to '{1}'. Available in 0.10.12+.".format_with(ApplicationParameters.Features.SkipPackageUpgradesWhenNotInstalled, configuration.Features.SkipPackageUpgradesWhenNotInstalled.to_string()),`
`173`	`173`	`option =>`
`174`	`174`	`{`
`@@ -177,28 +177,28 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon`
`177`	`177`	`configuration.Features.SkipPackageUpgradesWhenNotInstalled = false;`
`178`	`178`	`}`
`179`	`179`	`})`
`180`		`- .Add("exclude-pre\|exclude-prerelease\|exclude-prereleases",`
	`180`	`+ .Add("exclude-pre\|exclude-prerelease\|exclude-prereleases",`
`181`	`181`	"Exclude Prerelease - Should prerelease be ignored for upgrades? Will be ignored if you pass `--pre`. Available in 0.10.4+.",
`182`	`182`	`option => configuration.UpgradeCommand.ExcludePrerelease = option != null`
`183`	`183`	`)`
`184`		`- .Add("userememberedargs\|userememberedarguments\|userememberedoptions\|use-remembered-args\|use-remembered-arguments\|use-remembered-options",`
	`184`	`+ .Add("userememberedargs\|userememberedarguments\|userememberedoptions\|use-remembered-args\|use-remembered-arguments\|use-remembered-options",`
`185`	`185`	`"Use Remembered Options for Upgrade - use the arguments and options used during install for upgrade. Does not override arguments being passed at runtime. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.4+.".format_with(ApplicationParameters.Features.UseRememberedArgumentsForUpgrades, configuration.Features.UseRememberedArgumentsForUpgrades.to_string()),`
`186`	`186`	`option =>`
`187`	`187`	`{`
`188`	`188`	`if (option != null) configuration.Features.UseRememberedArgumentsForUpgrades = true;`
`189`	`189`	`})`
`190`		`- .Add("ignorerememberedargs\|ignorerememberedarguments\|ignorerememberedoptions\|ignore-remembered-args\|ignore-remembered-arguments\|ignore-remembered-options",`
	`190`	`+ .Add("ignorerememberedargs\|ignorerememberedarguments\|ignorerememberedoptions\|ignore-remembered-args\|ignore-remembered-arguments\|ignore-remembered-options",`
`191`	`191`	`"Ignore Remembered Options for Upgrade - ignore the arguments and options used during install for upgrade. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.4+.".format_with(ApplicationParameters.Features.UseRememberedArgumentsForUpgrades, configuration.Features.UseRememberedArgumentsForUpgrades.to_string()),`
`192`	`192`	`option =>`
`193`	`193`	`{`
`194`	`194`	`if (option != null) configuration.Features.UseRememberedArgumentsForUpgrades = false;`
`195`	`195`	`})`
`196`		`- .Add("exitwhenrebootdetected\|exit-when-reboot-detected",`
	`196`	`+ .Add("exitwhenrebootdetected\|exit-when-reboot-detected",`
`197`	`197`	`"Exit When Reboot Detected - Stop running install, upgrade, or uninstall when a reboot request is detected. Requires '{0}' feature to be turned on. Will exit with either {1} or {2}. Overrides the default feature '{3}' set to '{4}'. Available in 0.10.12+.".format_with`
`198`	`198`	`(ApplicationParameters.Features.UsePackageExitCodes, ApplicationParameters.ExitCodes.ErrorFailNoActionReboot, ApplicationParameters.ExitCodes.ErrorInstallSuspend, ApplicationParameters.Features.ExitOnRebootDetected, configuration.Features.ExitOnRebootDetected.to_string()),`
`199`	`199`	`option => configuration.Features.ExitOnRebootDetected = option != null`
`200`	`200`	`)`
`201`		`- .Add("ignoredetectedreboot\|ignore-detected-reboot",`
	`201`	`+ .Add("ignoredetectedreboot\|ignore-detected-reboot",`
`202`	`202`	`"Ignore Detected Reboot - Ignore any detected reboots if found. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.12+.".format_with`
`203`	`203`	`(ApplicationParameters.Features.ExitOnRebootDetected, configuration.Features.ExitOnRebootDetected.to_string()),`
`204`	`204`	`option =>`
`@@ -208,7 +208,7 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon`
`208`	`208`	`configuration.Features.ExitOnRebootDetected = false;`
`209`	`209`	`}`
`210`	`210`	`})`
`211`		`- .Add("disable-repository-optimizations\|disable-package-repository-optimizations",`
	`211`	`+ .Add("disable-repository-optimizations\|disable-package-repository-optimizations",`
`212`	`212`	`"Disable Package Repository Optimizations - Do not use optimizations for reducing bandwidth with repository queries during package install/upgrade/outdated operations. Should not generally be used, unless a repository needs to support older methods of query. When disabled, this makes queries similar to the way they were done in Chocolatey v0.10.11 and before. Overrides the default feature '{0}' set to '{1}'. Available in 0.10.14+.".format_with`
`213`	`213`	`(ApplicationParameters.Features.UsePackageRepositoryOptimizations, configuration.Features.UsePackageRepositoryOptimizations.to_string()),`
`214`	`214`	`option =>`
`@@ -218,6 +218,10 @@ public virtual void configure_argument_parser(OptionSet optionSet, ChocolateyCon`
`218`	`218`	`configuration.Features.UsePackageRepositoryOptimizations = false;`
`219`	`219`	`}`
`220`	`220`	`})`
	`221`	`+ .Add("pin\|pinpackage\|pin-package",`
	`222`	`+ "Pin Package - Add a pin to the package after upgrade. Available in 1.2.0+",`
	`223`	`+ option => configuration.PinPackage = option != null`
	`224`	`+ )`
`221`	`225`	`;`
`222`	`226`	`}`
`223`	`227`