Documentation

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


What is Perun2?

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 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.
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 a 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.
Why use this tool and not its alternatives? Syntax of Perun2 is more concise and readable. It makes it easy to define small scripts runnable inside arbitrary directories as explained here. They are really useful and you should give them a chance.

Signpost

If you want to just start, enter quick guide. This page contains examples of Perun2 code. It may be useful if you want to learn by trial and error (the best way to learn) or to solve certain problems. Remaining documentation pages explain various aspects of the language. Do you have any question? Enter the channel of WojFil Games and ask it right there.