greenServeFE logo
greenServeFEProgramming Language Guide
Language documentation · Linux setup

Build with greenServeFE.

Explore the greenServeFE language, learn its syntax and modules, and get started with practical programs. Download the complete PDF documentation or install the command-line tools through MacoraOne.

GSVE syntax and Aurora color specification

The official greenServeFE syntax extension uses the greenServeFE Aurora dark theme. The color samples below are rendered with their actual hexadecimal values, not just color names. Use these token categories when implementing GSVE highlighting in an editor, IDE, website, or documentation tool.

Live GSVE color demonstration

Each token is displayed using the same foreground color defined by the Aurora theme.

# Aurora syntax demonstration
import gs_math;
define temperature = 36.5;
define message = "Hello, greenServeFE!";
func describe(value) {
    print("Reading:", value);
    print(gs_math.round(value));
}
if (true && temperature > 0) {
    describe(temperature + 1);
}
config = { mode: "demo", enabled: false };

The sample is illustrative syntax highlighting; use only language constructs and APIs supported by the installed greenServeFE runtime.

Token colors

Default text / identifiers#EAF2FF
Comments#83BFA8
Control and declaration keywords#FF6BCB
Strings#B7F774
String escape sequences#FFE27A
Numeric literals#64D8FF
Function declarations and calls#FFD166
Member function calls#52E0D0
Built-in functions#C7A6FF
Native modules / import namespaces#5CE1E6
Object keys / properties#8FC7FF
Language constants (true, false, null)#FFB86C
Operators#FF9F68
Punctuation#A9B8D0
Function parameters#F6A6FF

Syntax categories

  • Comments: begin with # and continue to the end of the line.
  • Strings: single- or double-quoted; escaped characters receive a separate scope.
  • Keywords: define, if, else, for, in, while, func, return, break, continue, from, import.
  • Constants: true, false, null.
  • Built-ins: print, interact, len, str, num, type, range, push, pop, keys, values, contains, clone, merge, has, class, new, instanceof.
  • Modules: server, construct, gsnum, gs_table, gs_compute, gs_string, gs_json, gs_csv, gs_path, gs_time, gs_random, gs_uuid, gs_validate, gs_env, gs_hash, gs_base64, gs_math, gs_url, gs_file, gs_http, gs_crypto, gs_db, gs_log, gs_form, gs_object, gs_plot, gs_regex, gs_statistics, gs_test, gs_brain, gs_physics, gs_chemistry, gs_signal, gs_xml, gs_yaml, gs_compat.
  • Other scopes: function names, member calls, object keys, numbers, operators, punctuation and identifiers.

Implementing the palette in another editor

A compatible highlighter should tokenize GSVE source first, then map each token category to the exact Aurora foreground value. Do not color tokens using substring matching alone: comments and quoted strings must be recognized before identifiers, keywords, and operators so their contents are not recolored accidentally.

