SpudLang 🥔 — by DS & Jay

main.spud saved ✓ · Ln 1, Col 1

terminal idle

🥔 How SpudLang Works

A tiny language with sharp edges. Read once, never peel wrong again.

SpudLang reads top-to-bottom. Nothing executes until it hits run spud — that's the ignition. It must be the very last line of the file.

mash "Hello, potato!"
run spud

Plant with spud. Reassign with just the name — but only if it already exists.

spud age = 25
age = 26          # ok, age exists
score = 10         # ERROR: never planted

Blocks { } have their own scope. Variables don't leak out.

mash prints. ask "prompt" waits for the user to type — always returns text, even if they typed a number.

spud name = ask "What's your name? "
mash "Hello, " + name

spud n = num(ask "Age? ")   # convert to number

ish age >= 18 {
    mash "Can vote."
} nope ish age >= 13 {
    mash "Teenager."
} nope {
    mash "Kid."
}

loop i from 1 to 10 {
    ish i % 2 == 0 { sprout }
    mash i
}

recipe add(a, b) {
    serve a + b
}

mash add(2, 3)   # 5

Recipes without serve return nada.

Only nah, nada, 0, and "" are false. Everything else is true.

Every program ends with run spud.
Variables must be planted with spud before use.
Blocks { } have their own scope.
+ works on two numbers OR two texts. Mixing is an error — use str() or num().
peel / sprout only inside loops.
Numbers and text are never equal. 1 == "1" is false.

SpudLang v0.3 · lovingly mashed by DS & Jay 🥔