README

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