Comparison of Rant 3 and 4

Rant 3 (deprecated as of June 2020) was released in April 2017. Since then, several critical design flaws have been identified in the language. Rant 4 aims to address all of those flaws while retaining the ergonomics of the original design.

It is important to note that Rant 3 code is not forwards-compatible with Rant 4. As such, they should be considered as two different languages.

Feature breakdown

Feature nameRant 3Rant 4
Runtime platform.NET-onlyNative
Blocks
Block weights
Selectors(named only)
Queries
Output channels
Hints/sinks
Variables(via stdlib only)
Variable access fallbacks
Operators(via stdlib only)
Named functions
Anonymous functions
Piping
Variable capture in functions
Variadic function parameters(stdlib functions only)
Optional function parameters(stdlib functions only)
Parameter spread notation
Collection initializers
Conditional expressions
Slice notation
Dependency management
(packages)

(modules)
Resource management
(packages)

(data sources)
Print support for non-string values
Automatic number formatting
Explicit global accessors
Explicit parent scope accessors (descoping)
Unit type
Babylonian cuneiform support

(✅ = implemented; ❌ = not implemented)

Multiple outputs

Rant 3 allowed programs to produce multiple outputs via "channels." This was mostly a workaround for the lack of collection types at the time this was implemented, but proved to be more confusing than useful due to the inability of inner program scopes to make use of more than one output. This was ultimately scrapped for Rant 4 in favor of simply using a collection type such as list or map.

Resource management

Rant 3 had a resource management system that used .rantpkg files to load collections of programs and string tables. This required the use of a separate command-line tool to compile package files.

In Rant 4, this system has been replaced by two separate systems: modules now handle code dependency management, and data sources introduce a more flexible way to import external data.

Querying

Rant 3 included a query expression system baked into the language that enabled the user to filter and print random entries from string tables. In Rant 4, this has been removed in favor of using data sources to handle this use case instead.

Variables

Variables in Rant 3 could only be interacted with through standard library functions like [v], [vn], and [vs].

Rant 4 replaces this clunky system with accessors, providing a unified, language-level interface for reading and writing variables.

Example

# Rant 3 example of adding two variables together
[vn: foo; 1]
[vn: bar; 2]
[add: [v: foo]; [v: bar]]
# -> 3


# Rant 4 equivalent
<$foo = 1; $bar = 2>
<foo> + <bar>
# -> 3

Printing types other than strings

Rant 3's printing system worked with strings only; this made operations on non-string types, such as numbers and collections, an extremely laborious task requiring several specialized standard library functions to perform simple tasks like retrieving a value from a list.

Most data types supported by Rant 4 can be created using literals or collection initializers, and printing them produces a value of the same type rather than always coercing to a string.

Functions

Rant 3 had two distinct types of functions: native functions, which made up the standard library and could not be manually created, and subroutines, which were user-definable, required a $ prefix, and lived in a separate object space from regular variables. This system confused a lot of people.

Rant 4 has a single function type that represents all functions-- native or otherwise. Functions are stored like any other variable type. In addition, the language also supports anonymous functions/closures for creating callbacks, which Rant 3 cannot do.

Collections

Rant 3 had list and map types, but they could only be created through standard library functions. This produced code that was hard to read and unavoidably coupled collection data to variables, greatly limiting their usefulness.

Rant 4 includes collection initializer syntax, which enables you to create lists and maps without requiring function calls or temporary variables.

Variadic and optional parameters

Rant 3 only supported variadic and optional parameters on native functions. In Rant 4, any function, inluding user-created functions and lambdas, can include optional and variadic parameters.

Selectors

Rant 3 managed active selectors in a separate object space that persisted for the lifetime of the program. All selectors required names to be used. This behavior wasn't very clear to most users, and scoping selector lifetimes was impossible.

In Rant 4, selectors are represented as values of type special, which can be used once or stored in variables for later.

Examples

Reusing a selector

# Old Rant 3 way of using selectors
[x:foo;locked]  # [x] creates, stores, and applies a named selector
{a|b|c|d|e|f|g|h}
[x:foo;locked]  # it's unclear from any one [x] call where 'foo' is created
{1|2|3|4|5|6|7|8}


# Rant 4 equivalent
<%sync = [mksel: one]>  # [mksel] returns a new selector
[sel: <sync>] {a|b|c|d|e|f|g|h} # [sel] applies a selector
[sel: <sync>] {1|2|3|4|5|6|7|8}

Single-use selector

# Rant 3 single-use selector to shuffle 8 letters
# Even though it's only used once, a name is required
[x:foo;deck][rep:each]{A|B|C|D|E|F|G|H}
# 'foo' then has to be manually destroyed
[xdel:foo]


# Rant 4 equivalent
# [sel] creates & applies a temporary selector if the user supplies a selection type
# You could also use [mksel: deck |> sel] to be more explicit
[sel:deck] [rep:all] {A|B|C|D|E|F|G|H}