VVhitespace

Welcome to VVhitespace!

VVhitespace is a programming language that descends from Whitespace, making a small number of changes with the intention of taming the language, providing the tools necessary to build non-trivial, whitespace-only applications. As a proof of concept, the repository includes an implementation of Hunt the Wumpus written in VVhitespace.

Only the characters [Space], [Tab], [VTab] and [LineFeed] have meaning in VVhitespace. All other characters are considered comments. For this reason, VVhitespace programs may be embedded in other documents, including in the source code of other languages.

The language repository contains several parts:

A compiler, vvc, accepts human-readable VVhitespace source code and translates it to true VVhitespace code.
An interpreter, vvi, accepts true VVhitespace files as generated by vvc and executes them according to the language rules.
A library of useful functions including enhanced stack operations, printf, math operations including random number generation, heap operations, string manipulations and user interactions, and bitwise logic functions.
Hunt the Wumpus, a text game in which you explore a randomly connected set of caverns, avoiding deep pits and giant cave bats, all while shooting arrows at a Wumpus that wants to eat a tasty, meaty human like yourself!
Examples including code commentary that demonstrate VVhitespace and the stdlib.
Tests for both the VVhitespace language and the stdlib. Intended to increase confidence for users that want to tinker with the internals, both test suites come with a README explaining how to run the tests and extend them as necessary.

Obtain VVhitespace at https://git.subgeniuskitty.com/vvhitespace/.git.

See README.md for more information.