GreyMatter Programming Language

GreyMatter is an experimental programming language developed in Python with the goal of helping students and developers understand how programming languages work internally. The language demonstrates fundamental concepts behind interpreters, lexical analysis, parsing, syntax evaluation, and runtime execution.

Unlike production programming languages that prioritize performance and large ecosystems, GreyMatter focuses on simplicity, experimentation, and educational exploration. The syntax is intentionally designed to be simple and expressive so that beginners can easily understand how a custom programming language behaves.

GreyMatter includes many core programming constructs such as variables, arithmetic operations, conditionals, loops, functions, and built-in utilities. The interpreter processes user code through several internal steps including tokenization, parsing, abstract syntax tree construction, and execution.

The project is implemented in Python and uses SLY for building the lexer and parser components of the interpreter.

GreyMatter is primarily intended for:

Learning programming language design
Understanding interpreter development
Exploring syntax parsing techniques
Experimenting with custom programming languages
Educational demonstrations for computer science students

Inspiration

The concept and name of GreyMatter were inspired by the highly intelligent alien Grey Matter from the animated television series Ben 10.

In the Ben 10 universe, Grey Matter represents intelligence, analytical thinking, and problem solving. This programming language was created with a similar philosophy: encouraging logical thinking and experimentation through programming.

Many built-in functions in the GreyMatter language are named after alien characters and abilities from the Ben 10 universe. These names symbolize the different abilities and operations the language can perform.

Project Objectives

The GreyMatter project was designed with the following goals:

• Demonstrate how programming languages are implemented • Provide an educational interpreter written in Python • Help students learn parsing and syntax evaluation • Encourage experimentation with programming language design • Combine creativity with programming concepts

Technology Stack

GreyMatter is implemented using the following technologies:

| Technology | Purpose | | ----------------------- | ------------------------------- | | Python | Core interpreter implementation | | SLY | Lexer and parser construction | | AST Model | Program execution structure | | Python Standard Library | Utility functions |

Core Language Features

GreyMatter includes the following features:

Dynamic variables
Arithmetic expressions
Conditional logic
Logical operators
Loop structures
User-defined functions
Built-in utility functions
String manipulation
Time utilities
Memory storage utilities
Experimental web and AI query features

Basic Program Example

x = 10
y = 20

z = x + y

PRINT(z)

Output

Variables

Variables in GreyMatter are dynamically typed. They are automatically created when a value is assigned.

Example

name = "Abinesh"
age = 21
score = 95

Example program

name = INPUT("Enter your name: ")
PRINT("Hello", name)

Arithmetic Operations

GreyMatter supports basic mathematical operations.

| Operator | Description | | -------- | -------------- | | + | Addition | | - | Subtraction | | * | Multiplication | | / | Division | | % | Modulus |

Example

x = 10
y = 3

PRINT(x + y)
PRINT(x - y)
PRINT(x * y)
PRINT(x / y)
PRINT(x % y)

Output

Increment and Decrement

GreyMatter allows increment and decrement operators.

Example

x = 5
x++
PRINT(x)

Output

Example

x = 10
x--
PRINT(x)

Output

Compound Assignment

Compound assignments simplify arithmetic updates.

Example

x = 10

x += 5
PRINT(x)

Output

Other operators

x -= 3
x *= 2
x /= 4
x %= 3

Input and Output Functions

PRINT()

The PRINT function displays output to the console.

Example

PRINT("Welcome to GreyMatter")

Example with variables

name = "Developer"
PRINT("Hello", name)

Output

Hello Developer

INPUT()

INPUT reads text input from the user.

Example

name = INPUT("Enter your name: ")
PRINT(name)

INT()

Converts a value to an integer.

Example

age = INT(INPUT("Enter your age: "))
PRINT(age)

STR()

Converts a value to a string.

Example

number = 100
text = STR(number)
PRINT(text)

Conditional Statements

GreyMatter supports conditional logic using IF and ELSE.

Example

age = INT(INPUT("Enter age: "))

IF(age >= 18){

   PRINT("Eligible to vote")

}
ELSE{

   PRINT("Not eligible")

}

Comparison Operators

| Operator | Description | | -------- | --------------------- | | == | Equal | | != | Not Equal | | > | Greater Than | | < | Less Than | | >= | Greater Than or Equal | | <= | Less Than or Equal |

Example

x = 10
y = 5

IF(x > y){

   PRINT("x is greater")

}

Logical Operators

| Operator | Meaning | | -------- | ----------- | | AND | Logical AND | | OR | Logical OR |

Example

x = 10
y = 20

IF(x > 5 AND y < 30){

   PRINT("Condition satisfied")

}

Loops

WHILE Loop

Example

x = 1

WHILE(x <= 5){

   PRINT(x)
   x++

}

Output

