Files
Toy/README.md

63 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
*For the feature complete version 1, [click here](https://github.com/Ratstail91/Toy/tree/v1).*
<p align="center">
<image src="toylogo.png" />
</p>
# Toy v2.x
The Toy programming language is an imperative, bytecode-interpreted, embeddable scripting language. Rather than functioning independently, it serves as part of another program, the "host". This design allows for straightforward customization by both the hosts developer and end users, achieved by exposing program logic through text files.
This repository holds the reference implementation for Toy version 2.x, written in C.
# Nifty Features
* Simple C-like syntax
* Intermediate AST representation
* Strong, but optional type system
* First-class functions
* Extensible via external libraries
* Can re-direct output, error and assertion failure messages
* Open source under the zlib license
# Syntax
```toy
print 42; //print is a built-in keyword
//more examples to be added as the features are implemented
```
# Building
Supported platforms are: `linux-latest`, `windows-latest`, `macos-latest`, using [GitHub's standard runners](https://docs.github.com/en/actions/using-github-hosted-runners/using-github-hosted-runners/about-github-hosted-runners#standard-github-hosted-runners-for-public-repositories).
To build the library, run `make source`.
To build the library and repl, run `make repl`.
To build and run the test cases, run `make tests`.
To build and run the test cases under gdb, run `make tests-gdb`.
# Tools
*Coming Soon.*
# License
This source code is covered by the zlib license (see [LICENSE.md](LICENSE.md)).
# Contributors and Special Thanks
For a guide on how you can contribute, see [CONTRIBUTING.md](CONTRIBUTING.md).
@hiperiondev - v1 Disassembler, v1 porting support and feedback
@add00 - v1 Library support
@gruelingpine185 - Unofficial v1 MacOS support
@solar-mist - v1 Minor bugfixes
The Ratbags - Feedback
@munificent - For [writing the book](http://craftinginterpreters.com/) that sparked my interest in langdev
# Patreon Supporters
* Seth A. Robinson