class: center, middle name: primera-diapo

Francisco Puga

fran.puga (at) gmail.com

https://twitter.com/fpuga

http://conocimientoabierto.es

???

python -m SimpleHTTPServer 8000

• Qué es un test automático y porqué debería escribirlos
• Mi primer test automático en python

.footnote[

Aviso : Que las transpas tenga bullets y afirmaciones no significa que sean verdades absolutas. Cada caso será distinto.

Cuando se hace un cambio se comprueban (testean) dos cosas:

• el cambio añade la funcionalidad deseada
• el cambio no rompe nada (regression test)

Si sólo queremos probar el cambio actual, según el caso desde:

• Recargar la pestaña del navegador y hacer click
• Compilar, levantar la aplicación, loguearse, ...

Si tenemos que probar que no hemos roto nada...

• Porqué ahorran tiempo y dinero
• Porqué lo dice stackoverflow
• [Should I write unit tests? Yes and I’ll tell you why](Should I write unit tests? Yes and I’ll tell you why)

• Porqué incrementan la confianza
• Porqué incrementan la velocidad

• ... en que puedo cambiar algo sin romper nada -> Mejor diseño
• ... en que lo que se despliega funciona -> Dormir mejor
• ... en que puedes parar de escribir código (si haces tdd)

• ... al desarrollar. Sin esperas para levantar la aplicación
• ... al desarrollar. Sin "clicks" hasta llegar a lo que hay que probar
• ... time to market. Despliegues más regulares al haber ciclos de testing/qa menores

• Funcionan contra una mínima funcionalidad. Usualmente un único método
• Todo test debe ser independiente de otro test
• Son rápidos
• El test prueba por si mismo ser correcto o no. Sin intervención humana
• El código que prueban está aislado del resto del código (no tocan la base de datos, ni el sistema de archivos, ni ...)

Que un test no sea así, no quiere decir que sea malo, sólo que según algunas definiciones no será unitario

.left-column[

• tests automáticos

• unit test

• regression test

• acceptance test

• end-to-end test

• functional test

• ...

]

.right-column[

• mocks y stubs

• integration test

• tdd

• bdd

• performance test

• pyramid test

• ... ]

Cuando empiezas con tests pueden pasar dos cosas:

• que empieces a hacerlos con el primer tutorial que encuentres
• que abras tantas pestañas en el navegador que acabes bloqueado

• Menos leer y más programar
• Cuando aparezca un bug sencillo haz un test antes de resolverlo. Cuando el test esté correcto el bug estará resuelto y tendrás un test de regresión.
• No obsesionarse con que el test sea unitario
• Que todo el equipo tenga la mismas motivaciones y definiciones

Llamada en sus orígenes PyUnit en honor al JUnit de Beck y Gamma, lleva desde python 2.1 en la librería estándar con el nombre de unittest. En python 2.7 y 3.2 hubo muchas mejoras que fueron portadas a versiones anteriores bajo el nombre de unittest2

# -*- coding: utf-8 -*-
# test_1.py

import unittest

def suma(a, b):
    return a + b

class ExampleTest(unittest.TestCase):

    def testMethod(self):
        actual = suma(1,2)
        expected = 3
        self.assertEqual(expected, actual, 'suma(1,2) no es igual a 3')

if __name__ == '__main__':
    unittest.main()

# -*- coding: utf-8 -*-

*import unittest

def suma(a, b):
    return a + b

class ExampleTest(unittest.TestCase):

    def testMethod(self):
        actual = suma(1,2)
        expected = 3
        self.assertEqual(expected, actual, 'suma(1,2) no es igual a 3')

if __name__ == '__main__':
    unittest.main()

# -*- coding: utf-8 -*-

import unittest

def suma(a, b):
    return a + b

*class ExampleTest(unittest.TestCase):

    def testMethod(self):
        actual = suma(1,2)
        expected = 3
        self.assertEqual(expected, actual, 'suma(1,2) no es igual a 3')

if __name__ == '__main__':
    unittest.main()

# -*- coding: utf-8 -*-

import unittest

def suma(a, b):
    return a + b

class ExampleTest(unittest.TestCase):

*    def testMethod(self):
        actual = suma(1,2)
        expected = 3
        self.assertEqual(expected, actual, 'suma(1,2) no es igual a 3')

if __name__ == '__main__':
    unittest.main()

# -*- coding: utf-8 -*-

import unittest

def suma(a, b):
    return a + b

class ExampleTest(unittest.TestCase):

    def testMethod(self):
        actual = suma(1,2)
        expected = 3
*        self.assertEqual(expected, actual, 'suma(1,2) no es igual a 3')

if __name__ == '__main__':
    unittest.main()

# -*- coding: utf-8 -*-

import unittest

def suma(a, b):
    return a + b

class ExampleTest(unittest.TestCase):

    def testMethod(self):
        actual = suma(1,2)
        expected = 3
        self.assertEqual(expected, actual, 'suma(1,2) no es igual a 3')

*if __name__ == '__main__':
*    unittest.main()

• Extender unittest.TestCase
• Los nombres de métodos deben comenzar con 'test'. Los que no se llamen así no se ejecutaran.
• Que todo el equipo use la misma nomenclatura. (No es una norma pero debería serlo)

• Usar nombres largos para los nombres de los métodos porque saldrán en el mensaje de error
• Usar 'Test' como prefijo o sufijo del nombre de la clase
• Usar 'test' como prefijo del nombre del fichero (algunas utilidades usan este patrón por defecto para descubrir tests)
• Usar 'tests' como nombre del directorio donde pondremos los tests (nose busca en este directorio por defecto)

# -*- coding: utf-8 -*-
# test_2.py

import unittest

def division(a, b):
    return a / b

class Example2Test(unittest.TestCase):
    def testMethod(self):
        actual = division(6, 2)
        expected = 3
        self.assertEqual(expected, actual, 'I should study maths')

    def test_that_fails(self):
        actual = division(6, 2)
        expected = -99
        self.assertEqual(expected, actual, 'I must study maths')

    def test_with_a_not_expected_error(self):
        actual = division(1, 0)
        expected = 0
        self.assertEqual(expected, actual, 'Are you serious')

    def esto_no_es_un_test(self):
        actual = division(1.0, 2)
        expected = 0.5
        self.assertEqual(expected, actual, 'division(1.0, 2) no es igual a 0.5')

if __name__ == '__main__':
    unittest.main()

• 1 correcto, 1 falla, y otro tiene una excepción

$ python test_2.py
.FE
======================================================================
ERROR: test_with_a_not_expected_error (__main__.Example)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "test_3.py", line 20, in test_with_a_not_expected_error
      actual = division(1, 0)
        File "test_3.py", line 6, in division
	    return a / b
	    ZeroDivisionError: integer division or modulo by zero

======================================================================
FAIL: test_that_fails (__main__.Example)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "test_3.py", line 17, in test_that_fails
      self.assertEqual(expected, actual, 'I must study maths')
      AssertionError: I must study maths

----------------------------------------------------------------------
Ran 3 tests in 0.000s

FAILED (failures=1, errors=1)

Cuando tenemos muchos tests...

$ python pythonvigo/tests/test_1.py
[...]

$ python pythonvigo/tests/test_2.py
[...]

$ python python -m pythonvigo.tests.all.test_everything_is_working
[...]

$ ...

tenemos que automatizar la forma de ejecutarlos

# run_all_tests.py
import unittest

import test_1
import test_2

loader = unittest.TestLoader()

suite = loader.loadTestsFromModule(test_1)
suite.addTests(loader.loadTestsFromModule(test_2))

runner = unittest.TextTestRunner(verbosity=2)
result = runner.run(suite)

discover Una utilidad para automatizar la ejecutación de los tests automáticos.

$ pip install discover
$ python -m discover -s tests/

Aunque llegados a este punto seguramente nose, py.test o el método que recomiende tu framework de desarrollo si usas uno, son opciones más interesantes.

• assertAlmostEqual(first, second, places=7, msg=None): Comprueba que los objetos pasados como parámetros sean iguales hasta el séptimo decimal (o el número de decimales indicado por places).
• assertEqual(first, second, msg=None): Comprueba que los objetos pasados como parámetros sean iguales.
• assertFalse(expr, msg=None): Comprueba que la expresión sea falsa.
• assertNotAlmostEqual(first, second, places=7, msg=None): Comprueba que los objetos pasados como parámetros no sean iguales hasta el séptimo decimal (o hasta el número de decimales indicado por places).
• assertNotEqual(first, second, msg=None): Comprueba que los objetos pasados como parámetros no sean iguales.
• assertRaises(excClass, callableObj, args, kwargs): Comprueba que al llamar al objeto callableObj con los parámetros definidos por args y kwargs se lanza una excepción de tipo excClass.
• assertTrue(expr, msg=None): Comprueba que la expresión sea cierta.
• assert_(expr, msg=None): Comprueba que la expresión sea cierta.

• fail(msg=None): Falla inmediatamente.
• failIf(expr, msg=None): Falla si la expresión es cierta.
• failIfAlmostEqual(first, second, places=7, msg=None): Falla si los objetos pasados como parámetros son iguales hasta el séptimo decimal (o hasta el número de decimales indicado por places).
• failIfEqual(first, second, msg=None): Falla si los objetos pasados como parámetros son iguales.
• failUnless(expr, msg=None): Falla a menos que la expresión sea cierta.
• failUnlessAlmostEqual(first, second, places=7, msg=None): Falla a menos que los objetos pasados como parámetros sean iguales hasta el séptimo decimal (o hasta el número de decimales indicado por places).
• failUnlessEqual(first, second, msg=None): Falla a menos que los objetos pasados como parámetros sean iguales.
• failUnlessRaises(excClass, callableObj, args, kwargs): Falla a menos que al llamar al objeto callableObj con los parámetros definidos por args y kwargs se lance una excepción de tipo excClass.

• setUp: Se ejecuta antes de cada test
• tearDown: Se ejecuta después de cada test

import unittest

from mymodule import MyClass

class MyTest(unittest.TestCase):

    def setUp(self):
        unittest.TestCase.setUp(self)
        self.myclass = MyClass()

    def tearDown(self):
        unittest.TestCase.tearDown(self)
        self.myclass.close()

    def testTrue(self):
        result = self.myclass.method()
        self.asssertTrue(result)

Se ejecutan una vez por clase

import unittest

from mymodule import MyClass

class MyTest(unittest.TestCase):

    @classmethod
    def setUpClass(cls):
        cls._connection = createExpensiveConnectionObject()

    @classmethod
    def tearDownClass(cls):
        cls._connection.destroy()

   def testTrue(self):
        result = self._connection.doSomething()
        self.asssertTrue(result)

# -*- coding: utf-8 -*-

import unittest

def division(a, b):
    '''
    Divides a with b

    >>> division(6, 2)
    3

    >>> division(10, 2)
    99
    '''
    return a / b

if __name__ == '__main__':
    import doctest
    doctest.testmod()

• Introduction to unittest
• Dive Into Python: Unit testing y Refactoring
• The Hitchhiker’s Guide to Python!
• [unittest – Automated testing framework - Python Module of the Week](unittest – Automated testing framework)

template: primera-diapo