[[oktatas:programozás:python|< Python]]

====== unittest ======

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

===== A unittest =====

A unittest egy Python programozói könyvtár, automatizált tesztek létrehozására.

Dokumentáció:
  * https://docs.python.org/3/library/unittest.html (2024)


===== A unittest használata =====

<code python haromszog.py>
def calcArea(base, height):
    return base*height/2
</code>

<code python haromszog_test.py>
import haromszog
import unittest

class TestHaromszog(unittest.TestCase):

    def testCalcAreaNormal(self):
        self.assertEqual(haromszog.calcArea(30, 35), 525.0, 'Az eredmény 525.0 kell legyen')

    def testCalcAreaLowLeft(self):
        self.assertEqual(haromszog.calcArea(1, 35), 17.5, 'Az eredmény 17.0 kell legyen')

if __name__ == "__main__":
    unittest.main()
</code>

<note important>
A függvények kötelezően "test" szóval kell kezdődjenek!
<code>
  def test_valami():
    pass
</code>
</note>

<note important>
Kötelező: 
<code>
if __name__ == "__main__":
</code>
</note>

Egyszerűen futtassuk a programot.

===== Igaz vagy hamis =====

<code python>
#...
  def test_calcArea_with_float_values(self):
    self.assertTrue(type(calcArea(4.5, 5.5)) == float, 
        'Az eredmény float kell legyen, ha az alap 4.5 és a magasság 5.5')
</code>

===== Tesztek átlépése =====

<code python>
  @unittest.skip('Ez most ne fusson')
  def test_calcArea_in_4_5_to_10(self):
    self.assertEqual(calcArea(4, 5), 10,
      'Az eredmény 10 kell legyne')
</code>


<code python>
from haromszog import calcArea
import unittest

class TestHaromszog(unittest.TestCase):

  @unittest.skip('Ez most ne fusson')
  def test_calcArea_in_4_5_to_10(self):
    self.assertEqual(calcArea(4, 5), 10,
      'Az eredmény 10 kell legyne')



  def test_calcArea_with_zero_base(self):
    self.assertEqual(calcArea(0, 5), 0, 'Az eredmény 0 kell legyen, ha az alap 0')


if __name__ == '__main__':
  unittest.main()
</code>

<note tip>
A futtatás csak akkor működik "Play" gombbal, ha a tesztelendő fájl nincs külön könyvtárban.

Ilyen esetben futtassuk parancssorból vagy VSCode-ban a "Testing" eszközzel.
</note>

===== Strukturált könyvtár =====

<code>
app01/
  |-app/
  |  `-triangle.py
  `-tests/
     `-test_triangle.py
</code>

<code python app/triangle.py>
def calcArea(base, height):
  return (base * height) / 2  
</code>

<code python tests/test_triangle.py>
from app.triangle import calcArea
import unittest

class TestTriangle(unittest.TestCase):
  def test_bemenet_30_35(self):
    actual = calcArea(30, 35)
    expected = 525;
    self.assertEqual(actual, expected)


</code>

Futtatás:

<code>
python3 -m unittest test/test_triangle.py
</code>



===== VSCode =====

VSCode-ban használhatjuk a futtatást, de akár használhatjuk a "Testing" eszközt.

Lépések:
  * Kattintsunk a lombikra
  * "Configure Python Tests" gomb
  * Válasszuk ki: "**unittest** Standard Python test framework"
  * . Root directory
  * *test.py


{{:oktatas:programozas:python:vscode_no_tests.png|}}

{{:oktatas:programozas:python:vscode_python_select_test-framework.png|}}

{{:oktatas:programozas:python:vscode_python_select_test-directory.png|}}

{{:oktatas:programozas:python:vscode_python_select_test-filename.png|}}



Beállítás után kapsz egy fájlt:

  * .vscode/settings.json

==== Strukturált könyvtár ====

<code>
app01/
  |-app/
  |  `-triangle.py
  `-test/
     `-test_triangle.py
</code>


<code javascript>
{
  "python.testing.unittestArgs": [
    "-v",
    "-s",
    "./test",
    "-p",
    "test*.py"
  ],
  "python.testing.pytestEnabled": false,
  "python.testing.unittestEnabled": true,
}
</code>

<code python>
from app.triangle import calcArea
import unittest

class TestTriangle(unittest.TestCase):
  def test_bemenet_30_35(self):
    actual = calcArea(30, 35)
    expected = 525;
    self.assertEqual(actual, expected)
</code>

Ha VSCode-ból futtatjuk nem szükséges a if blokkjában a unittest.main() a fájl végén!



==== Extra útvonal használata ====

<code javascript>
{
  "python.testing.unittestArgs": [
    "-v",
    "-s",
    "./test",
    "-p",
    "test*.py"
  ],
  "python.testing.pytestEnabled": false,
  "python.testing.unittestEnabled": true,
  "python.analysis.extraPaths": [
    "./app"
  ]
}
</code>

Extra útvonal esetén nem szükséges megadni az src könyvtárat.

<code python>
from triangle import calcArea
import unittest

class TestTriangle(unittest.TestCase):
  def test_bemenet_30_35(self):
    actual = calcArea(30, 35)
    expected = 525;
    self.assertEqual(actual, expected)
</code>