Harry Potter Language 🪄⚡

Welcome, witches and wizards!
This is the official VS Code extension for the Harry Potter programming language, where you write code as powerful spells.

✨ Features

• Enchanting Syntax Highlighting: All your spells, keywords, and magical constants will light up with distinct colors.
• Automatic Indentation: The editor helps you format your spell blocks correctly.
• Instant Spell Casting: Run your .magic files directly from the editor with a simple click or keyboard shortcut.
• Interactive Terminal: Your spells come to life in the VS Code terminal, perfect for interactive programs.

📖 Spellbook: Incantations & Their Powers

Here’s your quick reference guide to all the magical keywords and their Muggle equivalents ⚡🪄

The Harry Potter Language Documentation 🪄

This documentation serves as a guide for writing spells in the Harry Potter Language. The language is dynamically typed and comes with a VS Code extension for a complete magical experience.

🧾 General

A program is a sequence of statements. Comments start with #. The .magic file extension is the official file type for all spells.

Note: The language is case-sensitive, so Scroll is a keyword, but scroll would be a variable name.

# This is a spell
Scroll myPotion = 10
Revelio(myPotion)

📦 Variables

Variables are created using the Scroll keyword. Once a variable exists, its value can only be updated using the Mending Charm, Reparo. This prevents you from accidentally creating a new variable when you meant to change an existing one.

Scroll points = 100         # Creates the variable 'points'.
Reparo points = points + 50   # Updates the existing variable.

# This would cause an error:
# Scroll points = 200 # Error: 'points' is already defined.

🔤 Types

Numbers (integers and floats), strings, lists, and functions are the core types.

Scroll myPoints = 10
Scroll studentName = "Harry Potter"
Scroll hogwartsHouses = ["Gryffindor", "Hufflepuff", "Ravenclaw", "Slytherin"]

# Magical Constants
Scroll isTrue = Lumos
Scroll isFalse = Nox
Scroll noValue = Obliviate

⚡ Conditionals

The language supports a full conditional chain using Expecto (if), Also (else if), and Patronum (else). The Cast keyword must follow each condition.

For multiple statements within a block, simply place them on new lines. The entire structure must end with Finite.

Scroll housePoints = 75

Expecto housePoints > 100 Cast
    Revelio("Gryffindor wins the House Cup!")
Also housePoints > 50 Cast
    Revelio("A valiant effort! More points are needed.")
    Revelio("Let's add 10 more for good measure!")
Patronum
    Revelio("The hourglasses are nearly empty.")
Finite

🛠️ Built-ins

Printing (Revelio & Murmur)

• Revelio() prints a value and moves to the next line.
• Murmur() prints a value but keeps the cursor on the same line.

User Input ( Accio & AccioNum )

There are two ways to get a number from a user:

• Directly: Use AccioNum() to summon input that is already a Number.
• Typecasting: Use Accio() to get a String, then convert it with the Numeris() spell.

Murmur("Hello, wizard!")
Revelio("What is your favorite spell?")

# Method 1: Direct Number Input
Revelio("Enter your vault number:")
Scroll vaultNumber = AccioNum()
Revelio(vaultNumber * 2)

# Method 2: Typecasting from a String
Revelio("How many points for your house?")
Scroll points = Numeris(Accio())
Revelio(points + 10)

➕ Operators

The language supports standard arithmetic, logical, and comparison operators.

+ - * / ^ //, And Or Not, == != < > <= >=

You can get a specific element from a List or a character from a String using the / operator. Indexing starts at 0.

Scroll score = 100
Scroll bonus = 20
Scroll total = score + bonus
Revelio(total == 120)
# Accessing a list element
Scroll houses = ["Gryffindor", "Slytherin"]
Revelio(houses / 1) # Prints "Slytherin"

# Accessing a string character
Scroll spell = "Alohomora"
Revelio(spell / 0) # Prints "A"

