goatlang 0.0.1

A language for goated people with no purpose.

🐐 GLC (GoatLang Compiler)

GLC is a toy programming language that transpiles to C and then compiles into native executables. It’s designed for learning about compilers, transpilers, and language design while keeping things simple.

---

✨ Features

• Variables: int, float, bool, string
• Arithmetic: +, -, *, /
• Comparisons: <, >, ==, !=
• Print statements: print(expr)
• Conditionals: if / else
• Loops: while
• Basic string concatenation (msg + "something")

---

📦 Installation

Clone the repo and install it locally in editable mode:

git clone https://github.com/<your-username>/glc.git
cd glc
pip install -e .

This installs the glc command into your environment.

---

▶️ Usage

Compile & Run a program

Create a file hello.g:

fn main() {
    string msg = "Hello, GoatLang!"
    print(msg)
}

Compile and run:

glc hello.g

Output:

Hello, GoatLang!

Another Example (loop, conditionals, math)

fn main() {
    int x = 42
    float y = 3.14
    bool flag = true

    print(x)
    print(y)
    print(flag)

    int sum = x + 10
    float product = y * 2.0
    print(sum)
    print(product)

    if sum > 50 {
        print("Sum is large!")
    } else {
        print("Sum is small!")
    }

    int counter = 0
    while counter < 5 {
        print(counter)
        counter = counter + 1
    }
}

---

📂 Project Structure

glc/
├── glc/             # Source code
│   ├── lexer.py     # Tokenizer
│   ├── parser.py    # Parser → AST
│   ├── t2c.py       # AST → C transpiler
│   └── main.py      # CLI entry point
├── examples/        # Example GoatLang programs
├── pyproject.toml   # Build config
└── README.md

---

⚡ How It Works

1. Lexing – source code → tokens
2. Parsing – tokens → AST (abstract syntax tree)
3. Transpiling – AST → C code
4. Compiling – C → native executable (via GCC/clang)
5. Running – GLC runs the binary automatically

---

🛠 Requirements

• Python ≥ 3.8
• GCC or Clang (for compiling generated C code)

---

🚧 Limitations

• No user-defined functions yet (only fn main)
• String concatenation is still basic (uses buffers + strcpy/strcat)
• Error messages are primitive
• No standard library (beyond print)

---

📜 License

MIT License © 2025 Naren