ChocolateySettings Class

Summary

Contains settings used by ChocolateySettings.
graph BT Type-->Base0["ToolSettings"] click Base0 "/api/Cake.Core.Tooling/ToolSettings" Base0-->Base1["object"] Type["ChocolateySettings"] class Type type-node Derived0["ChocolateyFeatureSettings"]-->Type click Derived0 "/api/Cake.Common.Tools.Chocolatey.Features/ChocolateyFeatureSettings" Derived1["ChocolateyNewSettings"]-->Type click Derived1 "/api/Cake.Common.Tools.Chocolatey.New/ChocolateyNewSettings" Derived2["ChocolateyApiKeySettings"]-->Type click Derived2 "/api/Cake.Common.Tools.Chocolatey.ApiKey/ChocolateyApiKeySettings" Derived3["ChocolateyDownloadSettings"]-->Type click Derived3 "/api/Cake.Common.Tools.Chocolatey.Download/ChocolateyDownloadSettings" Derived4["ChocolateyPushSettings"]-->Type click Derived4 "/api/Cake.Common.Tools.Chocolatey.Push/ChocolateyPushSettings" Derived5["ChocolateySourcesSettings"]-->Type click Derived5 "/api/Cake.Common.Tools.Chocolatey.Sources/ChocolateySourcesSettings" Derived6["ChocolateySharedSettings"]-->Type click Derived6 "/api/Cake.Common.Tools.Chocolatey/ChocolateySharedSettings" Derived7["ChocolateyPackSettings"]-->Type click Derived7 "/api/Cake.Common.Tools.Chocolatey.Pack/ChocolateyPackSettings" Derived8["ChocolateyPinSettings"]-->Type click Derived8 "/api/Cake.Common.Tools.Chocolatey.Pin/ChocolateyPinSettings" Derived9["ChocolateyExportSettings"]-->Type click Derived9 "/api/Cake.Common.Tools.Chocolatey.Export/ChocolateyExportSettings" Derived10["ChocolateyConfigSettings"]-->Type click Derived10 "/api/Cake.Common.Tools.Chocolatey.Config/ChocolateyConfigSettings"

Syntax

public class ChocolateySettings : ToolSettings

Properties

Name Value Summary
AcceptLicense bool
Gets or sets a value indicating whether to accept license for package.
AllowUnofficial bool
Gets or sets a value indicating whether to run in allow unofficial mode.
ArgumentCustomization Func<ProcessArgumentBuilder, ProcessArgumentBuilder>
Gets or sets the argument customization. Argument customization is a way that lets you add, replace or reuse arguments passed to a tool. This allows you to support new tool arguments, customize arguments or address potential argument issues.
Inherited from ToolSettings
CacheLocation string
Gets or sets the location of the download cache.
Debug bool
Gets or sets a value indicating whether to run in debug mode.
EnvironmentVariables IDictionary<string, string>
Gets or sets search paths for files, directories for temporary files, application-specific options, and other similar information.
Inherited from ToolSettings
ExecutionTimeout int
Gets or sets the execution timeout value.
FailOnErrorOutput bool
Gets or sets a value indicating whether to faile when error output is detected.
Force bool
Gets or sets a value indicating whether to run in forced mode.
HandleExitCode Func<int, bool>
Gets or sets whether the exit code from the tool process causes an exception to be thrown.

If the delegate is null (the default) or returns false, then an exception is thrown upon a non-zero exit code.

If the delegate returns true then no exception is thrown.

This can be useful when the exit code should be ignored, or if there is a desire to apply logic that is conditional on the exit code value.

