1 # Uebersetzerbau \(SS10\)
3 Dies ist eine gemeinschaftliche Sammlung von Testfaellen fuer die Uebungsbeispiele
4 der LVA "Uebersetzerbau \(SS10\)" an der TU Wien.
6 Kurzes HOWTO (fuer die g0):
8 $ git clone git://github.com/lewurm/testub10.git ~/test
10 Danach koennen die Testfaelle durch diesen Befehl aktualisiert werden:
12 $ cd ~/test && git pull
14 Das Testskript selbst wird von der LVA-Leitung zur Verfuegung gestellt:
16 $ /usr/ftp/pub/ubvl/test/scanner/test
17 $ /usr/ftp/pub/ubvl/test/parser/test
18 $ /usr/ftp/pub/ubvl/test/ag/test
19 $ /usr/ftp/pub/ubvl/test/codea/test
20 $ /usr/ftp/pub/ubvl/test/codeb/test
21 $ /usr/ftp/pub/ubvl/test/gesamt/test
23 Weiters wurde das bekannte Benchmarkskript von viper fuer codea, codeb und
24 gesamt angepasst und eingebaut das sich in
26 $ ~/test/scripts/test.sh
28 befindet und mit {code{a,b},gesamt} als parameter aufgerufen wird.
30 # Namenskonventionen fuer das Skript (Zitat LVA Leitung):
32 Die Dateien mit der Eingabe heissen \*.0, \*.1, \*.2 oder \*.3, wobei die
33 Ziffer hinten den Exit-Code angibt. Eine Datei, die einen
34 Syntax-Fehler enthaelt, werden Sie also z.B. foo.2 nennen. Beim
35 Scanner-Beispiel gibt es fuer akzeptable Eingaben (also Dateien, die
36 auf .0 enden) auch noch eine Ausgabe, die ueberprueft werden muss; die
37 erwartete Ausgabe fuer die Datei bar.0 nennen Sie bar.out.
39 ## Weitere Namenskonventionen fuer uns:
41 * Jeder Testfall hat als Praefix "<nick>_", sodass keine Namenskonflikte entstehen.
42 * Ab codea sollte auch fuer jeden erfolgreichen Testfall eine .instr Datei angelegt werden die einen Referenzwert der Instruktionen enthaelt.
44 ### Hinweis fuer *gesamt* und `bench.sh`
46 In der Call-Datei bitte **nur** Funktionen deklarieren die tatsaechlich in der
47 Call-Datei selbst aufgerufen werden. Beispiel:
54 so muss in der Call-Datei nur `f()` deklariert werden.
57 # Wie kannst du beitragen?
61 * forke das Repository auf github, committe deine Aenderungen und mach einen "Pull Request"
62 * clone das Repository, committe deine Aenderungen, erzeuge Patches mit
66 und maile sie oder poste sie im Informatikforum
70 * schicke deine Testfaelle als Anhang per Mail (mit passenden Dateinamen bitte!)
71 * poste deine Testfaelle im Informatikforum und haenge sie als Attachment an (mit passenden Dateinamen bitte!)
73 und natuerlich ist jeder herzlichst dazu eingeladen im Forum ueber Testfaelle zu diskutieren :)
75 Infforum-Thread: <http://tinyurl.com/testub10>
77 Mailadresse(n): lewurm_AT_gmail_DOT_com (weitere Freiwillige sind willkommen, einfach eintragen)
83 praktische Ergaenzungen am Makefile fuer codea:
85 #bricht beim ersten fehlerhaften Testfall ab
89 ~/test/scripts/modlvatest_codea.sh 2>&1
92 #offizielles Testskript der LVA
96 /usr/ftp/pub/ublu/test/codea/test 2>&1
99 #Benchmarkskript. Testet nur *.0 Testfaelle
103 ~/test/scripts/bench.sh codea
105 Ausserdem befindet sich ein Skript zum Testen *eines* Testfalles (auch nur fuer
106 \*.0 Testfaelle gedacht) hier:
107 $ ~/test/scripts/onetest ~/test/codea/namen.0