FOR Loop

Example

FOR(i = 0 ; i <= 5 ; i++){

   PRINT(i)

}

Short loop example

FOR(3){

   PRINT("GreyMatter")

}

Output

GreyMatter
GreyMatter
GreyMatter

Functions

Functions allow code reuse.

Example

FUNCTION add(x,y){

   result = x + y
   FEEDBACK(result)

}

Calling function

sum = add(5,6)
PRINT(sum)

Output

FEEDBACK Statement

FEEDBACK returns values from functions.

Example

FUNCTION square(x){

   FEEDBACK(x*x)

}

Example call

PRINT(square(4))

Output

Built-in Utility Functions

Many functions in GreyMatter are named after alien abilities from the Ben 10 universe.

ECHO

Prints a blank line.

Example

PRINT("Hello")
ECHO
PRINT("World")

ECHOECHO

Prints multiple blank lines.

Example

PRINT("Start")
ECHOECHO
PRINT("End")

LEN()

Returns length of a string.

Example

text = "GreyMatter"
PRINT(LEN(text))

Output

FASTTRACK()

Returns character at a given index.

Example

word = "hello"
PRINT(word.FASTTRACK(1))

Output

WAYBIG()

Converts text to uppercase.

Example

text = "hello"
PRINT(text.WAYBIG())

Output

HELLO

NANOMECH()

Converts text to lowercase.

Example

text = "HELLO"
PRINT(text.NANOMECH())

Output

hello

ISWAYBIG()

Checks whether text is uppercase.

Example

text = "HELLO"

PRINT(text.ISWAYBIG())

Output

True

ISNANOMECH()

Checks whether text is lowercase.

Example

text = "hello"

PRINT(text.ISNANOMECH())

Output

True

PARADOX Time Utilities

PARADOX.SLEEP()

Pauses program execution.

Example

PRINT("Start")
PARADOX.SLEEP(3)
PRINT("End")

PARADOX.UNITIME()

Returns system time.

Example

PRINT(PARADOX.UNITIME())

PARADOX.UNIDATE()

Returns system date.

Example

PRINT(PARADOX.UNIDATE())

BRAINSTORM Memory System

BRAINSTORM is a simple data storage system inside GreyMatter.

BRAINSTORM.READ()

Stores value in memory.

Example

BRAINSTORM.READ(10)
BRAINSTORM.READ(20)

BRAINSTORM.WRITE()

Writes value to memory.

Example

BRAINSTORM.WRITE(x)

BRAINSTORM.GET()

Retrieves stored data.

Example

BRAINSTORM.GET()

JETRAY()

Executes fast interpreter commands.

Example

JETRAY("system_task")

Web Search Feature

Example

PRINT(@WEB_SEARCH "Python programming language")

AI Query Feature

Example

PRINT(@AI "Explain machine learning")

BREAK Statement

Stops loop execution.

Example

WHILE(1){

   PRINT("Running")

   BREAK

}

Comments

GreyMatter supports two comment formats.

Example

# this is a comment #

Example

// this is another comment //

Complete Built-in Function Table

| Function | Description | Example | | ------------------ | ---------------------- | -------------------- | | PRINT() | Display output | PRINT("Hello") | | INPUT() | Get user input | name = INPUT("Name") | | INT() | Convert to integer | age = INT(INPUT()) | | STR() | Convert to string | STR(100) | | LEN() | Get string length | LEN("hello") | | FASTTRACK() | Character index access | word.FASTTRACK(1) | | WAYBIG() | Convert to uppercase | text.WAYBIG() | | NANOMECH() | Convert to lowercase | text.NANOMECH() | | ISWAYBIG() | Check uppercase | text.ISWAYBIG() | | ISNANOMECH() | Check lowercase | text.ISNANOMECH()

GreyMatter

Install / Use

README

GreyMatter Programming Language

Inspiration

Project Objectives

Technology Stack

Core Language Features

Basic Program Example

Variables

Arithmetic Operations

Increment and Decrement

Compound Assignment

Input and Output Functions

PRINT()

INPUT()

INT()

STR()

Conditional Statements

Comparison Operators

Logical Operators

Loops

WHILE Loop

FOR Loop

Functions

FEEDBACK Statement

Built-in Utility Functions

ECHO

ECHOECHO

LEN()

FASTTRACK()

WAYBIG()

NANOMECH()

ISWAYBIG()

ISNANOMECH()

PARADOX Time Utilities

PARADOX.SLEEP()

PARADOX.UNITIME()

PARADOX.UNIDATE()

BRAINSTORM Memory System

BRAINSTORM.READ()

BRAINSTORM.WRITE()

BRAINSTORM.GET()

JETRAY()

Web Search Feature

AI Query Feature

BREAK Statement

Comments

Complete Built-in Function Table