Oi

A language written by human(s?), for humans. More specifically, for humans who love programming.

Oi is a general purpose system language with a high emphasis on ergonomics.

It was designed such that the code you want to write is usually the code you actually write. Where other languages optimize for things like safety, perf, or simplicity, Oi optimizes for flow.

Early and unstable and thar be dragons afoot. You have been warned.

See examples/ for working examples, and ref/syntax.md for more sci-fi theoretical future stuff.

NOTE: this readme is more about building the compiler itself. Probably look at the website or docs or something to see something more universally helpful.

Contributing

Requires nightly Rust (just cranelift things).

# build compiler
just build

# run tests
just test

# generate rustdocs
just doc

# runs fmt, lint, and test together, which is the combo I run most often
# (and for now is the default when you run just `just`)
just check

# preview the website (req: `zola`)
just serve

Usage

# run a main.oi file in the current dir
oi run

# run a file
oi run examples/main.oi

# execute a script
oi exec '2 + 3'

# interactive REPL
oi repl

Docs

• rawsp33d.github.io/oi/: simple website
• ref/syntax.md: canonical language design spec
• ref/Oi.md: loose plan and direction, open questions