outil

Types

Argument

A positional command line argument.

pub type Argument {
  BoolArgument(name: String)
  FloatArgument(name: String)
  IntArgument(name: String)
  StringArgument(name: String)
}

Constructors

```
BoolArgument(name: String)
```
```
FloatArgument(name: String)
```
```
IntArgument(name: String)
```
```
StringArgument(name: String)
```

ArgvFunction

</>

A function from the argument vector (in the given command) to a result.

pub type ArgvFunction(a) =
  fn(Command) -> Result(a, Return)

Command

</>

A command line interface to a run function.

pub type Command {
  Command(
    name: String,
    description: String,
    arguments: List(Argument),
    options: List(Opt),
    argv: List(String),
  )
}

Constructors

Command(
  name: String,
  description: String,
  arguments: List(Argument),
  options: List(Opt),
  argv: List(String),
)

Opt

</>

A command line option/flag.

pub type Opt {
  Opt(
    long: String,
    short: Option(String),
    description: String,
    value: OptValue,
  )
}

Constructors

Opt(
  long: String,
  short: Option(String),
  description: String,
  value: OptValue,
)

OptValue

</>

The type and default value of an option.

pub type OptValue {
  BoolOpt
  FloatOpt(default: Float)
  IntOpt(default: Int)
  StringOpt(default: String)
}

Constructors

```
BoolOpt
```
```
FloatOpt(default: Float)
```
```
IntOpt(default: Int)
```
```
StringOpt(default: String)
```

Return

</>

Non-normal return values from executing a command.

pub type Return {
  CommandLineError(reason: Reason, usage: String)
  Help(usage: String)
}

Constructors

CommandLineError(reason: Reason, usage: String)

```
Help(usage: String)
```

WithArgument

</>

The type of continuation functions in building a command.

pub type WithArgument(a, b) =
  fn(ArgvFunction(a), Command) -> b

Functions

command

</>

pub fn command(name: String, description: String, argv: List(
    String,
  ), continue: fn(Command) -> a) -> a

Create a command with the given name and description, and pass it to the given continuation function for further configuration.

The command gets a default implementation that returns an error.

parse_bool

</>

pub fn parse_bool(arg: String) -> Result(Bool, Nil)

Parse a Bool from a string.