Kyvera

Code in your language. Think in your style. 🤏🏼

---

📘 Documentation

1. Introduction

Kyvera is a lightweight programming language inspired by Python. It is built with a custom interpreter written in Python and follows a Python-like structure while introducing its own unique features.

Kyvera’s main feature is multi-language support, currently supporting Japanese, German, and Italian, with more languages planned for future releases.

The goal of Kyvera is to provide a simple, flexible, and extensible language that can grow over time.

---

2. Installation

Requirements

• Python 3.x installed on your system

Setup

Clone the repository:

git clone https://github.com/Kyvera/kyvera.git
cd kyvera

---

3. Getting Started

To run a .kyv file:

python run.py filename.kyv

Example:

python run.py hello_de.kyv

---

4. Syntax Overview

4.1 Language declaration

To use Kyvera, you must declare the language at the top of each .kyv file.

Use this to declare the language:

use <language_name>

Example:

use german

Only that language’s keywords can be used in the file.

---

4.2 Keywords

Kyvera currently supports basic keywords and built-in commands.

🇯🇵 Japanese:

• hensuu - variable declaration
• shutsuryoku - print statement
• moshi - if statement
• soredehanai - else statement

🇩🇪 German:

• zahl - variable declaration
• ausgabe - print statement
• wenn - if statement
• sonst - else statement

🇮🇹 Italian:

• variabile - variable declaration
• stampa - print statement
• se - if statement
• altrimenti - else statement

---

4.3 Variables

Variables use a simple assignment style similar to Python, but with a different operator.

Kyvera uses -> instead of =.

Example:

hensuu sai -> 18 

---

4.4 Functions and Control Flow

Currently, Kyvera supports basic if and else statements in language mode.
More advanced control flow features (like loops) will be added in future updates.

---

5. Built-in Functions

Kyvera currently includes basic built-in functionality such as the shutsuryoku statement (in English, it's the print function).
More built-in functions will be added over time.

---

6. Examples

file.kyv

use japanese
hensuu sai -> 18
moshi sai > 10:
    shutsuryoku(1)
soredehanai:
    shutsuryoku(0)

Here, you declare a variable sai and assign 18 to it.
Since strings and Boolean statements haven't been implemented, you can use numbers as placeholder for return values.
However, if you directly compare numbers in a statement, you'll get a Boolean return value.
Example:

use japanese
shutsuryoku 5 > 1

This would return True. Chain comparison is also supported.

Note: you can compare two values without using parentheses

Like in the example above. To do a chain comparison, you must encase values in parentheses as such below:

use japanese
shutsuryoku(5 > 2 > 1)

More example programs will be added as more features are implemented.

---

7. Future Improvements

Planned features include:

• Advanced conditional features
• Function definitions
• Loops
• More built-in functions
• Expanded multi-language support
• Improved error handling
• Expanded string support (currently Kyvera supports minimal string functions)

---

📝 Note

This README will be updated as Kyvera evolves and new features are added.
Thank you for using Kyvera.

If you find this project interesting, consider starring the repository.

Ciao 😉