Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/izo0x90/snake-toy-vm
A generalized/ multi-arch. toy virtual machine, assembler and debugger written in Python. Just a fun project in python building a classical computer emulator.
https://github.com/izo0x90/snake-toy-vm
assembler assembly assembly-language compiler computer-science custom-language debbuger emulation emulator emulators low-level low-level-programming programming-language programming-language-theory programming-languages system-programming virtual-machine virtualization
Last synced: 12 days ago
JSON representation
A generalized/ multi-arch. toy virtual machine, assembler and debugger written in Python. Just a fun project in python building a classical computer emulator.
- Host: GitHub
- URL: https://github.com/izo0x90/snake-toy-vm
- Owner: izo0x90
- License: mit
- Created: 2024-10-27T19:31:06.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-11-11T23:27:20.000Z (about 2 months ago)
- Last Synced: 2024-11-12T00:20:42.082Z (about 2 months ago)
- Topics: assembler, assembly, assembly-language, compiler, computer-science, custom-language, debbuger, emulation, emulator, emulators, low-level, low-level-programming, programming-language, programming-language-theory, programming-languages, system-programming, virtual-machine, virtualization
- Language: Python
- Homepage:
- Size: 7.38 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Snake toy VM :snake:
A generalized toy virtual machine, assembler, debugger/ UI written in python. Intended as just a fun time waster over a few weekends for myself, and also somehow we dragged in [@zayfod](https://github.com/zayfod) into this too, but maybe there is some educational value to others?
- Keeping things simple, illustrating basic ideas behind classical computing, emulation and VMs
- Modular way to define architecture/ VMs
- Allows for definition of custom assembly sytaxes
- Swapping/ extending instruction sets
- VMs currently in project
- Toy VM (Completed) ✔️
- Brainfuck (Completed) ✔️
- F4 MISc (Completed) ✔️
- 8 bit PIC (In progress)
*It's all virtual machines in virtual machins in virtual machines ... and soon Transformer models infrencing the output of virtual machines ... - Probaly someone*
## Why?
Writing a VM in a language that runs in a VM and has no business having a VM written in :feelsgood:! Possibly educational for someone :suspect:? If you grew up learning to code in the 90's you get it.
## Install
### Pre
Clone repo
Install python 3.13
Install `uv` (Optional):
```
pip install uv
```
Install deps:
Setup virtual env., and install deps. (Uses `uv`)
```
make dev_build_env
```
or
```
uv pip install -r requirements.txt
```
or
```
pip install -r requirements.txt
```
## Run
Load with only default "Toy VM" virtual machine:
```
python main.py
```
Load with addition virtual machines define in python modules:
```
python main.py 8_bit_pic f4_misc brainfuck
```
or you can pass-in the same arch. module multiple times to get more than one instance of the same VM type
```
python main.py toy_vm toy_vm
```
Load with debug logging, first arg. must be `--debug`
```
python main.py --debug toy_vm toy_vm
```
## Contribute
All check/ auto-fixes:
```
make check-all
```
Lint:
```
make lint
```
or
```
ruff check
```
Format:
```
make format
```
or
```
ruff format
```
Type checks:
```
make type-check
```
or
```
pyright .
```