Buyan Documentation

Buyan is a compiled, strictly statically typed, stack-oriented, and concatenative programming language. It is inspired by Forth.

You can learn more about concatenative programming languages here.

Installation

To install Buyan using Cargo, run:

cargo install --git https://github.com/ya7on/buyan.git

To build Buyan, clone the repository and build it using Cargo:

git clone https://github.com/ya7on/buyan.git
cd buyan
cargo build --release

After building, you can find the executable in target/release/buyan.

To run a Buyan program, simply pass the file path to the buyan executable:

buyan <path>.by --target <target>

Where <target> is the target architecture to compile for.

At the moment, Buyan supports the following target architectures:

interpreter - instantly executes the program using an interpreter
z80-unknown-cpm - compiles the program for the Z80 CP/M target, printing the assembled code to stdout