whitespace-asm

Assembler for the Whitespace Programming Language. It generates a Whitespace program based on a file containing a set of keywords instead of having to type in whitespace characters.

See the Whitespace Tutorial for details on the Whitespace language.

Keywords

Keywords are case-insensitive.

Stack Manipulation

Arithmetic

Heap Access

Flow Control

I/O

Comments

Comments may be on a separate line or may be inline. Comments start with ;. Example:

;This a comment
push 'H' ;Stack = 'H'
outc     ;Output 'H'

Parameters

<number>

<number> is just an integer value. It may be positive or negative. Examples:

• 42
• -33

<value>

<value> may either be a <number> or a character. A character is enclosed in single quotes. Backslash may be used for characters like newline ('\n'). Examples of characters:

• ' '
• 'H'
• ';'
• '\n' - Newline
• '\'' - Single quote
• '\\' - Backslash

<label>

<label> is a number that consists of just zeros and one. Examples:

• 011
• 10101

CLI

Assemble

Assemble a Whitespace program:

whitespace-asm <input> [-o/--output <output>] [-f/--format <format>]

where:

• <input> is the path to the input Whitespace Assembly file
• <output> is the optional path to output Whitespace file. If not specified, change the extension of <input> to .ws
• <format> is the optional output format type:
  • raw: just whitespace
  • mark (default): whitespace is preceeded by S (space), T (tab), and L (newline)

Example:

whitespace-asm hello-world.wsasm --output hello-world.ws