nova-pl 1.0.0

A simple, modern, statically-typed programming language implemented in Python.

NOVA

A simple, modern, statically-typed programming language implemented in Python.

Features • Implementation • Documentation • Installation • Try NOVA • Website

NOVA is a statically-typed programming language built entirely from scratch using a handwritten lexer, recursive-descent parser, abstract syntax tree (AST), module system, and tree-walk interpreter.

The project demonstrates the complete implementation of a programming language—from lexical analysis to runtime execution—while remaining approachable enough to study, extend, and experiment with.

---

✨ Features

• Modern statically-typed language
• Clean and readable syntax
• Rich primitive and collection types
• Runtime type checking
• Schema-based structured data
• User-defined functions
• Recursion
• Module system
• Import / Export support
• Standard Library
• Built-in functions
• Command-line interface
• Comprehensive documentation
• Hundreds of runnable examples

---

⚙️ Implemented Components

• Handwritten Lexer
• Recursive-Descent Parser
• Abstract Syntax Tree (AST)
• Runtime Type System
• Tree-Walk Interpreter
• Module Loader
• Module Resolver
• Circular Import Detection
• Standard Library
• Built-in Function System
• CLI
• Source-aware Diagnostic System

---

🚀 Example

import math
import stats
import random

User: M = {
    name: S,
    scores: [N]
}

student: User = {
    name = "Varun",
    scores = [
        92,
        87,
        95
    ]
}

print(student.name)

print(
    "Average:",
    stats.mean(student.scores)
)

print(
    "Square:",
    math.pow(5, 2)
)

print(
    "Lucky Number:",
    random.randint(
        1,
        10
    )
)

Output

Varun
Average: 91.33333333333333
Square: 25
Lucky Number: 7

---

🏗 Architecture

             Source Code
                  │
                  ▼
          Handwritten Lexer
                  │
                  ▼
     Recursive-Descent Parser
                  │
                  ▼
      Abstract Syntax Tree
                  │
                  ▼
        Module Resolution
                  │
                  ▼
      Tree-Walk Interpreter
                  │
                  ▼
         Runtime Values

---

📚 Documentation

The repository contains complete language documentation covering every released version.

Language

Documentation	Description
Language Specification	Complete language reference
Release Notes	Detailed release history
Changelog	Version overview

---

Standard Library

Module	Documentation
Math	math.md
Array	array.md
Random	random.md
Statistics	stats.md
Time	time.md

Complete Reference

• Standard Library Index

---

Built-in Functions

Documentation

• Built-in Function Index

Available Categories

• Arrays
• Strings
• Input
• Type Conversion

---

Examples

Every language release includes runnable demonstrations and error cases.

examples/

├── v0.1
├── v0.2
├── v0.3
├── v0.4
├── v0.5
├── v0.6
├── v0.7
├── v0.8
├── v0.9
└── v1.0

---

📦 Installation

Requirements

• Python >= 3.13

Install from PyPI

Install the latest stable release.

pip install nova-lang

Verify the installation.

nova --version

Run a NOVA program.

nova hello.nova

---

Build from Source

Clone the repository.

git clone https://github.com/varundubey-dev/nova.git

cd nova

Install the development version.

pip install .

Or install in editable mode while contributing to NOVA.

pip install -e .

---

🏛 Repository Layout

nova/
│
├── lexer/
├── parser/
├── ast/
├── interpreter/
├── modules/
├── stdlibs/
├── api.py
└── cli.py

docs/
├── syntax/
├── stdlib/
├── builtins/
└── releases/

examples/
├── v0.1
├── ...
└── v1.0

---

📈 Evolution

v0.1 ── Core Language
          │
          ▼
v0.2 ── Primitive Type System
          │
          ▼
v0.3 ── Arrays
          │
          ▼
v0.4 ── Schema Maps
          │
          ▼
v0.5 ── Control Flow
          │
          ├── v0.5.1  Multi-expression print()
          ▼
v0.6 ── Iteration & Loops
          │
          ├── v0.6.1  break / continue
          ▼
v0.7 ── User-defined Functions
          │
          ▼
v0.8 ── Built-in Functions
          │
          ▼
v0.9 ── Module System
          │
          ▼
v1.0 ── Standard Library

---

🌐 Official Website

The NOVA website provides everything needed to learn, explore, and experiment with the language directly in your browser.

Resource	Link	Description
🏠 Home	https://nova.varundubey.dev	Project homepage
🚀 Playground	https://nova.varundubey.dev/playground	Run NOVA programs online
📖 Documentation	https://nova.varundubey.dev/docs	Complete language documentation
📚 Standard Library	https://nova.varundubey.dev/docs/stdlib	Standard Library reference
🔧 Built-in Functions	https://nova.varundubey.dev/docs/builtins	Built-in function reference
💡 Examples	https://nova.varundubey.dev/examples	Interactive examples
📰 Release Notes	https://nova.varundubey.dev/releases	Complete release history

---

💻 Try NOVA

Run Locally

git clone https://github.com/varundubey-dev/nova.git

cd nova

pip install .

nova hello.nova

Run in Your Browser

Visit the NOVA Playground.

https://nova.varundubey.dev/playground

No installation required.

---

⭐ If you found NOVA interesting, consider starring the repository!

Built from scratch in Python.

Made by Varun Dubey