README.md

#yasa

yasa is Yet Another Scripting Attrocity. Its main feature is that it takes the stangeness of assembly language, and combines it with the slowness of an interpreted language. Its the worst of both worlds, but I like it all the same.

This package contains:

• The yasa interpreter, yasa

• A brainfuck to yassa translator, fuck-yasa

• A befunge to yasa translator, be-yasa

More information about each of these submodules can be found in their respective directories.

###Language Guide yasa was designed for simplicity of parsing. As such, it consists of only a few different grammars:

• Commands, which are always three letters, and always come at the start of a line
• Variables, which always start with $, and take the form $[a-z]?, with the bare $ as a temp variable.
• Literals, which can always take the place of variables, even when it seems like the shouldn't be able to.
• Comments, which always start with #, and can be either after the arguments of a line, or on a line alone.

In general, the language looks something like:

# Comment
cmd $a 43 $  # More Comment
end

All variables and literals are integers, which may be converted to/from ASCII characters for IO purposes.

In addition to the 27 $var's, the runtime also has access to an array of integers, initailized to 0, that may be accesed at random, or with stack operations.

####Commands: All commands are broken down into these 4 categories. The included yasa.cson file provides syntax highlighting as documented.

As a general rule, the modified variable in a given command will be the last in the argument list.

#####State Change (purple):

Command	Name	Arguments	Description
Copy	cpy	$a$b	assigns $b the value of$a
Push	pus	$a	pushes $a onto global array
Pop	pop	$a	assigns $a value popped from global array
Put	put	$a$i	assigns $a to global array index$i
Get	get	$a$i	assigns value at global array index $i to$a
Add	add	$a$b $r	assigns $r the value `$a + $b`

#####Math (blue):

Command	Name	Arguments	Description
Increment	inc	$a	assigns value $a + 1 to$a
Decrement	dec	$a	assigns vlaue $a -1 to$a
Add	add	$a$b $r	assigns $r the value `$a + $b`
Subtract	sub	$a$b $r	assigns $r the value `$a - $b`
Multiply	mul	$a$b $r	assigns $r the value `$a * $b`
Divide	div	$a$b $r	assigns $r the value `$a / $b`
Modulo	mod	$a$b $r	assigns $r the value `$a % $b`
Random	ran	$n$a	assigns $a random value between 0 and$n
Equal	eql	$a$b $r	gives $r 1 if `$a = b`, else \0
Greater	grt	$a$b $r	gives $r 1 if `$a > b`, else \0

#####Control Flow (teal):

Command	Name	Arguments	Description
Label	lbl	$a	creates a mark for future/past mov's. must be positive
Move	mov	$a [$b]	go to label $a, searching from beginning onward, noop if$b is 0
If	iff	$a	continue if $a is not 0, else jump to next elif or end
Else If	eif	$a	continue if $a is not 0, else jump to next elif or end
Else	els	none	continue so long as previous iff's evaluated false
End	end	none	end iff block or program

#####Input/Output (green):

Command	Name	Arguments	Description
Integer In	iin	$a	assigns $a integer read from stdin
Charachter In	cin	$a	assigns $a char read from stdin
Show	sho	$a	outputs $a as an integer
Display	dis	$a	outputs $a as an ASCII char