clikt/com.github.ajalt.clikt.core

Package-level declarations

Types

Abort

class Abort : ProgramResult

An internal error that signals Clikt to abort.

BadParameterValue

class BadParameterValue : UsageError

A parameter was given the correct number of values, but of invalid format or type.

CliktCommand

abstract class CliktCommand(help: String = "", epilog: String = "", name: String? = null, val invokeWithoutSubcommand: Boolean = false, val printHelpOnEmptyArgs: Boolean = false, val helpTags: Map<String, String> = emptyMap(), autoCompleteEnvvar: String? = "", allowMultipleSubcommands: Boolean = false, treatUnknownOptionsAsArgs: Boolean = false, hidden: Boolean = false) : ParameterHolder

The CliktCommand is the core of command line interfaces in Clikt.

CliktError

open class CliktError(message: String? = null, cause: Exception? = null, val statusCode: Int = 1, val printError: Boolean = true) : RuntimeException

An exception during command line processing that should be shown to the user.

Context

class Context

An object used to control command line parsing and pass data between commands.

ContextCliktError

interface ContextCliktError

An interface for CliktErrors that have a context attached

FileNotFound

class FileNotFound(val filename: String) : UsageError

A required configuration file was not found.

GroupableOption

interface GroupableOption : StaticallyGroupedOption

An option that can be added to a ParameterGroup

IncorrectArgumentValueCount

class IncorrectArgumentValueCount(val nvalues: Int, argument: Argument) : UsageError

An argument was supplied but the number of values supplied was incorrect.

IncorrectOptionValueCount

class IncorrectOptionValueCount(minValues: Int, var paramName: String) : UsageError

An option was supplied but the number of values supplied to the option was incorrect.

InvalidFileFormat

class InvalidFileFormat(filename: String, message: String, lineno: Int? = null) : UsageError

A configuration file failed to parse correctly

MissingArgument

class MissingArgument(argument: Argument) : UsageError

A required argument was not provided

MissingOption

class MissingOption(option: Option) : UsageError

A required option was not provided

MultiUsageError

class MultiUsageError(val errors: List<UsageError>) : UsageError

Multiple usage errors occurred.

MutuallyExclusiveGroupException

class MutuallyExclusiveGroupException(val names: List<String>) : UsageError

Multiple mutually exclusive options were supplied.

NoOpCliktCommand

open class NoOpCliktCommand(help: String = "", epilog: String = "", name: String? = null, val invokeWithoutSubcommand: Boolean = false, val printHelpOnEmptyArgs: Boolean = false, val helpTags: Map<String, String> = emptyMap(), autoCompleteEnvvar: String? = "", allowMultipleSubcommands: Boolean = false, hidden: Boolean = false) : CliktCommand

A CliktCommand that has a default implementation of CliktCommand.run that is a no-op.

NoSuchOption

class NoSuchOption(var paramName: String, possibilities: List<String> = emptyList()) : UsageError

An option was provided that does not exist.

NoSuchSubcommand

class NoSuchSubcommand(var paramName: String, possibilities: List<String> = emptyList()) : UsageError

A subcommand was provided that does not exist.

ParameterHolder

interface ParameterHolder

ParameterHolderDsl

@DslMarker

annotation class ParameterHolderDsl

PrintCompletionMessage

class PrintCompletionMessage(message: String) : PrintMessage

An exception that indicates that shell completion code should be printed.

PrintHelpMessage

class PrintHelpMessage(var context: Context?, val error: Boolean = false, val statusCode: Int = 0) : CliktError, ContextCliktError

An exception that indicates that the command's help should be printed.

PrintMessage

open class PrintMessage(message: String, val statusCode: Int = 0, val printError: Boolean = false) : CliktError

An exception that indicates that a message should be printed.

ProgramResult

open class ProgramResult(val statusCode: Int) : CliktError

Indicate that the program finished in a controlled manner, and should complete with the given statusCode

StaticallyGroupedOption

interface StaticallyGroupedOption : Option

TypoSuggestor

typealias TypoSuggestor = (enteredValue: String, possibleValues: List<String>) -> List<String>

UsageError

open class UsageError(message: String?, var paramName: String? = null, val statusCode: Int = 1) : CliktError, ContextCliktError

An exception that signals a user error.

Properties

terminal

val CliktCommand.terminal: Terminal

A short for accessing the terminal from the currentContext

theme

val Context.theme: Theme

The current terminal's theme

Functions

context

fun <T : CliktCommand> T.context(block: Context.Builder.() -> Unit): T

Configure this command's Context.

findObject

inline fun <T : Any> CliktCommand.findObject(): ReadOnlyProperty<CliktCommand, T?>

Find the closest object of type T, or null

findOrSetObject

inline fun <T : Any> CliktCommand.findOrSetObject(crossinline default: () -> T): ReadOnlyProperty<CliktCommand, T>

Find the closest object of type T, setting context.obj if one is not found.

requireObject

inline fun <T : Any> CliktCommand.requireObject(): ReadOnlyProperty<CliktCommand, T>

Find the closest object of type T, or throw a NullPointerException

subcommands

fun <T : CliktCommand> T.subcommands(vararg commands: CliktCommand): T

fun <T : CliktCommand> T.subcommands(commands: Iterable<CliktCommand>): T

Add the given commands as a subcommand of this command.