[[oktatas:programozás:java:java_teszteles:testng|< TestNG]]

====== TestNG - VSCode riport ======

  * **Szerző:** Sallai András
  * Copyright (c) 2023, Sallai András
  * Licenc: [[https://creativecommons.org/licenses/by-sa/4.0/|CC BY-SA 4.0]]
  * Web: https://szit.hu

===== A TestNG riportok =====

Szükséges:
  * slf4j-simple-x.y.z.jar


Teendők:
  * Töltsük le a slf4j naplózó rendszer simpmle modulját.
  * Vegyük fel az slf4j-simple modult a programozói könyvtárak közé.
  * Futtassuk a tesztet.

Eredmény:

Készül egy konzolos riport, ami a "DEBUG CONSOLE"-on tekinthető meg.

Például:
<code>
[main] INFO org.testng.internal.Utils - [TestNG] Running:
  /home/andras/dev/gyak/java/testng/app01/testng.xml


===============================================
Suite1
Total tests run: 2, Passes: 2, Failures: 0, Skips: 0
===============================================
</code>

Készíthetünk HTML állományban. 

====== HTML riport ======

Legyen például a test/TriangleTest.java fájl.

Készítsünk egy testng.xml nevű fájlt a projekt gyökérkönyvtárában, a következő tartalommal:

<code xml testng.xml>
<?xml version = "1.0" encoding = "UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >

<suite name = "Suite1">
   <test name = "test1">
      <classes>
         <class name = "TriangleTest"/>
      </classes>
   </test>
</suite>
</code>

==== launch.json fájl ====

Hozzuk létre a launch.json fájlt:

  * Run > Add Configuration...


Adjuk hozzá a következő tartalmat:

<code javascript .vscode/launch.json>
{
    "configurations": [
        {
            "type": "java",
            "name": "TestNG futtatása",
            "request": "launch",
            "mainClass": "org.testng.TestNG",
            "args": "testng.xml"
        }
    ]
}
</code>

==== Futtatás ====

  * Az akciósávon "Run and Debug".
  * Az oldalsáv tetején kiválasztom a "TestNG futtatása" pontot.
  * A "lejátszó" gombra kattintok

==== Eredmény ====

A futtatás eredményeként létrejön a projekt gyökér könyvtárában 
egy **test-output** könyvtár. Benne egy komplett webhely. 

Nyissuk meg az index.html állományt nézzük meg.

===== A HTML kimenet helye =====

Beállíthatjuk, hogy hova tegye a HTML kimenetet. Például macOS és Linux 
rendszeren a /tmp könyvtárba:

<code javascript>
        {
            "type": "java",
            "name": "TestNG futtatása",
            "request": "launch",
            "mainClass": "org.testng.TestNG",
            "args": "-d \"/tmp/testng-output/aaaaa\" testng.xml"
        }
</code>

Ebben az esetben a teszt a /tmp/testng-output/aaaaa/ könyvtárban jön létre.

Ha a projekt könyvtárban szeretnénk egy mondjuk az aaaaa könyvtárba:
<code javascript>
 "args": "-d aaaaa testng.xml"
</code>


===== E-mailben küldhető HTML fájl =====


A testng-output (vagy ami meg van adva) könyvtárban létrejön egy **emailable-report.html** fájl.



===== Linkek =====

  * https://testng.org/doc/documentation-main.html (2023)
  * https://www.tutorialspoint.com/testng/ (2023)