Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cyberfined/wspasm
whitespace assembler written in assembly
https://github.com/cyberfined/wspasm
amd64only assembler linux-only transpiler whitespace-language
Last synced: about 1 month ago
JSON representation
whitespace assembler written in assembly
- Host: GitHub
- URL: https://github.com/cyberfined/wspasm
- Owner: cyberfined
- License: wtfpl
- Created: 2023-11-24T21:55:00.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2023-11-29T21:08:57.000Z (about 1 year ago)
- Last Synced: 2023-11-30T21:29:14.309Z (about 1 year ago)
- Topics: amd64only, assembler, linux-only, transpiler, whitespace-language
- Language: Assembly
- Homepage:
- Size: 23.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# wspasm
two pass whitespace assembler.
## Usage
```bash
wspasm
```
## Build dependencies
1. nasm
2. make
## Build
```bash
make
```
## Examples
Let's write classic Hello world example.
hello.wspasm:
```
; Push "Hello world\n" to the stack
push '\n'
push 'd'
push 'l'
push 'r'
push 'o'
push 'w'
push ' '
push 'o'
push 'l'
push 'l'
push 'e'
push 'H'
push 12 ; string length
loop:
swap ; swap length with char
putchar
; length -= 1
push 1
sub
; if (length == 0) exit
dup
jz end
jmp loop
end:
exit
```
Then translate it to whitespace with
```bash
wspasm hello.wspasm hello.ws
```
resulted file is
```whitespace
[space][space][space][tab][space][tab][space]
[space][space][space][tab][tab][space][space][tab][space][space]
[space][space][space][tab][tab][space][tab][tab][space][space]
[space][space][space][tab][tab][tab][space][space][tab][space]
[space][space][space][tab][tab][space][tab][tab][tab][tab]
[space][space][space][tab][tab][tab][space][tab][tab][tab]
[space][space][space][tab][space][space][space][space][space]
[space][space][space][tab][tab][space][tab][tab][tab][tab]
[space][space][space][tab][tab][space][tab][tab][space][space]
[space][space][space][tab][tab][space][tab][tab][space][space]
[space][space][space][tab][tab][space][space][tab][space][tab]
[space][space][space][tab][space][space][tab][space][space][space]
[space][space][space][tab][tab][space][space]
[space][space][space]
[space]
[tab][tab]
[space][space][space][space][space][tab]
[tab][space][space][tab][space]
[space]
[tab][space][tab]
[space]
[space]
[space][space][tab]
```
Another examples you can see in the examples directory
## Instructions
| Instruction | argument | description |
|-------------|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| dup | - | duplicates top of the stack |
| jz | label | jumps to label if top of the stack is 0 |
| jl | label | jumps to label if top of the stack is negative |
| jmp | label | unconditionally jumps to label |
| label: | - | defines a label. Label name defined with following regexp [A-Za-z_]+[A-Za-z_0-9]* |
| swap | - | swaps two top elements of the stack |
| drop | - | drops top of the stack |
| add | - | adds two top elements of the stack and puts result to the top of the stack |
| sub | - | subtracts two top elements of the stack and puts result to the top of the stack |
| div | - | divides two top elements of the stack and puts quotient to the top of the stack |
| mod | - | divides two top elements of the stack and puts remainder to the top of the stack |
| push | number/character | pushes number or character code to the top of the stack. number defines with following regexp -?[0-9]+. character defines with following regexp '\[ntr]\|.' |
| store | - | puts number from the top of the stack to the heap by address defined with the second element of the stack |
| load | - | loads number from heap by address defined with the top of the stack and pushes it to the top of the stack |
| call | label | calls a function |
| ret | - | returns from a function |
| exit | - | terminates execution of the program |
| putchar | - | removes character from the top of the stack and prints it |
| getchar | - | reads character from stdin and puts it to the heap by address defined with the top of the stack |
| putnum | - | removes number from the top of the stack and prints it |
| getnum | - | reads number from stdin and puts it to the heap by address defined with the top of the stack |