InkoInkoInko makes it easy to build concurrent software, without having to worry about unpredictable performance, unexpected runtime errors, data races, and type errors.
Inko features deterministic automatic memory management, move semantics, static typing, type-safe concurrency, efficient error handling, and more.
Get started Discord GitHubtype async Main {
fn async main {
let numbers = [10, 20, 30]
numbers
.opt(2)
.map(fn (n) { n.to_string }) # => Option.Some('30')
}
}
type async Main {
fn async main {
let mut num = 0
while num < 10 { num += 1 }
loop {
# This loops run forever. You can skip/break
# iteration using `next` and `break`.
}
}
}
trait ToString {
fn to_string -> String
}
type Person {
let @name: String
}
impl ToString for Person {
fn to_string -> String {
@name
}
}
# Traits can also be implemented conditionally:
type List[T] {
# ...
}
# Here `ToString` is only available for instances
# of `List` if `T` also implements `ToString`.
impl ToString for List if T: ToString {
fn to_string -> String {
'...'
}
}
import std.fs.file (ReadOnlyFile)
type async Main {
fn async main {
# or_panic() gets the Result value, panicking
# with the given error message when
# encountering a `Result.Error`.
let file = ReadOnlyFile
.new('README.md'.to_path)
.or_panic("the file doesn't exist")
let bytes = ByteArray.new
file
.read_all(bytes)
.or_panic('failed to read the file')
bytes.to_string # => "# README ..."
}
}
import std.stdio (Stdout)
type async Main {
fn async main {
Stdout.new.print('Hello, world!')
}
}
type Stack[T] {
let @values: Array[T]
fn static new -> Self {
Stack([])
}
fn mut push(value: T) {
@values.push(value)
}
fn mut pop -> Option[T] {
@values.pop
}
}
type async Main {
fn async main {
let stack = Stack.new
# This infers `T` to `Int`.
stack.push(42)
# This is an error, as `T` is inferred to `Int`, and
# `String` isn't compatible with `Int`.
stack.push('Oh no!')
# The compiler can also infer earlier types based
# on how they are used later on:
let stack = Stack.new
let value = stack.pop # The exact type isn't known yet
10 + value.get # `value` inferred as `Option[Int]`
}
}
import std.drop (Drop)
import std.stdio (Stdout)
type Thing {}
impl Drop for Thing {
fn mut drop {
Stdout.new.print('Thing is dropped')
}
}
type async Main {
fn async main {
let thing = Thing()
# Thing goes out of scope here, running its destructor.
}
}
fn moves {
let numbers = [10, 20, 30]
# This is OK, and returns a `ref 10`.
numbers.get(0)
let nums = numbers
# This is no longer OK, as `numbers` gave up ownership to
# `nums`.
numbers.get(0)
}
fn refs {
let owned = [10, 20, 30]
# We can "borrow" a value using references:
let borrowed = ref owned
# Both are OK and produce the same value: `ref 10`.
owned.get(0)
borrowed.get(0)
# This isn't OK, as `ref T` doesn't allow mutation:
borrowed.push(42)
# For that we need a mutable reference:
let mutable = mut owned
mutable.push(42)
}
import std.sync (Future, Promise)
type async Calculator {
fn async fact(size: Int, promise: uni Promise[Int]) {
let result = 1
.to(size)
.iter
.reduce(1, fn (product, val) { product * val })
promise.set(result)
}
}
type async Main {
fn async main {
let calc = Calculator()
# This calculates the factorial of 15 in the
# background, then we wait for the result to
# be sent back to us via a channel.
match Future.new {
case (future, promise) -> {
calc.fact(15, promise)
future.get # => 1307674368000
}
}
}
}
fn div(left: Int, right: Int) -> Result[Int, String] {
# `throw x` is short for `return Result.Error(x)`,
# saving us a bit of typing.
if right == 0 { throw 'Attempt to divide by zero' }
Result.Ok(left / right)
}
fn div2(left: Int, right: Int) -> Result[Int, String] {
# `try` is short for matching against a value,
# and throwing it again if it's an `Error`. It
# also works for `Option` values, in which case
# it throws a `None` if the value is also a
# `None`.
let res = try div(left, right)
if res == 5 { Result.Ok(50) } else { Result.Ok(res) }
}
type async Main {
fn async main {
# `Result` is just an algebraic data type, so we can
# pattern match against it to get the underlying
# value.
match div(10, 2) {
case Ok(val) -> val
case Error(err) -> panic(err)
}
# We can also just get the Ok value if we're
# certain we'll never get an `Error` case:
div(10, 2).get # => 5
}
}
import std.test (Tests)
type async Main {
fn async main {
let tests = Tests.new
tests.test('Adding two integers', fn (t) {
t.equal(10 + 5, 15)
t.equal(1 + -1, 0)
})
tests.run
}
}
type async Main {
fn async main {
match Option.Some(42) {
case Some(number) -> number
case None -> 0
}
# Of course we also support nested patterns:
match Option.Some((10, 'foo')) {
case Some((10, message)) -> message
case _ -> 'oh no!'
}
# Guards are also supported:
match Option.Some(42) {
case Some(number) if number < 50 -> number
case _ -> 0
}
}
}
Inko doesn't rely on garbage collection to manage memory. Instead, Inko relies on single ownership and move semantics. Values start out as owned and are dropped when they go out of scope:
let numbers = [10, 20, 30]
# "numbers" is no longer in use here, so it's dropped.
return
These values can be borrowed either mutably or immutably. Inko allows multiple borrows (both mutable and immutable borrows), and allows moving of the borrowed values while borrows exist:
let a = [10, 20, 30]
# All of this is perfectly fine:
let b = ref a # borrows "a" immutably
let c = mut a # borrows "a" mutably
let d = a # moves "a" into "d"
This gives you the benefits of single ownership, but at a fraction of the cost compared to languages such as Rust. The use of single ownership also means more predictable behaviour and performance, and not having to spend a long time adjusting different garbage collection settings.
With Inko you never again have to worry about NULL pointers, use-after-free
errors, unexpected runtime errors, data races, and other types of errors
commonly found in other languages. For optional data Inko provides an Option
type, which is an algebraic data type that you can pattern match against. Inko
supports both mutable and immutable references, allowing you to restrict
mutation where necessary.
Inko uses lightweight processes for concurrency, and its concurrency model is inspired by Erlang and Pony. Processes are isolated from each other and communicate by sending messages. Processes and messages are defined as classes and methods, and the compiler type-checks these to ensure correctness.
The compiler ensures that data sent between processes is unique, meaning there are no outside references to the data. This removes the need for (deep) copying data, and makes data races impossible. Inko also supports multi-producer multi-consumer channels, allowing processes to communicate with each other without needing explicit references to each other.
Here's how you'd implement a simple concurrent counter:
import std.sync (Future, Promise)
type async Counter {
let mut @value: Int
fn async mut increment {
@value += 1
}
fn async get(promise: uni Promise[Int]) {
promise.set(@value)
}
}
type async Main {
fn async main {
let counter = Counter(value: 0)
counter.increment
counter.increment
match Future.new {
case (future, promise) -> {
counter.get(promise)
future.get # => 2
}
}
}
}
Inko uses a form of error handling inspired by Joe Duffy's excellent article
"The Error Model". Errors
are represented using the algebraic type "Result", and Inko provides syntax
sugar in the form of try and throw to make error handling easy. Critical
errors that can't/shouldn't be handled are supported in the form of "panics",
which abort the program when they occur.
For example, here's how you'd handle errors when opening a file and calculating its size:
import std.fs.file (ReadOnlyFile)
import std.stdio (Stdout)
type async Main {
fn async main {
let size = ReadOnlyFile
.new('README.md'.to_path) # => Result[ReadOnlyFile, Error]
.then(fn (file) { file.metadata }) # => Result[Metadata, Error]
.map(fn (meta) { meta.size }) # => Result[Int, Error]
.or(0)
Stdout.new.print(size.to_string) # => 1099
}
}
Inko aims to be an efficient language, though it doesn't aim to compete with low-level languages such as C and Rust. Instead, we aim to provide a compelling alternative to the likes of Ruby, Erlang, and Go.
Inko uses a native code compiler, using LLVM as its backend, and aims to provide a balance between fast compile times and good runtime performance. The native code is statically linked against a small runtime library written in Rust, which takes care of scheduling processes, non-blocking IO, and provides various low-level functions.
Inko supports pattern matching on a variety of types, such as tuples and algebraic data types:
type async Main {
fn async main {
match [10, 20].opt(1) {
case Some(number) -> number # => 20
case None -> 0
}
match (10, 'hello') {
case (10, 'hello') -> 'foo'
case (20, _) -> 'bar'
case _ -> 'baz'
}
}
}
You can also match against literals such as integers and strings, and against regular classes:
type Person {
let @name: String
let @age: Int
}
type async Main {
fn async main {
let alice = Person(name: 'Alice', age: 42)
match alice {
case { @name = name } -> name # => 'Alice'
}
}
}
Pattern matching is compiled down to decision trees, and the compiler tries to keep their sizes as small as possible. The compiler also ensures that all patterns are covered.