prose-lang 1.0.0

A programming language that reads like plain English. Zero syntax friction, native Python speeds.

📖 Prose

Programming in plain English. No brackets, no semicolons, no cryptic symbols.

---

Prose is a programming language designed to read like natural language. It removes the syntax barriers that stop beginners from learning to code, while packing enough power to build desktop apps, work with databases, and crunch numbers at Python speeds.

Note: This is actual, working code.
Let sentence be "the quick brown fox".
Let words be split sentence by " ".

For each word in words do the following.
    If word contains "fox" then do the following.
        Say "Found it!".
    End if.
End for.

---

⚡ Why Prose?

1. Zero Syntax Friction

Most beginners fail because they miss a semicolon or forget a closing bracket. Prose has zero symbolic syntax. Every instruction is a sentence that ends with a full stop " .".

2. Two Gears: Simple and Blazing Fast

Prose comes with two ways to run your code:

• Interpreter (prose.py): Tree-walking interpreter giving instant, friendly feedback and excellent error messages. Great for beginners.
• Transpiler (prose.py build): Compiles your Prose code directly into native Python script, unleashing the full speed of the CPython Engine.

3. Serious Power Included

Prose isn't a toy. Out of the box, it supports:

• Native desktop window GUIs
• An embedded SQLite database
• File I/O
• HTTP networking
• Object-Oriented Programming (Classes & Inheritance)

---

🏎️ Performance Benchmarks

When using the Prose Transpiler (build mode), your code runs at native Python speed. Here is how Prose (Transpiled) holds up against Python 3 and Node.js for fundamental operations.

Test	Python 3	Node.js	Prose (Interpreter)	Prose (Transpiled)
Fibonacci (Pure recursion)	0.113s	0.051s	1.915s	0.076s
Prime Sieve (Nested loops)	0.042s	0.045s	28.070s	0.678s
Bubble Sort (Swap ops)	0.080s	0.049s	0.179s	0.039s
Word Frequency (Dict ops)	0.038s	0.045s	0.098s	0.068s

Note: The ~0.03s-0.07s floor on these tests represents process startup overhead. Prose Transpiled is generating 1:1 pure Python source code.

---

🚀 Getting Started

No npm install, no pip install. You just need Python 3.9+ on your system.

git clone https://github.com/eres45/Prose.git
cd Prose

Run an example:

python prose.py samples/01_hello.prose

---

� Documentation & Guides

We've written a complete, beginner-friendly 5-part guide to take you from printing "Hello" to building database-backed GUI apps.

1. Part 1: Getting Started — Variables, running code
2. Part 2: Variables & Logic — Math, conditions, strings
3. Part 3: Loops & Lists — Iteration and filtering
4. Part 4: Functions & Files — Reuse, HTTP, File I/O
5. Part 5: Advanced Features — GUIs, Databases, Classes, Async

---

🛠️ The VS Code Extension

Prose comes with a native syntax highlighter for VS Code.

1. Copy the vscode-extension folder to your VS Code extensions directory (~/.vscode/extensions/ on Mac/Linux or %USERPROFILE%\.vscode\extensions\ on Windows).
2. Restart VS Code.
3. Enjoy full syntax highlighting for all .prose files!

---

🤝 Contributing

Prose is open-source. Whether you're adding new standard library modules or improving the parser, pull requests are incredibly welcome!