OptionTransformContext

class OptionTransformContext(option: Option, context: Context) : Option

A receiver for options transformers.

Constructors

common

fun OptionTransformContext(option: Option, context: Context)

Functions

fail

common

fun fail(message: String): Nothing

Throw an exception indicating that usage was incorrect.

finalize

common

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.

message

common

fun message(message: String)

Issue a message that can be shown to the user

metavar

common

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

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

parameterHelp

common

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

Information about this option for the help output.

postValidate

common

open override fun postValidate(context: Context)

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

require

common

inline fun require(value: Boolean, lazyMessage: () -> String = { "" })

If value is false, call fail with the output of lazyMessage

Properties

completionCandidates

common

open override val completionCandidates: CompletionCandidates

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

context

common

val context: Context

helpTags

common

open override val helpTags: Map<String, String>

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

hidden

common

open override val hidden: Boolean

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

names

common

open override val names: Set<String>

The names that can be used to invoke this option.

nvalues

common

open override val nvalues: Int

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

option

common

val option: Option

The option that was invoked

optionHelp

common

open override val optionHelp: String

The description of this option, usually a single line.

parser

common

open override val parser: OptionParser

The parser for this option's values.

secondaryNames

common

open override val secondaryNames: Set<String>

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

valueSourceKey

common

open override val valueSourceKey: String?

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