Documentation

Welcome to the Perun2 documentation. Here is everything you need to know.


What is Perun2?

A scripting language for the file system. Designed for internal use in WojFil Games, now is revealed to the public as free and open-source software. It serves as an elegant tool for creation of the global scripts.
This website and documentation describe the implementation of the language made by WojFil Games. The name Perun2 has two meanings: (1) the language and (2) the entire installable environment consisting of several programs.
The language Perun2 follows the completely opposite philosophy to general-purpose scripting languages with package managers. The language is declarative with very plain design. There are only few primitive data types available to use. No classes and no objects. No frameworks and no design patterns. The language is part of an environment, that works like one, vast, centralized library without the need for external dependencies. This approach is possible because of its narrow domain.
As a language, Perun2 is statically typed with ubiquitous type inference. The main idea was to create a language with as few brackets and arbitrary symbols as possible. Instead of function calls and loops, there are keywords. Unfortunately, Perun2 is already Turing-complete. This property goes against its foundations. Perun2 is the final abstraction. It is not a tool for making abstractions.

Signpost

If you want to just start, enter the quick guide. This page contains examples of Perun2 code. It may be useful if you want to learn by trial and error or to some certain problems. Remaining documentation pages explain various aspects of the language.