BRASCA
BRASCA - BRAckets and other Symbols turning Code into Ascii
i tried my best with the acronym, okay
Installation & Usage
- Get Python 3.9
- Run your code with
python brasca.py c <your code> or python brasca.py f <filename>.
- Use
python brasca.py cd/fd <code/file> for debugging the stack.
- Use
python brasca.py cs/fs <code/file> to slow down the output.
- Use
python brasca.py cds/fds <code/file> for both.
Data
- Data is stored as unbounded numbers on a stack.
- Popping an empty stack returns 0.
- Two unbounded registers: A and B.
Commands
Math Operators
| Operator
|
Function
|
0-9
|
Push the number to the stack
|
l
|
Push 10 to the stack
|
L
|
Push 13 to the stack
|
e
|
Push 26 to the stack
|
E
|
Push 32 to the stack
|
d
|
Push 48 to the stack
|
D
|
Push 65 to the stack
|
h
|
Push 97 to the stack
|
H
|
Push 100 to the stack
|
K
|
Push 1000 to the stack
|
`
|
Push all following characters to the stack until another backtick or EOF
|
'
|
Push the next character to the stack
|
+
|
Pop A,B from the stack, push B+A to the stack
|
-
|
Pop A,B from the stack, push B-A to the stack
|
*
|
Pop A,B from the stack, push B*A to the stack
|
/
|
Pop A,B from the stack, push B/A to the stack
|
%
|
Pop A,B from the stack, push B%A to the stack
|
^
|
Pop A,B from the stack, push B**A to the stack
|
s
|
Pop A from the stack, push sqrt(A) to the stack
|
}
|
Increment top of stack
|
{
|
Decrement top of stack
|
<
|
Pop A,B from the stack, push 1 to the stack if B < A, else push 0 to the stack
|
>
|
Pop A,B from the stack, push 1 to the stack if B > A, else push 0 to the stack
|
=
|
Pop A,B from the stack, push 1 to the stack if B == A, else push 0 to the stack
|
Bitwise Operators
| Operator
|
Function
|
~
|
Pop A from the stack, push NOT A to the stack
|
&
|
Pop A,B from the stack, push B AND A to the stack
|
|
|
Pop A,B from the stack, push B OR A to the stack
|
_
|
Pop A,B from the stack, push B XOR A to the stack
|
Stack
| Operator
|
Function
|
a
|
Pop the stack, push it to register A
|
A
|
Pop register A, push it to the stack
|
b
|
Pop the stack, push it to register B
|
B
|
Pop register B, push it to the stack
|
,
|
Reverse stack
|
:
|
Duplicate the top of the stack
|
;
|
Duplicate the bottom of the stack
|
m
|
Pop the top of the stack and push the value to BOS
|
M
|
Pop the bottom of the stack and push the value to TOS
|
p
|
Pop n from the top of the stack and push the top n items on the stack to BOS
|
P
|
Pop n from the bottom of the stack and push the bottom n items on the stack to TOS
|
?
|
Pop n from the top of the stack and push a random number from 0 to n (inclusive) to the stack
|
!
|
Push the length of the stack to the stack
|
$
|
Swap the top two items on the stack
|
R
|
Rotate the top three items on the stack
|
S
|
Pop A,B from the stack, concatenate B and A, push the result to stack
|
x
|
Pop the top of the stack and discard it
|
X
|
Pop the bottom of the stack and discard it
|
i
|
Convert stack from ASCII to number
|
I
|
Convert stack from number to ASCII
|
g
|
Concatenate stack together
|
I/O
| Operator
|
Function
|
Implicit input
|
If there's any data piped in via STDIN, it's pushed on the stack by default
|
o
|
Output the top of the stack to STDOUT as ASCII
|
O
|
Output the bottom of the stack to STDOUT as ASCII
|
n
|
Output the top of the stack to STDOUT as a number
|
N
|
Output the bottom of the stack to STDOUT as a number
|
Implicit output
|
If nothing is printed before termination, output the stack in reverse as ASCII.
|
Control Flow
| Operator
|
Function
|
@
|
Terminate program without implicit output.
|
#
|
Pop A from the stack, if A > 0, execute the next instruction, otherwise skip it.
|
[...]
|
Check, but don't pop, the top of the stack. While it is non-zero, loop the code inside [ ]
|
j
|
Pop n from the stack, move the code pointer n cells backwards
|
J
|
Pop n from the stack, move the code pointer n cells forwards
|
Anything else
|
No-op
|
Examples
D7+h4+H8+::3+d4-EHl9++Hl1++:3+:6-HE1+
External resources
GitHub Repo
Online interpreter