ThyLang is a interpreted and case sensitive programming language inspired by Shakespearean/old English. This language allows you to code in a way that feels poetic, ancient, and deep.
ThyLang is currently in beta and has not been thoroughly tested! You may encounter bugs, unexpected behavior, or incomplete features while using this language. This project was built primarily for fun and creativity rather than functionality. This documentation assumes you already have an understanding or programming concepts likle loops, data types, variables, etc. This is a documentation, not a programming tutorial. Please keep this in mind when experimenting with ThyLang!
- Getting Started
- Data Types
- Variables
- Operators
- Control Flow
- Functions
- Built-in Functions
- Lists
- Comments
- Error Messages
- Examples
- Contributing
To run ThyLang, execute Main.py and you'll see the following interactive prompt in your terminal:
ThyLang >>>
Type your ThyLang code and press Enter to execute the code. You can type cease to exit the interpreter.
ThyLang supports several fundamental data types such as:
- Integers:
42,-17,0 - Floats:
3.14,-2.5,0.0
- Enclosed in double quotes:
"Hello, fair maiden!" - Supported escape characters:
\n- newline\t- tab\\- backslash
- Ordered collections:
[1, 2, 3] - Lists can contain mixed types:
[42, "hello", 3.14] - ThyLang also supports nested lists like:
[[1, 2], [3, 4]]
sooth- true (1)falsehood- false (0)
Use the hath keyword to assign values to variables:
hath x = 42
hath name = "Sir Lancelot"
hath scores = [10, 20, 30]
Simply use the variable name:
hath x = 10
hath y = x + 5
printeth(y) # Outputs: 15
+- Addition-- Subtraction*- Multiplication/- Division//- Floor division^- Exponentiation
==- Equal to!=- Not equal to>- Greater than<- Less than>=- Greater than or equal to<=- Less than or equal to
and- Logical ANDor- Logical ORnot- Logical NOT
+- Positive (unary plus)-- Negative (unary minus)
The syntax for a if-else statement in ThyLang is as follows:
shouldst condition so expression
For else-if and else:
shouldst x > 10 so "Large number" mayhaps x > 5 so "Medium number" naughtwise "Small number"
Keep in mind that as of now, ThyLang does not support multi line statements and is case sensitive (shouldst ≠ Shouldst).
The syntax for a while loop in ThyLang is as follows:
whilst condition do (expression)
Your expressions can be separated by using commas ","
Example:
hath i = 0 (you have to declare all variables, including your iterator before the loop)
whilst i < 5 do ( hath i = i + 1, printeth(i))
each iterator amongst start_value to end_value do (expression)
Example:
each i amongst 1 to 5 do (printeth(i))
Note: For loops automatically handle ascending and descending ranges, for loops also support mutiple expression each separated by commas.
WARNING - As of now, functions can not accept more than one expression, but can accept more than one parameters separated by commas!
craft function_name(parameter1, parameter2) : expression
Example:
craft add_numbers(a, b) : a + b
craft multiply_lists(list, num): list * num
craft greet(name): printeth("Hello, " + name)
You can even assign functions to a variable, and that new variable will work the same way as your original function did:
craft function_name(parameter1, parameter2) : expression
hath new_func = function name # make sure to not use parentheses otherwise you would be calling the function instead of assigning it!
Example:
craft add_numbers(a, b) : a + b
hath new_add = add_numbers
new_add(5, 6) # output -> 11
function_name(argument1, argument2)
Example:
hath result = add_numbers(5, 3)
multiply_lists([1, 2, 3], 8)
greet("Arthur")
ThyLang provides several built-in functions which are listed as follows:
printeth(value)- Print a value to the terminalrecieve_sentence()- Get string input from userrecieve_number()- Get numeric input from user
These functions like any other in ThyLang return 1 if true and 0 if false
beith_whole(value)- Check if value is a numberbeith_tongue(value)- Check if value is a stringbeith_listeth(value)- Check if value is a list
includeth(list, value)- Append value to listbanish(list, index)- Remove and return element at indexlength(value)- Get length of string or list
printeth("Enter thy name:")
hath name = recieve_sentence()
printeth("Greetings, " + name + "!")
hath numbers = [1, 2, 3]
includeth(numbers, 4) # numbers becomes [1, 2, 3, 4]
hath removed = banish(numbers, 0) # removes first element
printeth(length(numbers)) # prints length
hath empty_list = []
hath numbers = [1, 2, 3, 4, 5]
hath mixed = [42, "hello", 3.14, sooth]
NOTE - As of now, ThyLang does not support list index accessing, so you can not do something like multiplying the 0th element (or any other element) of a list by any number. You can use the banish function to pop an index from a list which is 0 indexed.
Lists in ThyLang support arithmetic operations that apply to all elements of the list:
hath numbers = [1, 2, 3]
hath doubled = numbers * 2 # [2, 4, 6]
hath increased = numbers + 1 # [2, 3, 4]
hath fruits = ["apple", "banana"]
includeth(fruits, "cherry") # Add element
hath first = banish(fruits, 0) # Remove first element
hath count = length(fruits) # Get list length
Use # to create comments. Everything after # on a line is ignored:
# This is a comment
hath x = 42 # This is also a comment
ThyLang provides error messages in classical English style, while these messages might be cryptic to understand for some users, please remember that this language is built more from a fun perspective rather than a functionality one. Some error messages are listed below:
- Undefined Variable: "Verily, no variable of 'name' is inscribed in these sacred scripts."
- Division by Zero: "Thou dared divide by naught."
- Invalid Operation: "Hark! Thou hast attempted an operation most grievous and forbidden!"
- Illegal Character: "Expected '=', but thy script delivereth none."
printeth("Enter first number:")
hath a = recieve_number()
printeth("Enter second number:")
hath b = recieve_number()
printeth("Sum: " + (a + b))
printeth("Product: " + (a * b))
craft factorial(n) : shouldst n <= 1 so 1 naughtwise n * factorial(n - 1)
hath result = factorial(5)
printeth("5! = " + result)
hath numbers = [1, 2, 3, 4, 5]
hath sum = 0
hath i = 0
each i amongst 0 to length(numbers) - 1 do (hath sum = sum + banish(numbers, 0))
printeth("Sum: " + sum)
hath secret = 42
hath guess = 0
whilst guess != secret do (printeth("Guess the number:"), hath guess = recieve_number(), shouldst guess > secret so printeth("Too high!") mayhaps guess < secret so printeth("Too low!") naughtwise printeth("Thou hast guessed correctly!"))
hath greeting = "Hello"
hath name = "World"
hath message = greeting + ", " + name + "!"
printeth(message)
printeth("Message length: " + length(message))
shouldst beith_tongue(message) so printeth("'Tis a string indeed!")
I appreciate anyone who takes the time to contribute to ThyLang! Whether you're fixing bugs, adding new features, improving documentation, or just experimenting with the language, your involvement means a lot.
If you encounter any bugs or have ideas for improvements, please feel free to:
Submit bug reports Create pull requests with fixes or enhancements Suggest new features or language constructs Improve the documentation Share your ThyLang projects!
Remember, ThyLang is a project built for fun and creative expression, so don't hesitate to get creative with your contributions. I hope you love the documentation as well as ThyLang!