🐢 slowLang – Slower is Better

🌐 Try it in your browser, no install: https://sebin-gg.github.io/slowlang/

More work by the same author: sebin-gg.vercel.app.

Read the story behind it: I built a programming language that punishes you for typing too fast.

A sarcastic programming language and IDE that throws errors if you type too fast.
Complete with a screaming ASCII turtle, poetic output, and a sassy, minimalistic Python IDE.
Why rush, when your code can feel... meaningful?

🏆 Winner — TinkerHub Useless Projects 2.0 hackathon, built by CS students at College of Engineering Chengannur, Kerala, India.

---

🧠 Basic Details

Team Name: XYZ

Team Members

• Team Lead: Sebin Mathew – College of Engineering Chengannur
• Abin Zachariah Abraham – College of Engineering Chengannur

---

🚫 The Problem (that doesn't exist)

Most programming languages focus on speed, efficiency, and productivity,
leading to stressful coding habits and unrealistic expectations on typing speed.

---

✅ The Solution (that nobody asked for)

slowLang introduces a language and IDE that enforces slow, mindful typing.
Typing too fast results in errors and angry turtle ASCII feedback.
It promotes "patience-oriented programming" with haikus, delays, and sarcastic praise.

---

🔧 Technologies / Components Used

Software:

• Python (for IDE and core logic)
• Tkinter (for the fake IDE UI)

Libraries:

• keyboard
• time
• rich
• os, sys, re, argparse (optional)
• VS Code + Extensions

---

⚙️ Installation

Published packages — the fastest way in:

pip install slowlang     # the real thing, from PyPI
npm i -g slowlang        # the joke CLI, from npm

(turtlelang on npm and PyPI is our official alias — same package, installs slowlang.)

From source instead:

pip install -r requirements.txt

Tkinter comes with Python by default on Windows/macOS. On Linux, install via sudo apt install python3-tk.

---

▶️ How to Run

Try the web demo (easiest):

Open https://sebin-gg.github.io/slowlang/ — the full IDE in your browser, same turtle, same rage, zero install. The desktop and web versions enforce identical rules.

Start the desktop IDE:

python ui-fakeide.py

IDE Features:

• Live typing speed enforcement:
  Type too fast and a turtle rage window will pop up with sarcastic feedback — and count down your 2-second lockout.
• Live WPM readout:
  The status line shows your rolling typing speed next to the turtle's verdict.
• Line numbers:
  A gutter tracks every line, so "near line N" politeness errors point somewhere real.
• Run code like Python:
  Use the "Run (like Python)" button to execute your code directly in the IDE. Rude code (no please() calls) is refused, just like the CLI.
• Load sample:
  One click fills the editor with a polite starter program.
• Gentle streak:
  Consecutive rage-free runs build a streak. Rage resets it. The turtle keeps score.
• Python color scheme and smart indentation:
  The editor highlights Python keywords, strings, comments, and builtins, and auto-indents after colons for blocks.
• Turtle moods:
  Different ASCII turtles for "too fast", "just right", and "too slow" typing.
• Intro popup:
  Shows a summary of features before you start coding.
  • Wisdom: • The compiler will sometimes pop words of wisdom after execution.

Web demo extras (https://sebin-gg.github.io/slowlang/):

• Mood face in the header, rage diary of the session, copy output/haiku buttons.
• Offline mode: no network means the tiny fallback runner steps in and says so.
• Randomness (lazy refusals, moods, haikus, loader jokes) is a feature, drawn from secure sources.

---

🐢 Language & IDE Features

• Python-like syntax: Write and run code just like Python.
• Speed enforcement: Typing too fast triggers sarcastic errors and turtle rage (in a popup window in the IDE).
• Sarcastic feedback: Get sassy remarks and poetic haikus if you break the rules.
• Fake IDE: Includes a Tkinter-based IDE with live feedback, Python color scheme, and smart indentation.
• No PDF export, no .slow interpreter: All code is written and run directly in the IDE for a seamless, fun experience.

---

🧪 How to Test the IDE

1. Start the IDE:

   python ui-fakeide.py
   

2. Type your code in the editor window.

   • If you type too fast, a turtle rage popup will appear and sarcastic feedback will be shown.
   • If you slow down, the turtle will be happy.

3. Run your code:

   • Click "Run (like Python)" to execute your code in the IDE.

To preview the web demo locally: python3 -m http.server --directory demo, then open http://localhost:8000.

---

📝 Example Code

print("Hello, world!")
for i in range(3):
    print(i)
print("Done!")

---

🖼️ Screenshots

Fake IDE window with turtle ASCII reacting to fast typing.

Sarcastic error: "Whoa there, Shakespeare. Try again... slower."

"Compiled" poetic output of slow-written code.

This is the beginning of the README. Read the rest at the original. Read the full README ↗