FlagOption

copy

fun copy(validator: OptionValidator<T> = this.validator, names: Set<String> = this.names, secondaryNames: Set<String> = this.secondaryNames, help: String = this.optionHelp, hidden: Boolean = this.hidden, helpTags: Map<String, String> = this.helpTags, valueSourceKey: String? = this.valueSourceKey, envvar: String? = this.envvar): FlagOption<T>

Create a new option that is a copy of this one with the same transforms.

fun <T> copy(transformEnvvar: OptionTransformContext.(String) -> T, transformAll: CallsTransformer<String, T>, validator: OptionValidator<T>, names: Set<String> = this.names, secondaryNames: Set<String> = this.secondaryNames, help: String = this.optionHelp, hidden: Boolean = this.hidden, helpTags: Map<String, String> = this.helpTags, valueSourceKey: String? = this.valueSourceKey, envvar: String? = this.envvar): FlagOption<T>

Create a new option that is a copy of this one with different transforms.

finalize

open override fun finalize(context: Context, invocations: List<OptionParser.Invocation>)

Called after this command's argv is parsed to transform and store the option's value.

getValue

open operator override fun getValue(thisRef: ParameterHolder, property: KProperty<*>): T

metavar

open override fun metavar(context: Context): String?

A name representing the values for this option that can be displayed to the user.

parameterHelp

open fun parameterHelp(context: Context): HelpFormatter.ParameterHelp.Option?

Information about this option for the help output.

postValidate

open override fun postValidate(context: Context)

Called after all of a command's parameters have been finalized to perform validation of the final value.

provideDelegate

open operator override fun provideDelegate(thisRef: ParameterHolder, prop: KProperty<*>): ReadOnlyProperty<ParameterHolder, T>

Implementations must call ParameterHolder.registerOption

completionCandidates

open val completionCandidates: CompletionCandidates

Optional set of strings to use when the user invokes shell autocomplete on a value for this option.

envvar

val envvar: String?

The name of the environment variable for this option. Overrides automatic names.

groupName

open override var groupName: String? = null

The name of the group, or null if this option should not be grouped in the help output.

helpTags

open override val helpTags: Map<String, String>

Extra information about this option to pass to the help formatter.

hidden

open override val hidden: Boolean

If true, this option should not appear in help output.

names

open override var names: Set<String>

The names that can be used to invoke this option. They must start with a punctuation character.

nvalues

open override val nvalues: Int

The number of values that must be given to this option.

optionHelp

open override val optionHelp: String

The description of this option, usually a single line.

parameterGroup

open override var parameterGroup: ParameterGroup? = null

The group that this option belongs to, or null. Set by the group.

parser

open override val parser: FlagOptionParser

The parser for this option's values.

secondaryNames

open override val secondaryNames: Set<String>

Names that can be used for a secondary purpose, like disabling flag options.

transformAll

val transformAll: CallsTransformer<String, T>

Called to transform all invocations of this option into the final option type.

transformEnvvar

val transformEnvvar: OptionTransformContext.(String) -> T

Called to transform string values from envvars and value sources into the option type.

validator

val validator: OptionValidator<T>

value

open override var value: T

The value for this option.

valueSourceKey

open override val valueSourceKey: String?

Optional explicit key to use when looking this option up from a ValueSource

convert

inline fun <InT, OutT> FlagOption<InT>.convert(crossinline conversion: FlagConverter<InT, OutT>): FlagOption<OutT>

Convert the option's value type.

default

fun <T : Any> FlagOption<T?>.default(value: T, defaultForHelp: String = value.toString()): FlagOption<T>

Set a default value for an option.

defaultLazy

inline fun <T : Any> FlagOption<T?>.defaultLazy(defaultForHelp: String = "", crossinline value: () -> T): FlagOption<T>

Set a default value for an option from a lazy builder which is only called if the default value is used.

deprecated

fun <T> FlagOption<T>.deprecated(message: String? = "", tagName: String? = "deprecated", tagValue: String = "", error: Boolean = false): OptionDelegate<T>

Mark this option as deprecated in the help output.

help

fun <T> FlagOption<T>.help(help: String): FlagOption<T>

Set the help for this option.

required

fun <T : Any> FlagOption<T?>.required(): FlagOption<T>

If the option is not called on the command line (and is not set in an envvar), throw a MissingOption.

validate

fun <T : Any> FlagOption<T>.validate(validator: OptionValidator<T>): OptionDelegate<T>

Check the final option value and raise an error if it's not valid.

FlagOption

Functions

Properties

Extensions