The Koto CLI

Koto was originally designed as an extension language for Rust applications, but it is also usable as a standalone scripting language via the Koto CLI. The CLI can run .koto scripts, and provides an interactive REPL.

Installation

Installing the Koto CLI currently requires the Rust toolchain (see rustup.sh for installation instructions).

With Rust available on your system, run cargo install koto_cli, which provides you with the koto command.

Running Scripts

Koto scripts can be run by the CLI by passing the script's name as the first argument.

» cat say_hello.koto
print 'Hello!'

» koto say_hello.koto
Hello!

Command Arguments

Arguments following the script are made available via os.args.

» cat print_args.koto
for i, arg in os.args.enumerate()
  print '{i + 1}: {arg}'

» koto print_args.koto a b c
1: a
2: b
3: c

Running Tests

Tests are disabled by default in the CLI, but can be enabled by using the --tests flag.

» cat testing.koto
@main = ||
  print 'Hello!'

@test always_fails = ||
  assert false

» koto testing.koto
Hello!

» koto --tests testing.koto
Error: assertion failed (while running test 'always_fails')
--- testing.koto - 5:3
   |
 5 |   assert false
   |   ^^^^^^^^^^^^

--tests only enables tests in the script that's being run, use the --import_tests flag to also enable tests in any imported modules.

Using the REPL

Running koto without any arguments will start the Koto REPL, where Koto expressions can be entered and evaluated interactively.

> koto
Welcome to Koto

» 1 + 1
➝ 2

» 'hello!'
➝ hello!

Help

The language guide and the core library reference, can be accessed in the REPL using the help command.

> koto
Welcome to Koto

» help bool

  Booleans
  ========

  Booleans are declared with the `true` and `false` keywords,
  and combined using the `and` and `or` operators.

  |
  |  true and false
  |  # ➝ false
  ...
Docs Playground