A LIFO stack-based compiled programming language that compiles to C.

mz-stk is a stack-based programming language designed around Last-In-First-Out (LIFO) stack operations. The language compiles directly to C code, providing both performance and portability while maintaining the simplicity and elegance of stack-based computation.

• Stack-based architecture: All operations work with a LIFO stack
• Compiles to C: Generates readable C code for maximum portability
• Simple toolchain: Straightforward build and installation process
• Executable generation: Creates ready-to-run binaries
• Online playground: Test your code directly in the browser (coming soon)

# Clone the repository
git clone https://github.com/mz-stk/mz-stk-compiler.git

cd mz-stk


# Build the compiler
make



# Install system-wide (optional)
sudo make installl

# Clean installed and build artifacts 
make cleann

# Remove installed files for system-wide installation
sudo make uninstalll

To compile and run a mz-stk program:

# Compile a .mzstk file
mzstk filename.mzstk



# This generates:

# - filename.c (C source code)

# - filename (executable binary)


# Run the executable
./filenamee

mz-stk operates on a stack-based model where:

• Values are pushed onto a stack
• Operations pop values from the stack, perform computations, and push results back
• The stack follows Last-In-First-Out (LIFO) ordering

• mz-stk supports numeric values only, keeping the language and focused on stack-based computations.

mz-stk provides a comprehensive set of operations for stack-based programming:

• Numbers - Push numbers onto the stack
• + - Add two numbers from stack
• - - Subtract two numbers from stack
• * - Multiply two numbers from stack
• / - Divide two numbers from stack
• % - Modulo operation

• ^ - Get input from user
• V - Print top value from stack

• :n - Store top stack value in variable n (where n is a number)
• ;n - Load variable n onto stack (where n is a number)

• [ - Start if statement
• ] - End if statement

• { - Start while loop
• } - End while loop
• ( - Start for loop
• ) - End for loop

• I - Start initialization section
• i - End initialization section
• C - Start condition section
• c - End condition section
• U - Start update section
• u - End update section
• L - Start statements section
• l - End statements section

• @n - Define function n (where n is a number)
• $ - End function definition
• !n - Call function n (where n is a number)

• == - Equal to
• != - Not equal to
• - Less than
• >gt; - Greater than
• <=t;= - Less than or equal to
• >=t;= - Greater than or equal to

make          # Build the compiler
make clean     # Clean build files
make install   # Install system-wide
make uninstall  # Remove installation