Inherited from ToolSettings
LimitOutput bool
Gets or sets a value indicating whether to run in limited output mode.
LogFile FilePath
Gets or sets the path to the file where all log entries will be sent.
NoColor bool
Gets or sets a value indicating whether to run in no color mode.
Noop bool
Gets or sets a value indicating whether to run in noop mode.
NoProgress bool
Gets or sets a value indicating whether to run while not showing download progress.
NoWorkingDirectory bool
Gets or sets a value indicating whether or not to opt out of using an explicit working directory for the process.
Inherited from ToolSettings
PostAction Action<IProcess>
Gets or sets a delegate which is executed after the process was started.
Inherited from ToolSettings
Proxy string
Gets or sets the explicit proxy location.
ProxyByPassList string
Gets or sets the comma separated list of regex location to bypass on proxy.
ProxyBypassOnLocal bool
Gets or sets a value indicating whether to bypass proxy for local connections.
ProxyPassword string
Gets or sets the explicit proxy password.
ProxyUser string
Gets or sets the explicit proxy user.
SetupProcessSettings Action<ProcessSettings>
Gets or sets a delegate to configure the process settings.
Inherited from ToolSettings
SkipCompatibilityChecks bool
Gets or sets a value indicating whether to skip all compatibility checks.
ToolPath FilePath
Gets or sets the tool path.
Inherited from ToolSettings
ToolTimeout TimeSpan?
Gets or sets optional timeout for tool execution.
Inherited from ToolSettings
Trace bool
Gets or sets a value indicating whether to run in trace mode.
UseSystemPowerShell bool
Gets or sets a value indicating whether to run using system installed version of PowerShell.
Verbose bool
Gets or sets a value indicating whether to run in verbose mode.
WorkingDirectory DirectoryPath
Gets or sets the working directory for the tool process.
Inherited from ToolSettings

Extension Methods

Name Value Summary
Dump<ChocolateySettings>() string
Get a basic string representation of specified object.
Requires the Cake.Incubator addin
IsIn<ChocolateySettings>(ChocolateySettings[]) bool
Checks if the source is contained in a list
Requires the Cake.Incubator addin
NotNull<ChocolateySettings>(string) void
Throws an exception if the specified parameter's value is null.
Requires the Cake.Ftp addin
NotNull<ChocolateySettings>(string) void
Requires the Cake.Issues addin
ThrowIfNull<ChocolateySettings>(string, string) T
Throws a System.ArgumentNullException with a specific message if the value is null, otherwise returns the value
Requires the Cake.Incubator addin
ThrowIfNull<ChocolateySettings>(string) T
Throws a System.ArgumentNullException if the value is null, otherwise returns the value
Requires the Cake.Incubator addin
ToDictionary() IDictionary<string, object>
Requires the Cake.DeployParams addin
ToStringWithNullMarkup() string
Requires the Cake.Issues addin
WithArgumentCustomization<ChocolateySettings>(Func<ProcessArgumentBuilder, ProcessArgumentBuilder>) T
Sets the tool argument customization delegate.
WithEnvironmentVariable<ChocolateySettings>(string, string) T
Sets or adds tool environment variable.
WithExpectedExitCode<ChocolateySettings>(int) T
Sets expected exit code using WithHandleExitCode<T>(T, Func<int, bool>).
WithHandleExitCode<ChocolateySettings>(Func<int, bool>) T
Sets delegate whether the exit code from the tool process causes an exception to be thrown.
WithNoWorkingDirectory<ChocolateySettings>(bool) T
Sets whether the tool should use a working directory or not.
WithPostAction<ChocolateySettings>(Action<IProcess>) T
Sets a delegate which is executed after the tool process was started.
WithSetupProcessSettings<ChocolateySettings>(Action<ProcessSettings>) T
Sets a delegate to configure the process settings.
WithToolPath<ChocolateySettings>(FilePath) T
Sets the tool path.
WithToolSettings<ChocolateySettings>(Action<ChocolateySettings>) T
Provides fluent null guarded tool settings action.
WithToolTimeout<ChocolateySettings>(TimeSpan) T
Sets the tool timeout.
WithWorkingDirectory<ChocolateySettings>(DirectoryPath) T
Sets the tool working directory.