BraneScript Reference

BraneScript Reference

BraneScript is a workflow language for orchestrating distributed computations. This page is a concise reference for the language syntax and features.

Statements

All statements end with a semicolon:

let x := 42;
println(x);

Variables

let name := "value";       // String
let count := 42;            // Integer
let ratio := 3.14;          // Real
let flag := true;           // Boolean
let items := [1, 2, 3];    // Array

Reassignment:

let x := 1;
x := 2;

Operators

Arithmetic

Operator	Description
+	Addition
-	Subtraction
*	Multiplication
/	Division
%	Modulo

Comparison

Operator	Description
==	Equal
!=	Not equal
<	Less than
>	Greater than
<=	Less than or equal
>=	Greater than or equal

Logical

Operator	Description
&&	And
`
!	Not

Control Flow

If/Else

if condition {
    // ...
} else if other_condition {
    // ...
} else {
    // ...
}

While

while condition {
    // ...
}

For

for item in collection {
    // ...
}

Functions

Importing Packages

import package_name;

Calling Functions

let result := function_name(arg1, arg2);

Defining Functions

func add(a, b) {
    return a + b;
}

Data

Creating a Data Reference

let data := new Data { name := "dataset_name" };

Passing Data to Functions

let result := process(data);

Classes

Defining a Class

class Point {
    x: Integer;
    y: Integer;
}

Creating Instances

let p := new Point { x := 10, y := 20 };

Accessing Fields

println(p.x);

Arrays

let numbers := [1, 2, 3, 4, 5];
let first := numbers[0];
let length := len(numbers);

Built-in Functions

Function	Description
println(value)	Print a value to output
len(array)	Get array length
commit_result(name, value)	Store a named result

Comments

// Single-line comment

/* Multi-line
   comment */

String Operations

let greeting := "Hello, " + "world!";
let length := len(greeting);

Type Casting

let s := to_string(42);
let n := to_int("42");
let f := to_real("3.14");