🚀 Szybki start

Ten przewodnik pomoże Ci uruchomić pierwszy skrypt KitsuneScript w ciągu kilku minut.

Podstawowe użycie w Kotlinie

import rip.nerd.kitsunescript.api.KitsuneScriptEngine
import kotlinx.coroutines.runBlocking

fun main() = runBlocking {
    // 1. Utwórz silnik
    val engine = KitsuneScriptEngine()

    // 2. Uruchom prosty skrypt
    val result = engine.eval("""
        let message = "Witaj ze skryptu!";
        print(message);
        42;  // Zwracana wartość
    """)

    println("Wynik: $result")  // Wynik: 42.0
}
        

Rejestracja funkcji hostowych

Możesz rozszerzyć skrypt o własne funkcje:

import rip.nerd.kitsunescript.runtime.HostFunction
import rip.nerd.kitsunescript.runtime.Value

val engine = KitsuneScriptEngine()

// Zarejestruj funkcję "log"
engine.register("log", HostFunction { args, _ ->
    println(args.joinToString(" ") { it.asString() })
    Value.Null
})

// Teraz można użyć w skrypcie
engine.eval("""
    log("To", "jest", "log!");
""")
        

Użycie w Android Activity

class MainActivity : AppCompatActivity() {
    private lateinit var engine: KitsuneScriptEngine

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Inicjalizacja silnika
        engine = KitsuneScriptEngine()

        // Uruchom skrypt asynchronicznie
        lifecycleScope.launch {
            val result = engine.evalSuspend("""
                let suma = 0;
                for (i in 1..100) {
                    suma = suma + i;
                }
                suma;
            """)

            // Aktualizuj UI
            binding.resultText.text = "Suma: $result"
        }
    }
}
        

Ładowanie modułów

Moduły są ładowane na żądanie przy użyciu dyrektywy use:

// W skrypcie
use "math";
use "string";

let result = sqrt(16);  // z modułu math
let words = split("a,b,c", ",");  // z modułu string

print(result);  // 4
print(words);   // ["a", "b", "c"]
        

Przekazywanie wartości do skryptu

val engine = KitsuneScriptEngine()

// Ustaw zmienne globalne przed uruchomieniem
engine.setGlobal("userName", "Jan")
engine.setGlobal("userAge", 25)

engine.eval("""
    print("Witaj " + userName + "!");
    print("Masz " + userAge + " lat");
""")
        

Odbieranie wartości ze skryptu

val engine = KitsuneScriptEngine()

val result = engine.eval("""
    let user = {
        name: "Alice",
        age: 30,
        hobbies: ["coding", "gaming"]
    };
    user;  // Zwróć mapę
""")

// result jest typu Value
when (result) {
    is Value.MapVal -> {
        val name = result.map["name"]?.asString()
        println("Imię: $name")
    }
}
        

Prosty przykład: Kalkulator

val engine = KitsuneScriptEngine()

// Rejestruj funkcję do pobierania inputu
engine.register("input", HostFunction { args, _ ->
    print(args.firstOrNull()?.asString() ?: "")
    Value.Str(readLine() ?: "")
})

engine.eval("""
    use "math";

    fn calculate(a, b, op) {
        return when op {
            "+" -> a + b,
            "-" -> a - b,
            "*" -> a * b,
            "/" -> a / b,
            "^" -> pow(a, b),
            _ -> "Nieznana operacja"
        };
    }

    let a = toNumber(input("Podaj a: "));
    let b = toNumber(input("Podaj b: "));
    let op = input("Operacja (+,-,*,/,^): ");

    print("Wynik: " + calculate(a, b, op));
""")
        

💡 Wskazówka

Moduł core jest zawsze załadowany i zawiera podstawowe funkcje jak print, typeOf, size, itp.

Co dalej?

Zmienne i stałe - naucz się deklarować zmienne
Typy danych - poznaj dostępne typy
Funkcje - twórz własne funkcje
Klasy - programowanie obiektowe
Moduły stdlib - pełna biblioteka standardowa