Wintermute/Dekejit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Toy virtual machine to play with interpreters
19 Commits 1 Branch 0 Tags 74 KiB
Rust 100%
579b5ed75b
Go to file
raphy 579b5ed75b
readme correction
2024-02-12 21:13:39 +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 readme correction 2024-02-12 21:13:39 +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

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

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

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.