Aussom Lang - Aussom Base

What It Is

Aussom Base is the core Aussom interpreter packaged as a Maven library. Embed it in any JVM application to give your users a safe, sandboxed scripting layer. Scripts run inside your process with fine-grained control over what resources they can access.

Key Features

Built-in Security Manager. Control exactly which files, network resources, and Java classes a script can touch. Ideal for running untrusted or third-party code.
Simple Embedding API. Add Aussom to your Java application with a few lines of code. Create an engine, load a script, and run it. The host application stays in full control.
Full OOP Language. Classes, inheritance, exception handling, and a growing standard library. Not a toy scripting language.
One Language Everywhere. Code written for Aussom Base runs unchanged on Aussom Server and in the browser via Aussom-Script.

Who It Is For

Java developers who need to add extensibility or plugin support to their applications without sacrificing security.

Getting Started

Browse the guides in the sidebar to learn the language fundamentals, then explore the API reference for detailed class and method documentation. The Language Overview is the best place to start.

Guides

Language Overview

What Aussom is, how its pieces fit together, and a map of the rest of these docs.

Variables

Local versus member variables, public and private access modifiers.

Data Types

The nine built-in types: null, bool, int, double, string, list, map, callback, object.

Functions

Defining and calling functions, default and variadic arguments, type annotations, set blocks.

Control Flow

if / else if / else, switch / case, while, and for loops including list and map iteration.

Operators

Math, string, list and map operators, the safe-access ?, and operator precedence.

Classes

Constructors, inheritance (single and multiple), static classes, instanceof.

Exception Handling

try / catch, the exception object methods, throw, and when to let exceptions propagate.

Modules

Splitting code across files with include, dotted module paths, and delayed includes.

Extern Classes

How Aussom calls into Java code, what extern declarations look like, and inheritance rules.

Standard Library

Tour of the modules that ship with the interpreter, plus what each runtime adds on top.

Style Guide

Naming conventions, formatting, and Aussom-Doc comments. Apply across all .aus code.

Annotations Guide

Attach metadata to classes, members, and methods. Read it back through the reflect module.