monkers

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #golang #machine-learning #rust #macos #windows #awesome #kubernetes #vue #security #ios

(★ 48)

Bytecode compiler and VM for the Monkeylang language, written in Rust

monkers Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# monkers 🐒 + 🦀

[![Rust](https://github.com/poteto/monkers/actions/workflows/rust.yml/badge.svg?branch=main)](https://github.com/poteto/monkers/actions/workflows/rust.yml)

Short for `monkey-rs`. An implementation of [monkeylang](https://monkeylang.org/). Previously, I implemented the interpreter in [TypeScript](https://github.com/poteto/boba-js). I am re-implementing the interpreter and later compiler in Rust as a learning exercise.

## Building

```shell
$ cargo build --release

# See help
$ target/release/monkers --help

# Run the REPL with bytecode compilation
$ target/release/monkers

# Run the REPL with the tree-walking interpreter
$ target/release/monkers -s interpreted
```

## Developing

### Development REPL

Start the REPL by running `cargo run`, then entering some Monkey:

```
🐒 >> let a = 5;
5
🐒 >> let b = a > 3;
true
🐒 >> let c = a * 99;
495
🐒 >> if (b) { 10 } else { 1 };
10
🐒 >> let d = if (c > a) { 99 } else { 100 };
99
🐒 >> d;
99
🐒 >> d * c * a;
245025
```

Options can also be enabled:

```
$ cargo run -- -d               # debug mode
$ cargo run -- -s interpreted   # eval with interpreter
```

Command history is saved in `history.txt`.

By default, monkers REPL will compile your code into bytecode, then evaluate the bytecode with its VM. You can switch to the slower tree-walking interpreter with an arg:

```
cargo run -- interpreted
```

### Helpful crates

#### [`cargo-watch`](https://github.com/passcod/cargo-watch)

`cargo-watch` watches over your Cargo project's source. I use it to run my tests and `cargo check` whenever a file changes. It's aliased to `cargo dev`, which expands to:

```
cargo watch -x check -x test
```

Optionally you can append the `RUST_BACKTRACE=1` flag to get backtraces.

## Contributing

PRs are welcome! I am not a Rust expert, so I welcome any recommendations on more idiomatic Rust code.

monkers

monkers Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

monkers

monkers Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README