#Integer Division
Revelio(score // 6) # Prints "16"

🔁 Loops

Statements inside Loop...Cast and Repeat...Cast blocks are executed multiple times. Use Evanesco to break the loop and Flipendo to continue.

The entire structure must end with Finite.

For Loop (Repeat)

The Repeat loop is automatic. If the By keyword is not mentioned, the loop will auto-detect whether to increment (By 1) or decrement (By -1). You can use By to specify a custom step value.

# This loop auto-detects it needs to count down.
Repeat i = 3 Until 0 Cast
    Revelio(i + "...")
Finite

# The 'By' keyword counts up by 2, skipping numbers.
Repeat i = 0 Until 10 By 2 Cast
    Revelio("Casting spell " + i)
Finite

While Loop ( Loop )

The Loop spell continues as long as a condition is Lumos (true). You must manually update your counter with Reparo.

Scroll i = 0
Loop i < 3 Cast
    Revelio("Casting spell number: " + i)
    Reparo i = i + 1
Finite

🪄 Functions (Spell)

You can create your own reusable spells (functions) using the Spell keyword. Spells can take arguments and send back a result using OwlPost.

The entire structure must end with Finite.

# A spell to double a number of house points
Spell doublePoints(points)
  OwlPost points * 2
Finite

Scroll gryffindorPoints = 50
Scroll finalPoints = doublePoints(gryffindorPoints)
Revelio("Gryffindor's points have been doubled to:")
Revelio(finalPoints)

Typecasting Spells

You can explicitly convert values between data types.

• Numeris() converts a value to a Number.
• Verbis() converts a value to a String.

Scroll pointsAsString = "250"
Scroll pointsAsNumber = Numeris(pointsAsString)

# Now you can perform math
Reparo pointsAsNumber = pointsAsNumber + 50 
Revelio("Final points: " + Verbis(pointsAsNumber))

✨ List Manipulation

You can modify lists using these powerful charms.

• Pack(list, value): Adds a new value to the end of a list.
• Unpack(list, index): Removes a value from a list at a specific index.
• ReparoAt(list, index, newValue): Updates the value at a specific index in a list.

Scroll ingredients = ["Fluxweed", "Knotgrass"]
Pack(ingredients, "Lacewing flies") # Adds to the end
Revelio(ingredients)

# Let's fix a mistake at index 0
ReparoAt(ingredients, 0, "Boomslang Skin")
Revelio(ingredients)

# We have too much Knotgrass, let's remove it (at index 1)
Unpack(ingredients, 1)
Revelio(ingredients)

🎓 Quick Start: The Sorting Hat Ceremony

Let’s cast a simple, interactive spell where the Sorting Hat asks for your name and places you in a house.

1. Create a new file named sorting.magic.
2. Write your spell:

# The Sorting Hat Ceremony

Revelio("Welcome to Hogwarts, young wizard!")
Revelio("What is your name? ")
Scroll name = Accio()

Revelio("Welcome, " + name + "! The Sorting Hat will now decide your house.")
Revelio("Are you brave? (Answer with 'Lumos' for yes) ")
Scroll trait = Accio()

Expecto trait == "Lumos" Cast
  # You belong with the lions! 🦁
  Revelio(name + ", you belong in... GRYFFINDOR!")
Patronum
  # You belong with the snakes! 🐍
  Revelio(name + ", your ambition shows you belong in... SLYTHERIN!")
Finite

🐍 The Muggle Equivalent (Python)

To understand the logic behind the magic, here is the exact same program in Python:

# The Sorting Hat Ceremony in Python

print("Welcome to Hogwarts, young wizard!")
print("What is your name? ")
name = input()

print("Welcome, " + name + "! The Sorting Hat will now decide your house.")
print("Are you brave? (Answer with 'Lumos' for yes) ")
trait = input()

if trait == "Lumos":
    print(name + ", you belong in... GRYFFINDOR!")
else:
    print(name + ", your ambition shows you belong in... SLYTHERIN!")

3. Cast your spell using one of these methods:
   • Click the Play button (▶️) in the top-right corner of the editor.
   • Use the keyboard shortcut:
     • Mac: Cmd + Alt + R
     • Windows/Linux: Ctrl + Alt + R

📜 Requirements

• Python 3 must be installed and accessible from your system's terminal for the interpreter to work.

📂 Source Code & Contributing

This project is fully open-source. You can view the source code, report issues, or contribute to the project on GitHub.

🔗 View the GitHub Repository

⚖️ License

This project is licensed under the MIT License.