Ter/Terlang

Programming language for scripting with syntax similar to C++

---

Summary

1. Building and Installing on UNIX-style systems
2. Building and Installing on Windows
3. Only installing on Windows or Ubuntu
4. Using
5. Tutorials
6. Extensions and LICENSE

---

Dependencies

• GNU GCC, Clang or MSVC
• CMake

C++23

Building on UNIX-style systems

macOS, GNU/Linux, BSD-Like, Haiku and others.

git clone https://github.com/terroo/terlang
cd terlang
cmake -B build .
cmake --build build
sudo cmake --install build

REPL:

To test the ter command.

$ ter
ter> output("Hello Ter!")

---

Building and Installing on Windows

With MSVC!

Open PowerShell (Run as Administrator) from the Windows Start Menu

git clone https://github.com/terroo/terlang
cd terlang\
cmake -B build .
cmake --build build

# Create destination folders and subfolders
New-Item -Path "C:\Program Files\Terlang\bin" -ItemType Directory -Force

# Move to destination folder
Move-Item -Path "build\Debug\ter.exe" -Destination "C:\Program Files\Terlang\bin\ter.exe"

# Create an environment variable for system "Path"
[System.Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\Terlang\bin", [System.EnvironmentVariableTarget]::Machine)

Close PowerShell, then reopen and run:

To test the ter command.

ter --version
Ter/Terlang v0.1.1

Usage: 
	ter [filename].ter
	ter -e '<script>'

---

Only installing on Windows or Ubuntu

Windows:

Invoke-WebRequest -Uri "https://github.com/terroo/terlang/releases/download/v0.0.1/terlang-windows-0.0.1.zip"

• Unzip
• Create folders and subfolders: C:\Program Files\Terlang\bin
• Move the .exe to the bin\ subfolder
• Add the path as an environment variable to just the ter command in PowerShell or CMD

Ubuntu:

wget https://github.com/terroo/terlang/releases/download/v0.0.1/terlang-ubuntu-24-04-0.0.1.zip
unzip terlang-ubuntu-24-04-0.0.1.zip
sudo mv ter /usr/local/bin

And test:

ter --version
Ter/Terlang v0.1.1

Usage: 
	ter [filename].ter
	ter -e '<script>'

---

Using

vim hello.ter

01. Hello, World!

// Comment line
auto hello = "Hello, Terlang! 😃 ";
output(hello);
/*
  Multiline
  comments
*/

Semicolon is optional: auto hello = "Hello, Terlang!". Literally skipping the line: out("Hello\n")

Run:

ter hello.ter

Output: Hello, Terlang! 😃

02. Arrays

auto list = {13, 2, 8, 4, 17, 12, 11, 9};
output(list[6]); // 11

03. Loops

for(auto i = 0; i < 5; ++i){ // Or i++
  out(to_string(i) + " | ")
}
out("\n")
// 0 | 1 | 2 | 3 | 4 |


auto i = 0;
while(i < 5){
  out(to_string(i) + " | ")
  ++i;
}
out("\n")
// 0 | 1 | 2 | 3 | 4 |

05. Includes

main.ter

include("./library.ter")
output(value); // 18

library.ter

auto value = 18;

06. Functions

set print(str){
  output(str);
}

set add(x, y){
  return x + y;
}

set increment(a){
  return ++a;
}

print("My content"); // My content
output(add(3, 9)); // 12

auto result = increment(6);
output(result); // 7

07. Classes

class Animal {
  cat(name){
    output("Cat name is: " + name);
  }

  dog(){
    output("I am dog!");
  }

  descAnimal(human){
    return "Human: " + human;
  }
}

Animal().cat("Bob");

auto obj = Animal();
obj.dog();

output(obj.descAnimal("Peter"));

Output:

Cat name is: Bob
I am dog!
Human: Peter

08. Builtin Functions

// Rand number
auto num = rand(5, 15);
output(num) // Number between 5 and 15

// Clock
auto myclock = clock();
output(myclock); // Ex.: 1732022610.561000

// Environment variables
auto home = getenv("HOME");
output(home); // Ex.: /home/user

auto shell = getenv("SHELL")
output(shell); // Ex.: /bin/bash

// Exec shell
exec("ls")

// Compiling C++ code
exec("g++ main.cpp")
exec("./a.out")

---

09. Command line arguments

params.ter

auto params = args()
output(params)

Example 01, withOUT params:

ter params.ter 
[]

Example 02, WITH params:

ter params.ter first second --third "My Four"
[first, second, --third, My Four]

Example 02, WITH ESPECIFIC param:

params.ter

auto params = args()
output(params[0])

ter params.ter file.txt
file.txt

---

10. Run from command line

ter -e 'output("Hello, Word!")'
ter -e 'auto x = 9 output(x)'
ter -e 'auto var = 42;out(to_string(var) + "\n")'
ter -e "$(cat build.ter)"

---

11. Using Emscripten

Compiling:

emmake cmake -B web .
cd web
emmake make

Testing:

node ter.js -e 'output("Hello, Word!")'
node ter.js -e 'auto var = 42;out(to_string(var) + "\n")'
node ter.js -e "$(cat build.ter)"

---

Tutorials

From video.

Helper:

ter --help

Stay tuned for the version: ter --version

---

Extensions and LICENSE

Syntax highlight for Vim

Syntax highlight for Neovim

Syntax highlight for VS Code

Created by Saymon Macedo.

My alternative version

---

Speed test

Based on these tests that were done.

speed.ter

for(auto i = 0; i < 1000000; ++i){
  out("Ok" + to_string(i) + "\r")
}

Run time ter speed.ter and result:

Ok999999
real	0m2,632s
user	0m2,500s
sys	0m0,110s

---

LICENSE GNU GPLv3