ZELYRA
ZELYRA / GLOSSAR
Die Fachbegriffe
hinter der Sprache.
Präzise Erklärungen zu 60 zentralen Konzepten: von Unveränderlichkeit und Verträgen über Optionen und Schemas bis zu Webkomponenten und Tooling. Mit Codebeispielen und Direktlinks in das Handbuch.
60 Begriffe
8 Themenbereiche
🔍 Echtzeit-Suche [/]
📖 Handbuch-Querverweise
- Argon2 (Passwort-Hashing) Web, UI & Auth
- Moderner, speicherharter Algorithmus zur sicheren Speicherung von Passwörtern. In Zelyras Auth-System standardmäßig erzwungen.
- Array (Typ[]) Sammlungen & Daten
- Geordnete Liste gleichartiger Werte. Zelyra stellt dafür Operationen wie `len()`, `append()`, `first()`, `last()` und `contains()` bereit.
- assert (Test-Zusicherung) Compiler, CLI & QA
- Prüft eine Bedingung und meldet einen Fehler, wenn sie falsch ist. Projektbezogene Assertions können in einer ausführbaren `.zyl`-Datei mit `zelyra run` ausgeführt werden; ein separater Test-Unterbefehl ist nicht dokumentiert.
- AST (Abstract Syntax Tree) Compiler, CLI & QA
- Der hierarchische Syntaxbaum, den der Parser aus dem Quelltext aufbaut. Compilerphasen wie Namensauflösung und Typprüfung arbeiten auf seiner strukturierten Repräsentation weiter.
- Aufzählungstyp (Enum / Sum Type) Typsystem & Sicherheit
- Ein Aufzählungstyp beschreibt eine feste Menge disjunkter Varianten. Benutzerdefinierte `enum`-Deklarationen gehören derzeit nicht zum dokumentierten Zelyra-Sprachumfang; das Konzeptmuster ist keine ausführbare Zelyra-Syntax.
- Authentifizierung (auth) Web, UI & Auth
- Natives Sprachkonstrukt zur Konfiguration von Benutzer-Login, Sitzungen und Rollenrechten ohne externe Authentifizierungs-Frameworks.
- Block & Scope Grundlagen & Syntax
- Lexikalischer Gültigkeitsbereich von Bezeichnern, eingefasst durch geschweifte Klammern `{ ... }`. Innerhalb des Blocks deklarierte Namen sind an diesen Bereich gebunden.
- Capability (Fähigkeit) Verträge & Capabilities
- Ausdrückliche Berechtigung (`uses FileSystem`, `uses Database`), ohne die eine Funktion keine externen Seiteneffekte ausführen darf. Verhindert unbefugte Systemzugriffe.
- CRUD-Ressource (crud) Datenbank & Persistenz
- Create, Read, Update, Delete: Deklarative Verknüpfung einer Tabelle mit den 4 Grundoperationen. Generiert Listen-, Detail- und Editiermasken ohne Boilerplate.
- CSRF-Schutz Web, UI & Auth
- Automatischer kryptografischer Token-Schutz gegen Cross-Site-Request-Forgery bei allen statusverändernden HTTP-Anfragen (POST, PUT, DELETE).
- Datensatz (Record / Struct) Typsystem & Sicherheit
- Zusammenfassung mehrerer benannter, typisierter Felder zu einer kohärenten Datenstruktur mit Konstruktoren und Destrukturierung.
- Datentyp (Type) Typsystem & Sicherheit
- Eine exakte Spezifikation zulässiger Werte und Operationen. Zelyra unterscheidet skalare Typen (Int, Float, Bool, String, Decimal, Id) und zusammengesetzte Typen.
- Design by Contract Verträge & Capabilities
- Entwurfsmethode zur formalen Absicherung von Software: Jede Funktion deklariert präzise Vorbedingungen (`requires`) und Nachbedingungen (`ensures`).
- Drei-Schichten-Architektur Compiler, CLI & QA
- Empfohlenes Zelyra-Architekturmuster: Saubere Trennung in Präsentationsschicht (Web/HTML), reine Geschäftslogik (pure functions) und Persistenz (Tabellen & Schema).
- for .. in Iteration Sammlungen & Daten
- Schleifenform, die nacheinander über Elemente einer Sammlung läuft. Sie erspart manuelle Indexverwaltung.
- Formular & Validierung (form) Web, UI & Auth
- Typisierte Eingabemaske mit synchronisierten Validierungsregeln für Server und Client. Validierungsfehler werden strukturiert an das UI zurückgemeldet.
- Fremdschlüssel (fk) Datenbank & Persistenz
- Deklarative Beziehungsdefinition zwischen Tabellen. Erzwingt referentielle Integrität und unterstützt Kaskadierungsregeln (`on_delete`).
- Funktion (fn) Grundlagen & Syntax
- Eine benannte Operation mit expliziten Parametertypen und einem festen Rückgabetyp. Funktionen sind die primären Bausteine jeder Zelyra-Anwendung.
- json_encode & json_decode System, I/O & Concurrency
- Typsichere Umwandlung von Datenstrukturen in JSON und Rückwandlung in typisierte Records (`Result<T, JsonError>`). Schließt Parsing-Crashes aus.
- KI-Nativität (AI-Native) Compiler, CLI & QA
- Sprach- und Werkzeugmerkmale wie strukturierte Diagnosen, Verträge und Typed Holes können KI-gestützte Arbeit unterstützen. Sie garantieren weder fehlerfreien Code noch ersetzen sie menschliche Prüfung.
- Komponente (component) Web, UI & Auth
- Wiederverwendbarer HTML-Baustein mit deklarierten Props, Slots und kontextabhängigem XSS-Schutz. HTML wird als erstklassiger Sprachbestandteil gerendert.
- LSP (Language Server Protocol) Compiler, CLI & QA
- Das Language Server Protocol standardisiert die Verbindung zwischen Programmiersprache und Editor. Die aktuelle CLI-Referenz dokumentiert `zelyra editor` für Studio, aber keinen separaten `zelyra lsp`-Unterbefehl.
- Migration (db plan & apply) Datenbank & Persistenz
- Kontrollierte Schemaänderung: `zelyra db plan` zeigt den Unterschied zwischen Quellmodell und Datenbank; `zelyra db apply` übernimmt den geprüften Plan. Prüfe vorher mögliche Auswirkungen, denn ein abgebrochener DDL-Schritt kann einen teilweise geänderten Zustand hinterlassen.
- mutable (Veränderbarkeit) Grundlagen & Syntax
- Schlüsselwort zur bewussten Deklaration veränderlicher Variablen. Signalisiert Entwicklern und Compiler sofort, dass sich dieser Zustand im Programmverlauf ändern wird.
- Nachbedingung (ensures & result) Verträge & Capabilities
- Vertragliche Garantie für das Berechnungsergebnis. Das Schlüsselwort `result` bezieht sich auf den zurückgegebenen Wert und sichert dessen Korrektheit zu.
- Natives SQL (sql { ... }) Datenbank & Persistenz
- Vollwertiges SQL direkt im Code, das zur Compile-Zeit gegen das deklarierte Schema validiert wird. Kombiniert die Ausdrucksstärke von SQL mit absoluter Typprüfung.
- Nominale Fachtypen (Domain Types) Typsystem & Sicherheit
- Definition semantisch getrennter Typen wie `type UserId = Id` und `type OrderId = Id`. Verhindert versehentliches Vertauschen gleichartiger ID-Werte in der Fachlogik.
- Null-Safety (Kein null) Typsystem & Sicherheit
- In Zelyra existiert kein `null`, `nil` oder `undefined`. Die sogenannte „Milliarden-Dollar-Fehlerquelle“ von Null-Pointer-Abstürzen ist im Sprachkern strukturell unmöglich.
- Option (Some / None) Typsystem & Sicherheit
- Sicherer Container für Werte, die vorhanden sein können (`Some(v)`) oder fehlen (`None`). Das Suffix `?` (z. B. `String?`) macht Abwesenheit zur Typpflicht.
- parallel & await System, I/O & Concurrency
- Ein `parallel`-Block startet unabhängige Aufgaben und wartet mit `await` auf ihre Ergebnisse. Der Gültigkeitsbereich der Aufgaben bleibt im Block sichtbar.
- Pattern Matching (match) Typsystem & Sicherheit
- Vollständige Fallunterscheidung von Datenstrukturen, Optionen und Ergebnissen. Der Compiler verweigert die Kompilierung, wenn ein möglicher Zweig vergessen wurde.
- read_text & write_text System, I/O & Concurrency
- Standardfunktionen für das sichere Lesen und Schreiben ganzer UTF-8-Dateien mit automatischem Ressourcen-Cleanup und Result-Fehlerbehandlung.
- Regressionsschutz Compiler, CLI & QA
- Schutz vor dem Wiederauftreten früherer Fehler. Statische Prüfungen, Vertragsverifikation und projektbezogene Testläufe helfen, unbeabsichtigte Änderungen nach einem Refactoring zu erkennen.
- Reine Funktion (Pure Function) Grundlagen & Syntax
- Funktion ohne Seiteneffekte: Ihr Ergebnis hängt nur von den Eingaben ab. Gleiche Eingaben liefern dasselbe Ergebnis.
- requires auth & permits Web, UI & Auth
- Deklarativer Zugriffsschutz an Routen: Weist unbefugte Aufrufe automatisch mit HTTP 401/403 ab oder leitet zur Anmeldeseite weiter.
- Result (Ok / Err) Typsystem & Sicherheit
- Typ für Operationen, die fehlschlagen können. Er gibt Erfolg als `Ok(daten)` und einen Fehler als `Err(grund)` explizit zurück.
- Route Web, UI & Auth
- Explizite Zuordnung einer HTTP-Methode und URL-Maske zu einem Funktions-Controller oder einer CRUD-Ressource.
- Sandboxing & Least Privilege Verträge & Capabilities
- Das Capability-Modell begrenzt Systemzugriffe auf die Fähigkeiten, die Funktionen anfordern und die für das Projekt freigegeben sind.
- Schleifeninvariante (invariant) Verträge & Capabilities
- Zusicherung innerhalb einer Schleife, die vor und nach jedem einzelnen Schleifendurchlauf garantiert wahr sein muss. Ermöglicht formale Korrektheitsbeweise.
- Slot (slot: name) Web, UI & Auth
- Platzhalter in Layouts und Containern, der beim Aufruf mit dynamischen Kind-Elementen oder spezifischen UI-Aktionen befüllt werden kann.
- Source Authority (Verbindliche Quellen) Compiler, CLI & QA
- Regel zur Klärung widersprüchlicher Quellen. Die Handbuchreferenz nennt in dieser Reihenfolge Sprachspezifikation, Compilerimplementierung, offizielle Tests, Standardbibliothek, verifizierte Beispiele und Dokumentation.
- Standardbibliothek (std) Compiler, CLI & QA
- Überblick über die dokumentierten Standardfunktionen und Capability-geschützten Funktionen wie Dateisystem, Zeit, Zufall und Datenbank.
- Tabelle (table) Datenbank & Persistenz
- Direkte Deklaration relationaler Schemata in Zelyra-Syntax inklusive Spaltentypen, Primärschlüsseln (`primary`), Unikatsregeln (`unique`) und Defaults.
- TDD (Testgetriebene Entwicklung) Compiler, CLI & QA
- Entwicklungsmethode, bei der Tests vor oder zusammen mit der Implementierung geschrieben werden. Sie unterstützt schrittweises Feedback, garantiert aber keinen fehlerfreien Code.
- Transaktion (transaction) Datenbank & Persistenz
- Atomare Bündelung mehrerer Datenbankbefehle: Alle Schreiboperationen gelingen gemeinsam oder werden bei einem Fehler vollständig zurückgerollt.
- Typed Hole (_) Grundlagen & Syntax
- Der Unterstrich `_` als typisierter Platzhalter. Zeigt Compiler und KI-Werkzeugen an, dass hier eine Implementierung erwartet wird, deren Typ aus dem Kontext abgeleitet wird.
- Typinferenz (Type Inference) Grundlagen & Syntax
- Die Fähigkeit des Zelyra-Compilers, Datentypen automatisch aus Literalen und Ausdrücken abzuleiten. Verbindet statische Typsicherheit mit leichtem, lesbarem Code.
- Unveränderliche Listenoperationen Sammlungen & Daten
- Unveränderliche Sammlungsoperationen ändern den bestehenden Wert nicht direkt, sondern liefern für Änderungen einen neuen Wert zurück.
- uses Clock & now() System, I/O & Concurrency
- Systemzeit-Capability: Funktionen, die aktuelle Zeitstempel ermitteln (`now()`), müssen `uses Clock` deklarieren. Macht Zeit in Tests deterministisch mockbar.
- uses Environment & env() System, I/O & Concurrency
- Umgebungsvariablen-Capability: `env("KEY")` liest Konfigurationswerte aus dem System oder `.env` und liefert ein sicheres `Option<String>`.
- uses FileSystem System, I/O & Concurrency
- Sicherheits-Capability für Festplattenoperationen. Jede Funktion, die Dateien liest oder schreibt, muss dieses Recht explizit anfordern.
- uses Random & random_int() System, I/O & Concurrency
- Zufalls-Capability: Erlaubt das Erzeugen pseudozufälliger Werte. Trennt deterministische Berechnungen klar von nicht-deterministischen Zufallswerten.
- Vorbedingung (requires) Verträge & Capabilities
- Vertragliche Klausel am Funktionskopf, die gültige Eingabewerte erzwingt, bevor die Funktion ausgeführt wird. Schützt Funktionen vor unzulässigen Aufrufen.
- Wert (Value) Grundlagen & Syntax
- Eine benannte Information. In Zelyra sind Werte standardmäßig unveränderlich (immutable), um Seiteneffekte und unerwartete Zustandsänderungen auszuschließen.
- Wörterbuch / Map (Map<K, V>) Sammlungen & Daten
- Assoziativer Speicher für Schlüssel-Wert-Paare. Das Nachschlagen via `get(map, key)` liefert stets eine sichere `Option<V>`, um Abstürze bei fehlenden Schlüsseln zu verhindern.
- Zelyra CLI (zelyra) Compiler, CLI & QA
- Das Kommandozeilenprogramm für Zelyra-Projekte: Es legt Projekte mit `new` an, prüft Quellcode mit `check`, führt Programme mit `run` aus und bietet weitere dokumentierte Unterbefehle. Ein eigener `test`-Unterbefehl ist in der aktuellen CLI-Referenz nicht aufgeführt.
- zelyra fmt (Formatierer) Compiler, CLI & QA
- Integrierter Quelltext-Formatierer mit deterministischer Ausgabe. `--check` prüft die Formatierung, ohne die Datei zu ändern.
- zelyra verify (Vertragsprüfung) Compiler, CLI & QA
- CLI-Befehl für die dokumentierten Vertrags- und Invariantenprüfungen. Die formale Analyse gilt für den unterstützten Prüfumfang und ersetzt keine allgemeine Korrektheitsgarantie.
- zelyra.toml (Projekt-Manifest) Compiler, CLI & QA
- Projektmanifest für Metadaten, Capability-Freigaben und unterstützte Projekteinstellungen. Zelyra-Module werden per Projektpfad eingebunden; ein Paketregister ist nicht Teil des dokumentierten Umfangs.
- zelyrac (Compiler) Compiler, CLI & QA
- Der Compiler verarbeitet Zelyra-Quellcode hinter der CLI `zelyra`. Die aktuelle CLI-Referenz dokumentiert kein separates Programm oder den Befehl `zelyrac build`; zum Prüfen und Ausführen dienen `zelyra check` und `zelyra run`.
zelyra
password: argon2 · verify_password(raw, hash)
zelyra
zahlen: Int[] = [1, 2, 3, 4]
zelyra
assert(result == 42, "Berechnung fehlgeschlagen")
zelyra
Source -> AST -> Verifier -> Executable
zelyra
Option<T> · Result<T, E>
zelyra
auth { model: User, password: argon2 }
zelyra
{ temp = 10; print(temp) }
zelyra
fn save() uses FileSystem, Database { ... }
zelyra
crud Address { table addresses }
zelyra
form { csrf; ... }
zelyra
record User { id: UserId, name: String }
zelyra
Int · Float · Bool · String · Decimal · Id
zelyra
contract · requires · ensures
zelyra
Web (UI) -> Business (Pure) -> Storage (DB)
zelyra
for id in aufgabe_ids { print(id) }
zelyra
form AddressForm { street: String min(3) }
zelyra
user_id: Id fk(users.id)
zelyra
fn add(a: Int, b: Int) -> Int { return a + b }
zelyra
json_encode(data) · json_decode<User>(raw)
zelyra
fn verify_solution() -> Bool { ... }
zelyra
component Alert(msg: String) { div { msg } }
zelyra
Language Server Protocol
zelyra
zelyra db plan · zelyra db apply
zelyra
mutable counter: Int = 0
zelyra
ensures { result >= min && result <= max }
zelyra
sql { SELECT * FROM users WHERE active = true }
zelyra
type UserId = Id; type OrderId = Id;
zelyra
"tok-comment">// Null-Pointer sind unmöglich!
zelyra
avatar_url: String? = None
zelyra
parallel { a = await task1(); b = await task2(); }
zelyra
match opt { Some(v) => v, None => "Standard" }
zelyra
text = read_text("export.csv")
zelyra
zelyra check main.zyl · zelyra verify main.zyl
zelyra
fn square(x: Int) -> Int { return x * x }
zelyra
route POST /admin requires auth permits("admin")
zelyra
Result<User, String> = Ok(user)
zelyra
route GET /users -> list_users
zelyra
capability Database { read, write }
zelyra
while i < len invariant { i >= 0 } { ... }
zelyra
slot: content
zelyra
Specification > Compiler > Tests > Examples > Handbook
zelyra
print(value) · len(array) · now()
zelyra
table users { id: Id primary, email: String unique }
zelyra
Vertrag -> Test -> Implementierung -> Refactoring
zelyra
transaction { debit(from, amt); credit(to, amt); }
zelyra
fn find(id: Id) -> User { return _ }
zelyra
anzahl = 42 "tok-comment">// Automatisch Int
zelyra
neu = append(liste, 42)
zelyra
timestamp = now() "tok-comment">// verlangt uses Clock
zelyra
port = env("APP_PORT") "tok-comment">// Option<String>
zelyra
fn save_csv() uses FileSystem { ... }
zelyra
wuerfel = random_int(1, 6) "tok-comment">// uses Random
zelyra
requires { limit > 0 && offset >= 0 }
zelyra
name: String = "Zelyra"
zelyra
Map { "de": 49, "at": 43, "ch": 41 }
zelyra
zelyra new · zelyra check · zelyra run
zelyra
zelyra fmt src/main.zyl
zelyra
zelyra verify main.zyl
zelyra
[package]
name = "myapp"
version = "0.1.0"
zelyra
zelyra check src/main.zyl
Keine passenden Begriffe gefunden
Versuche einen anderen Suchbegriff oder wechsle den Kategorie-Filter.