phase

KO | EN

gitlite — search

#hacktoberfest #ai #golang #go #android #nodejs #macos #windows #awesome #kubernetes #vue #security #mcp #open-source

(★ 29)

A statically-typed bytecode-interpreted programming language in C with zero dependencies.

phase Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Phase

![GitHub Tag](https://img.shields.io/github/v/tag/williamalexakis/phase)
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/williamalexakis/phase/ci.yml)
[![License](https://img.shields.io/badge/license-MIT-green)
](LICENSE)

A statically-typed bytecode-interpreted programming language in C with zero dependencies.

[Bytecode Interpretation From Scratch in C](https://github.com/williamalexakis/writings/blob/main/bytecode-interpretation-from-scratch-in-c.md)

[Chunk-Based File Reading in C](https://github.com/williamalexakis/writings/blob/main/chunk-based-file-reading-in-c.md)

## Building

```bash
git clone https://github.com/williamalexakis/phase.git
cd phase
mkdir build
cd build
cmake ..
cmake --build .
```

## Syntax

**Hello World**
```
entry {
    out("Hello world!")
}
```

**Functions**
```
func add(num1: int, num2: int): void {
    out(num1 + num2)
}

entry {
    add(5, 5)
}
```

**Loops**
```
entry {
    let num: int = 0
    
    while num < 11 {
        out(num)
        num += 1
    }
}
```

[More examples](examples/)

## Architecture

**INPUT → Lexer → Parser → Type Checker → Bytecode Generator → Virtual Machine → OUTPUT**

Programs are compiled into hexadecimal bytecode and executed by a stack-based VM supporting 25 opcodes. For example, **Hello World** translates to:
```
0x0000  →  00 00 00  →  OP_PUSH_CONST 0
0x0003  →  01        →  OP_PRINT
0x0004  →  18        →  OP_HALT
```

## Usage

- `phase --help` — list commands and flags
- `phase <file.phase> --tokens` — print the token stream
- `phase <file.phase> --ast` — print the AST
- `phase <file.phase> --loud` — print a success message on exit

phase

phase Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

phase

phase Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README