Wintermute/Dekejit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Toy virtual machine to play with interpreters
18 Commits 1 Branch 0 Tags 79 KiB
Rust 100%
b95c01116a
Go to file
raphy b95c01116a
added readme, made program installable
2024-02-12 21:10:36 +01:00
src preparing to refactor 2023-11-13 00:06:16 +01:00
tests added description to test file 2023-05-03 23:47:26 +02:00
.gitignore added cargo lock to gitignore 2023-04-28 12:24:58 +02:00
Cargo.toml added readme, made program installable 2024-02-12 21:10:36 +01:00
README.md added readme, made program installable 2024-02-12 21:10:36 +01:00
spec.md added readme, made program installable 2024-02-12 21:10:36 +01:00
test.bin second commit - still messy 2023-04-28 12:18:07 +02:00

README.md

DEKEJIT

EXPERIMENTAL!! NOTHING WORKS AND MAKES SENSE!!!

This is an experimental 16-bit virtual machine.

A lenghty description can be found here.

If you want to have a great time, you can try experimenting with it:

Installation

Clone this repository, and run "cargo build".

This currently builds the virtual machine, which can execute binary files, and an assembler which can turn text files into binary files.

To install the program, run cargo install --path . .

Usage

dekejit build <assemby_file> <output_file> will read the provided <assembly_file> and write a binary file <output_file> which can be executed using dekejit run <binary_file>

A few example files can be found in tests/assembly/.

Future

Right now the only possible way to use the virtual machine is to manually write the assembly. In the future, small compilers for toy languages will be built that target my toy assembly.