Preamble

The Toy programming language is a procedural bytecode-intermediate interpreted language. It isn't intended to operate on its own, but rather as part of another program, the "host". This process is intended to allow a decent amount of easy customisation by the host's end user, by exposing logic in script files. Alternatively, binary files in a custom format can be used as well.

The host will provide all of the extensions needed on a case-by-case basis. Script files have the .toy file extension, while binary files have the .tb file extension.

fn makeCounter() { //declare a function like this
	var total: int = 0; //declare a variable with a type like this

	fn counter(): int { //declare a return type like this
		return ++total;
	}

	return counter; //closures are explicitly supported
}

var tally = makeCounter();

print tally(); //1
print tally(); //2
print tally(); //3

Nifty Features

• Simple C-like syntax
• Bytecode intermediate compilation
• Optional, but robust type system (including opaque for arbitrary data)
• Functions and types are first-class citizens
• Import external libraries
• Fancy slice notation for strings, arrays and dictionaries
• Can re-direct output, error and assertion failure messages
• Open source under the zlib license

Getting Started

• Quick Start Guide
• Types
• Standard Library
• About Library
• Compound Library (under development)
• Timer Library
• Runner Library
• Game Engine

Deep Dive

• Theorizing Toy
• Embedding Toy
• Using Toy
• Compiling Toy
• Developing Toy
• Testing Toy
• Roadmap

Version Differences

There have been a number of versions of Toy over the years, the current actively developed version is in the main branch for the time being. The best version to use is either the code in the main branch, or the latest tagged version.