SSAL (Super Simple Automating Language)

Docs

SSAL (pronounced "sal" like the Portuguese word for salt) is a lightweight, cross-platform automation language designed to simplify project tasks such as building, running, and cleaning up files. It serves as an easy alternative to batch files, shell scripts, and Makefiles.

Features

• Simple and readable syntax.
• Works on any project, regardless of language.
• Cross-platform support (Windows, macOS, Linux).
• Available as both a global CLI and an npm package.

Installation

Global Installation

Install SSAL globally so you can use it in any project:

npm install -g ssal

Project-Specific Installation

Install SSAL as a development dependency in your project:

npm install --save-dev ssal

Usage

Writing an SSAL Script

Create a tasks.ssal file in your project:

# SSAL script to build and run a C++ project

var COMPILER = "g++"

task build:
    run "$COMPILER main.cpp -o main"

task run:
    run "./main"

task clean:
    del "main"

Running Tasks

Execute a task from your SSAL file:

ssal build

Run multiple tasks sequentially:

ssal build run

List all available tasks:

ssal --list

Syntax

Comments

Comments are defined with #, only single line comments are supported

# this is a comment

Variables

Variables are declared using the var keyword.

var VERSION = "1.2.3"

You can get the value off a variable with $VARNAME

ech $VERSION

Tasks

Tasks are defined using the task keyword, followed by the task name.

task test:
    task commands run in order