diff --git a/tests/MetaGerPhpTest.php b/tests/MetaGerPhpTest.php
index 94b373b510c70849896544c4510dc955c851b846..845e7b97518b73b9541da7d536ceac475715ed7b 100644
--- a/tests/MetaGerPhpTest.php
+++ b/tests/MetaGerPhpTest.php
@@ -6,6 +6,8 @@ use Illuminate\Http\Request;
class MetaGerPhpTest extends TestCase
{
+ // Die Testfunktion die PHP Unit aufruft
+ // Ruft alle anderen Untertests auf
public function test()
{
$this->fullRunTest();
@@ -24,6 +26,8 @@ class MetaGerPhpTest extends TestCase
$this->productsTest();
}
+ // Führt alle Schritte einer normalen MetaGer Suche durch
+ // Es werden keine bestimmten Werte erwartet, nur dass das Programm nicht abstürzt
public function fullRunTest()
{
$metager = new MetaGer();
@@ -36,6 +40,7 @@ class MetaGerPhpTest extends TestCase
$metager->createView();
}
+ // Testet das erkennen von Spezialsuchen in verschiedenen Sucheingaben
public function specialSearchTest()
{
$metager = new MetaGer();
@@ -72,6 +77,7 @@ class MetaGerPhpTest extends TestCase
$this->assertContains("-host:-domain:test", $metager->getPhrases());
}
+ // Testet, ob ein Link wirklich nur einmal hinzugefügt werden kann
public function addLinkTest()
{
$metager = new MetaGer();
@@ -80,6 +86,7 @@ class MetaGerPhpTest extends TestCase
$this->assertFalse($metager->addLink($link));
}
+ // Testet die Funktionen die spezielle Sumas filtern
public function specialSumaTest()
{
$metager = new MetaGer();
@@ -121,6 +128,7 @@ class MetaGerPhpTest extends TestCase
$this->assertTrue($metager->sumaIsNotAdsuche($suma));
}
+ // Testet die Generatoren für spezielle Links
public function linkGeneratorTest()
{
$metager = new Metager();
@@ -138,6 +146,7 @@ class MetaGerPhpTest extends TestCase
'-domain%3Awolf.de');
}
+ // Prüft ob der Host Count funktioniert
public function getHostCountTest()
{
$metager = new MetaGer();
@@ -152,6 +161,7 @@ class MetaGerPhpTest extends TestCase
$this->assertEquals($before + 1, $after);
}
+ // Prüft ob bei passender Einstellung der Sumas der Fokus automatisch umgestellt wird
public function adjustFocusTest()
{
$metager = new MetaGer();
@@ -173,6 +183,7 @@ class MetaGerPhpTest extends TestCase
$this->assertEquals("bilder", $metager->getFokus());
}
+ // Prüft ob das fehlen einer Suchmaschine mit Seitensuche erkannt wird
public function checkCanNotSitesearchTest()
{
$metager = new MetaGer();
@@ -188,6 +199,7 @@ class MetaGerPhpTest extends TestCase
$this->assertTrue($metager->checkCanNotSitesearch($enabledSearchengines));
}
+ // Prüft ob Bildersuchen erkannt werden
public function isBildersucheTest()
{
$metager = new MetaGer();
@@ -201,6 +213,7 @@ class MetaGerPhpTest extends TestCase
$this->assertFalse($metager->isBildersuche());
}
+ // Prüft ob der Link für Minisucher richtig erstellt wird
public function loadMiniSucherTest()
{
$metager = new MetaGer();
@@ -211,12 +224,14 @@ class MetaGerPhpTest extends TestCase
$this->assertContains("fq=subcollection:%28minism1+OR+minism2%29", $minisucher["formData"]->__toString());
}
+ // Prüft ob der Link für den Image Proxy richtig erstellt wird
public function getImageProxyLinkTest()
{
$metager = new MetaGer();
$this->containCallbackTester($metager, "getImageProxyLink", ["www.bilder.de/bild1.png"], "url=www.bilder.de%2Fbild1.png");
}
+ // Prüft ob sich Quicktips korrekt ein und ausschalten lassen
public function showQuicktipsTest()
{
$metager = new MetaGer();
@@ -230,6 +245,7 @@ class MetaGerPhpTest extends TestCase
$this->assertTrue($metager->showQuicktips());
}
+ // Prüft ob Werbung der Werbeliste hinzugefügt wird und ob die pop-funktion für die Werbeergebnisse funktioniert
public function popAdTest()
{
$metager = new MetaGer();
@@ -261,6 +277,7 @@ class MetaGerPhpTest extends TestCase
$this->assertEquals("Werbetitel", $metager->popAd()['titel']);
}
+ // Prüft ob Produktergebnisse der Produktliste hinzugefügt werden
public function productsTest()
{
$metager = new MetaGer();
@@ -294,6 +311,7 @@ class MetaGerPhpTest extends TestCase
$this->assertEquals("Produkttitel", $metager->getProducts()[0]['titel']);
}
+ // Erstellt eine Suchanfrage zu Testzwecken
public function createDummyRequest()
{
/**
@@ -324,6 +342,14 @@ class MetaGerPhpTest extends TestCase
return new Request($query);
}
+ /**
+ * Funktion zum vereinfachen von Tests, bei denen die Ausgabe einer Funktion ein bestimmtes Objekt enthalten soll
+ *
+ * @param Object $object Das Object von dem aus die Funktion aufgerufen werden soll
+ * @param String $funcName Der Name der Funktion
+ * @param array $input Die Eingaben für die Funktion
+ * @param mixed $expectedInOutput Etwas das im Funktionsergebnis erwartet wird (meist ein String)
+ */
public function containCallbackTester($object, $funcName, $input, $expectedInOutput)
{
$output = call_user_func_array(array($object, $funcName), $input);
diff --git a/tests/ResultPhpTest.php b/tests/ResultPhpTest.php
index 272923d3576b17e8d3160c13cfa843e30d7f1ee3..341280f30226d39935c6cca388ec034fb646c0d0 100644
--- a/tests/ResultPhpTest.php
+++ b/tests/ResultPhpTest.php
@@ -6,6 +6,8 @@ use Illuminate\Http\Request;
class ResultPhpTest extends TestCase
{
+ // Die Testfunktion die PHP Unit aufruft
+ // Ruft alle anderen Untertests auf
public function test()
{
$this->rankingTest();
@@ -13,18 +15,21 @@ class ResultPhpTest extends TestCase
$this->linkGeneratorsTest();
}
+ // Liefert ein standard Suchergebnis
public function getDummyResult()
{
$provider = file_get_contents("tests/testSumas.xml");
$titel = "Titel";
$link = "link.de";
$anzeigeLink = "link.de/anzeige";
- $descr = "Beschreibung: i want phrase";
- $gefVon = "";
- $sourceRank = 1;
+ $descr = "Beschreibung: i want phrase
+Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.";
+ $gefVon = "";
+ $sourceRank = 1;
return new Result($provider, $titel, $link, $anzeigeLink, $descr, $gefVon, $sourceRank);
}
+ // Liefert eine standard MetaGer
public function getDummyMetaGer()
{
$metager = new MetaGer();
@@ -34,6 +39,7 @@ class ResultPhpTest extends TestCase
return $metager;
}
+ // Liefert eine standard Suchanfrage
public function createDummyRequest()
{
$query = [];
@@ -50,6 +56,7 @@ class ResultPhpTest extends TestCase
return new Request($query);
}
+ // Testet ob das Ranking nicht übermäßig vom gewünschten Wert abweicht
public function rankingTest()
{
$result = $this->getDummyResult();
@@ -63,6 +70,7 @@ class ResultPhpTest extends TestCase
$this->assertEquals(0.4, $result->getRank(), "Not within Range of Actual Value", 0.1);
}
+ // Prüft die Valid funktion, die für Ergebnisse auf der Host- oder Domain-Blacklist false zurückgeben soll
public function isValidTest()
{
$result = $this->getDummyResult();
@@ -91,6 +99,7 @@ class ResultPhpTest extends TestCase
$this->assertFalse($result->isValid($metager));
}
+ // Prüft die Funktionen die Links umformen oder erzeugen
public function linkGeneratorsTest()
{
$result = $this->getDummyResult();
@@ -113,6 +122,14 @@ class ResultPhpTest extends TestCase
'han.solo.de/unterseite/document.htm');
}
+ /**
+ * Funktion zum vereinfachen von Tests, bei denen die Ausgabe einer Funktion einem Object entsprechen soll
+ *
+ * @param Object $object Das Object von dem aus die Funktion aufgerufen werden soll
+ * @param String $funcName Der Name der Funktion
+ * @param array $input Die Eingaben für die Funktion
+ * @param mixed $expectedInOutput Etwas das als Funktionsergebnis erwartet wird (meist ein String)
+ */
public function equalCallbackTester($object, $funcName, $input, $expectedInOutput)
{
$output = call_user_func_array(array($object, $funcName), $input);
diff --git a/tests/SearchenginePhpTest.php b/tests/SearchenginePhpTest.php
index 9659212ddfa2d984ad53b0b69ea6013d1edb75fe..c3b1f4b1aa2976f01239d96572fc9a9597878763 100644
--- a/tests/SearchenginePhpTest.php
+++ b/tests/SearchenginePhpTest.php
@@ -6,12 +6,15 @@ use Illuminate\Http\Request;
class SearchenginePhpTest extends TestCase
{
+ // Die Testfunktion die PHP Unit aufruft
+ // Ruft alle anderen Untertests auf
public function test()
{
$this->constructionTest();
$this->enablingTest();
}
+ // Prüft ob aus einer XML korrekt das Suchmaschinen-Objekt erstellt wird
public function constructionTest()
{
$engines = simplexml_load_file("tests/testSumas.xml")->xpath("suma");
@@ -71,6 +74,7 @@ class SearchenginePhpTest extends TestCase
$searchengine->cacheDuration);
}
+ // Prüft ob Suchmaschinen korrekt ein- und ausgeschaltet werden können
public function enablingTest()
{
$engines = simplexml_load_file("tests/testSumas.xml")->xpath("suma");
@@ -93,7 +97,7 @@ class SearchenginePhpTest extends TestCase
$this->assertTrue($searchengine->isEnabled());
}
- /*
+ /* Noch fehlende Funktionen (teils kaum testbar)
abstract public function loadResults($result);
private function setStatistic($key, $val)
protected function getHost()
@@ -111,6 +115,14 @@ class SearchenginePhpTest extends TestCase
removeCurlHandle($mh)
*/
+ /**
+ * Funktion zum vereinfachen von Tests, bei denen die Ausgabe einer Funktion einem Object entsprechen soll
+ *
+ * @param Object $object Das Object von dem aus die Funktion aufgerufen werden soll
+ * @param String $funcName Der Name der Funktion
+ * @param array $input Die Eingaben für die Funktion
+ * @param mixed $expectedInOutput Etwas das als Funktionsergebnis erwartet wird (meist ein String)
+ */
public function equalCallbackTester($object, $funcName, $input, $expectedInOutput)
{
$output = call_user_func_array(array($object, $funcName), $input);
diff --git a/tests/testSumas.xml b/tests/testSumas.xml
index b7608ca17e901a76e8f3a1f4c1eac99955474669..2015b209b89a6d9fa4e5d589c0a3973fdc4f1545 100644
--- a/tests/testSumas.xml
+++ b/tests/testSumas.xml
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
+<!-- Eine Test XML mit einer bildersuchmaschine mit subcollections -->
<sumas>
<suma name="minism" host="www.suchmaschine.de" skript="/suche/" formData="sprache=de&sortieren=true&queue=<<QUERY>>&rows=<<COUNT>>&fq=subcollection:<<SUBCOLLECTIONS>>" package="suchmaschine" displayName="Meine Suchmaschine" homepage="www.suchmaschine.de/welcome" port="443" inputEncoding="Latin1" userSelectable="1" type="bilder" engineBoost="1.2" additionalHeaders="$#!#$" hasSiteSearch="1" cacheDuration="60"/>
</sumas>
diff --git a/tests/testSumas2.xml b/tests/testSumas2.xml
index 6684ccd58508cd0fc287f25079bc4aa62ba375ed..d3463ac2901071ed472693f7912383efc7e1c58d 100644
--- a/tests/testSumas2.xml
+++ b/tests/testSumas2.xml
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
+<!-- Eine Test XML mit 2 bilder und 1 web suchmaschine -->
<sumas>
<suma name="name1" host="www.suchmaschine1.de" skript="/suche1/" formData="sprache=de&sortieren=true&queue=<<QUERY>>&rows=<<COUNT>>&fq=subcollection:<<SUBCOLLECTIONS>>" package="suchmaschine1" displayName="Meine Suchmaschine1" homepage="www.suchmaschine1.de/welcome" port="443" inputEncoding="Latin1" userSelectable="1" type="bilder" engineBoost="1.2" additionalHeaders="$#!#$" hasSiteSearch="0" cacheDuration="60"/>
<suma name="name2" host="www.suchmaschine2.de" skript="/suche2/" formData="sprache=de&sortieren=true&queue=<<QUERY>>&rows=<<COUNT>>&fq=subcollection:<<SUBCOLLECTIONS>>" package="suchmaschine2" displayName="Meine Suchmaschine2" homepage="www.suchmaschine2.de/welcome" port="443" inputEncoding="Latin1" userSelectable="1" type="web" engineBoost="1.2" additionalHeaders="$#!#$" hasSiteSearch="0" cacheDuration="60"/>