wray

The tiny wren runtime.

Wray can be used to create any type of program: from basic command line tools up to fully fledged graphical applications and games. Programs written with it are lightweight, fast and cross platform. All of this is possible thanks to wray's main dependencies: the amazing raylib library and the wren programming language.

The project takes A LOT of inspiration from the love2d framework, but trying to be even more lightweight and friendly to use. Wray aims to be a self-contained, scripting tool with minimal dependencies and a lot of educational value.

Features

Simple: the API is friendly and can be learned by anyone.
Fast: thanks to the speed of wren and raylib.
Cross Platform: wray works on all major desktop platforms.
Tiny: the runtime is self-contained and minimal in size.
Educational: easy to get up and running with writing code.
Versatile: can be used to create a vast array of different programs.

Getting Started

To get started simply download the latest release for your operating system. Wray has a simple CLI which allows to create, package and run projects.

wray new my_project
wray my_project

This should output: "Hello, World!".

If so you are ready to start writing code! Just open the new folder in a code editor. To learn everything you can do with wray, look at the api file in the source directory. Also check out wren's documentation.

The following code opens a window:

import "wray" for Window, Graphics, Color

Window.init(640, 480, "Hello Wray!")
Window.targetFps = 60

while (!Window.closed) {
    Graphics.begin()

    Graphics.clear(Color.blue)

    Graphics.end()
}

For more examples check the examples folder in the repository! Also look at the modules directory for some wren libraries to use in your projects!

Distribution

Once you've completed your project, you have to package it up. First you should create an egg file. This is an archive that contains all the project files and assets.

wray nest my_project

This file can now be distributed, but users will need to have the wray runtime installed. You can also create completely indipendent executables by fusing the runtime and the egg file.

wray fuse my_project.egg

This will create the file my_project.exe, which can be distributed.

Building

To build wray from source you need cmake.

mkdir build
cd build
cmake ..
cmake --build . --config Release

Acknowledgements

Thanks to all these amazing projects:

License

Wray is licensed under the MIT License. See the LICENSE file for details.