Die EVE-Sprache

EVE ist die Mustererkennungs-Engine hinter dem Verité-Chatfilter. Sie wird mit einer eigenen kleinen Sprache zum Verfassen von Filterdateien ausgeliefert. Diese Seite ist die übergeordnete Anleitung: was EVE ist, wie eine Filterdatei strukturiert ist und welche Direktiven ein Dokument ausmachen. Die beiden Dialekte haben jeweils ihre eigene Seite:

• ExpandaEVE ist die ausgeschriebene Form, die du von Hand schreibst. Sie verwendet Wörter wie HEAR, SUFFIX, NEVER und PLURAL.
• CompactaEVE ist die knappe kompilierte Form und die Matcher-Semantik darunter. Jedes ExpandaEVE-Konstrukt wird vor der Ausführung auf ein CompactaEVE-Symbol heruntergebrochen.

Was EVE ist

EVE liest ein Filterdokument und erzeugt einen Satz kompilierter Regeln. Jede Regel ist ein Muster, das entscheidet, ob ein Kandidatenwort (oder, bei einigen Regelarten, eine ganze Nachricht) ein Treffer ist. Die Engine ist bewusst tolerant gegenüber Umgehung: eine Fuzzy-Regel trifft durch Vokaltausch, eingefügte Lücken, gedehnte Buchstaben und ähnliche Tricks hindurch, sodass eine einzige verfasste Wurzel viele Schreibweisen erfasst, ohne dass der Autor jede einzeln aufführt.

Eine Filterdatei ist reiner UTF-8-Text. Zeilen, die leer sind oder mit # beginnen, werden ignoriert, # startet also einen ganzzeiligen Kommentar.

Die zwei Formen und wie sie zusammenhängen

Du verfasst in ExpandaEVE. Wenn ein Dokument geladen wird, wird jede Anweisung in CompactaEVE übersetzt, und das CompactaEVE wird in den lauffähigen Matcher kompiliert. Der Ablauf ist:

ExpandaEVE source  ->  CompactaEVE source  ->  compiled rules
     (authoring)          (terse form)          (the matcher)

Die Übersetzung ist rein ein Umschreiben. Alles, was du in ExpandaEVE ausdrücken kannst, wird zu echtem CompactaEVE, und jede Trefferentscheidung wird von der kompilierten Form getroffen. Ein Dokument kann auch direkt in CompactaEVE geschrieben werden: die Anweisungsverben sind dieselben Wörter in Kleinbuchstaben (hear, match, let, define, realm und so weiter), und eine Anweisung, die kein reines ExpandaEVE-Konstrukt verwendet, geht nahezu wörtlich durch den Übersetzer.

Dokumentstruktur

Ein Dokument ist eine Folge von Anweisungen, eine pro logischer Zeile. Die erkannten Anweisungsschlüsselwörter sind DEFINE, LET, REALM, HEAR, FIND, MATCH, ANYWHERE und SEQUENCE, dazu die eve:-Headerzeile. Jede Zeile, die nicht leer, kein Kommentar ist und nicht mit einem erkannten Schlüsselwort beginnt, löst einen Fehler aus, statt übersprungen zu werden.

Der eve:-Header

Eine optionale erste Zeile deklariert die Version und die Sprache:

eve: 1.0 English

Der Text nach eve: bis zum ersten Leerzeichen ist die Version. Der Rest ist der Sprachname. Beide werden im kompilierten Programm aufgezeichnet. Ein Header mit nur einer Version und ohne Sprache wird akzeptiert.

DEFINE: Flag-IDs deklarieren

DEFINE registriert einen Flag-Namen und die ID, auf die er abbildet. Jedes Flag, das eine Regel mit FLAG(...) setzt, muss deklariert sein, sonst schlägt das Laden des Dokuments fehl.

DEFINE sh AS selfharm
DEFINE ea AS abuse
DEFINE pf AS profanity

Der Name auf der linken Seite ist das, worauf Regeln verweisen. Die ID auf der rechten Seite ist die Kategorie, die der Filter meldet. Siehe Flags dafür, wie Regeln sie verwenden.

LET: eine Funktion definieren (benannte Klasse)

LET function(name) BE ... deklariert eine benannte Klasse: eine Liste austauschbarer Wörter oder Fragmente, die eine Regel per Name einbeziehen kann. In CompactaEVE wird dieselbe Klasse let &name be ... geschrieben.

LET function(genderword) BE female OR girl OR woman OR male OR guy OR guys OR men OR man

Mitglieder werden durch OR getrennt. Einmal deklariert, wird eine Klasse anderswo mit function(name) in ExpandaEVE oder &name in CompactaEVE referenziert. Eine Klassenreferenz expandiert zu allen ihren Mitgliedern. Klassen können auf dem Namen einen Standardmarker (WHOLE) oder (ROOT) tragen, der von Referenzen geerbt wird, sofern die Referenz ihn nicht überschreibt:

LET function(frenchstuff) (WHOLE) BE franger OR frenchie OR jizzbag

Siehe Funktionen und Klassen für die vollständige Referenz, einschließlich wie eine Klasse als Wurzel, als Gruppe, als Alias und innerhalb eines Skeletts verwendet wird.

REALM: Regeln gruppieren

REALM setzt das Realm, zu dem jede folgende Regel gehört, bis zum nächsten REALM. Ein Realm ist ein Label, das zum Organisieren und Zuordnen von Regeln verwendet wird. Es ändert nicht, wie eine Regel trifft.

REALM racial_and_ethnic_slurs

Jede HEAR-, FIND-, MATCH-, ANYWHERE- und SEQUENCE-Regel, die folgt, trägt diesen Realm-Namen, bis du ein anderes Realm deklarierst.

Die Regelanweisungen

Fünf Anweisungen deklarieren Regeln. Jede wird als das Verb, ein Name, das Schlüsselwort AS und ein Rumpf geschrieben. Der Name und der Rumpf können sich über mehrere Zeilen erstrecken: der Rumpf läuft bis zum nächsten Anweisungsschlüsselwort am Anfang einer Zeile.

HEAR und FIND sind dieselbe Regelart, diese Anleitung verwendet also durchgehend HEAR. Ein Fuzzy-Regelrumpf ist ein vollständiges ExpandaEVE-Muster: eine Wurzel plus beliebige der Konstrukte auf der ExpandaEVE-Seite.

Eine vollständige minimale Datei

eve: 1.0 English

DEFINE pf AS profanity

REALM profanity

HEAR rule
AS
  shit(WHOLE)
  suffix(NONE OR s OR ty OR head OR heads)
  NEVER(shitake OR shiitake OR mishit)
  FLAG(pf YES)

Dies deklariert ein Flag, öffnet ein Realm und fügt eine Fuzzy-Regel hinzu. Die Regel trifft das ganze Wort shit mit einer der aufgeführten Endungen, verweigert die aufgeführten unschuldigen Wörter und meldet die Kategorie profanity. Lies die ExpandaEVE-Referenz für jedes hier verwendete Konstrukt.