egglang 2.0.0

A basic programming lang written in Python

███████╗ ██████╗  ██████╗
██╔════╝██╔════╝ ██╔════╝
█████╗  ██║  ███╗██║  ███╗
██╔══╝  ██║   ██║██║   ██║
███████╗╚██████╔╝╚██████╔╝
╚══════╝ ╚═════╝  ╚═════╝

A basic interpreted programming language built with Python.

---

📚 Documentation

Everything you need to learn, understand, and contribute to EggLang.

📖 Topic	Description
📘 Language Syntax	Learn the language grammar, keywords, data types, operators, built-in functions, and syntax.
🏗️ Architecture Overview	Explore how EggLang works internally, from lexing and parsing to AST evaluation and runtime execution.
💻 Example Programs	Browse small example programs that demonstrate EggLang's syntax and common language features.
🧪 Testing Guide	Review the project's test suite and the cases used to validate language features.
🤝 Contributing Guide	Learn how to contribute, report issues, and submit improvements.

---

Introduction

A basic programming language with support for common functionality like loops, variables, and data types. It just doesn't have OOP / classes.

---

📦 Installation

EggLang is published on PyPI, so you can install the interpreter with a single command — no advanced setup needed.

Requirements: Python and pip.

pip install egglang

After installation, verify it by running:

egg --v

or

egg --version

Both will print the EGG logo.

Now you can run simple .egg files.

Note: a lot of functionality isn't implemented yet, since most of the effort so far has gone into the interpreter itself. That's why there's no CLI editor to test code directly in the terminal yet.

---

🚀 Quick Start

Once you've installed the interpreter, you can start running EGG code right away.

Create a simple .egg file and write your EGG code in it. Here's a "Hello, World!" example:

show("Hello, World!")

Save the file, open a terminal in that file's directory, and run:

egg run file.egg

Your EGG code will run smoothly.