/* Example CSS token mapping */
.gsve-comment   { color: #83BFA8; font-style: italic; }
.gsve-keyword   { color: #FF6BCB; font-weight: 700; }
.gsve-string    { color: #B7F774; }
.gsve-escape    { color: #FFE27A; font-weight: 700; }
.gsve-number    { color: #64D8FF; font-weight: 700; }
.gsve-function  { color: #FFD166; font-weight: 700; }
.gsve-member    { color: #52E0D0; font-weight: 700; }
.gsve-builtin   { color: #C7A6FF; font-weight: 700; }
.gsve-module    { color: #5CE1E6; font-weight: 700; }
.gsve-property  { color: #8FC7FF; }
.gsve-constant  { color: #FFB86C; font-weight: 700; }
.gsve-operator  { color: #FF9F68; font-weight: 700; }
.gsve-punctuation { color: #A9B8D0; }

The authoritative grammar scopes and theme are maintained in the greenServeFE syntax extension. Refer to its TextMate grammar and Aurora color-theme JSON when building an editor integration.

Download the language guides

PDF editions from the greenServeFE language guide release.

Complete reference

Detailed Language Guide

A detailed reference for learning the language and its programming concepts.

Download PDF
Introduction

Language Overview

An introductory overview of greenServeFE and its core language concepts.

Download PDF
Libraries

Module Usage

Learn how to import and use the available greenServeFE modules.

Download PDF
Examples

Real-World Programs

Study practical program examples and patterns.

Download PDF

Install on Linux

Install MacoraOne first. The installer places the executable at /usr/local/bin/one.

Install MacoraOne

Run this complete command in a Linux terminal. It downloads the v1.0.2 release, extracts the executable, and installs it as one.

set -eu

URL="https://github.com/MacoraOne/MacoraOne/releases/download/one-v1.0.2/macoraone-linux-x86_64.zip"
TMP_DIR="$(mktemp -d)"
trap 'rm -rf "$TMP_DIR"' EXIT

curl -fL "$URL" -o "$TMP_DIR/macoraone-linux-x86_64.zip"
unzip -q "$TMP_DIR/macoraone-linux-x86_64.zip" -d "$TMP_DIR/extracted"

# Locate the executable inside the archive.
BIN="$(find "$TMP_DIR/extracted" -type f \( -name 'macoraone' -o -name 'macoraone-linux-x86_64' -o -name 'one' \) -print -quit)"

if [ -z "$BIN" ]; then
    echo "Error: could not find the MacoraOne executable in the release archive." >&2
    echo "Archive contents:" >&2
    find "$TMP_DIR/extracted" -maxdepth 3 -type f -print >&2
    exit 1
fi

chmod +x "$BIN"
sudo install -m 0755 "$BIN" /usr/local/bin/one

echo "MacoraOne installed as the 'one' command at /usr/local/bin/one"
one --help
Requirements: curl, unzip, and permission to install the executable into /usr/local/bin. If your Linux distribution does not already include curl or unzip, install those system packages first.

Install greenServeFE

Use MacoraOne to install or remove the language package.

# Install the greenServeFE language package
one install greenServeFE

# Check the command
greenServeFE --help

# Remove the greenServeFE language package
one uninstall greenServeFE

Manage modules with MacoraOne

Install and uninstall packages individually. Use the exact package name and version published in the MacoraOne catalogue.

Install one module

Install a module by its package name, optionally with a published version.

one install server
one install server@1.0.0

Install another module

Run a separate command for each additional module.

one install gs_regex
one install gs_json

Uninstall a module

Remove an individual module by package name.

one uninstall server
one uninstall gs_regex

Install or uninstall all

Use the catalogue-wide commands when you intend to manage all available packages.

one install all
one uninstall all

MacoraOne is the unified project for package and tool management. For predictable results, install one package per command; repeat the command for each module you need. The availability of a package depends on the published catalogue.

Project: MacoraOne on GitHub

Your first greenServeFE program

Create a file named hello.gsve, then run it with the greenServeFE command.

1. Create hello.gsve

print("Hello, greenServeFE!");
print("Welcome to programming.");

2. Run the program

greenServeFE hello.gsve

Example using a module

After installing the corresponding module, import it in your program and call its functions.

import gs_regex;

define email_shape = "^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}$";

print(gs_regex.match("ada@example.com", email_shape));
print(gs_regex.test("order-2048", "^order-[0-9]+$"));
print(gs_regex.replace_first("green green", "green", "blue"));

Save source files with the .gsve extension. The command-line form is greenServeFE filename.gsve. Consult the detailed guide and module-usage PDF for the language reference and supported module APIs.

Complete language, VM and module reference

Each guide has its own searchable page with SEO metadata, API exports, usage examples and implementation notes. XML and YAML module references are intentionally not modified or included in this update.

Language and VM

Web development

Native modules

Native module availability depends on the matching shared object being built and installed. The VM and native module ABI are documented separately from optional host integrations.

Scientific and engineering modules

Source-grounded API references for physics, chemistry and digital signal processing.

Open learning and education

Developed by Dominex Macedon

greenServeFE is developed by Dominex Macedon. Universities, schools, educators, and programming communities can use the language and these learning materials freely for learning, teaching, and educational activities.

MacoraOne is the unified project supporting package and tool management.

Explore the MacoraOne project

Copyright © Dominex Macedon. All rights reserved.