¿Qué son los tests
y por qué usarlos?

# El flujo completo de Django testing:
# 1. Django lee tus clases de test
# 2. Crea una BD temporal (test_nombrebd)
# 3. Ejecuta cada test de forma AISLADA
# 4. Muestra resultados: ✅ ok / ❌ FAIL
# 5. Destruye la BD temporal

Tu código test → TestRunner → BD temporal → Resultado → BD eliminada

from django.test import TestCase
# ↑ Clase base de Django — nos da BD temporal + métodos de verificación


class MiPrimerTest(TestCase):
    # ↑ SIEMPRE hereda de TestCase
    # ↑ Agrupa tests relacionados en una misma clase

    def test_suma_basica(self):
        # ↑ Prefijo "test_" es OBLIGATORIO — sin él Django lo ignora
        resultado = 2 + 2
        self.assertEqual(resultado, 4)
        # ↑ Si son iguales → ✅ PASA
        # ↑ Si son distintos → ❌ FALLA con mensaje exacto

    def test_falla_a_proposito(self):
        # Para ver cómo luce un fallo en el output
        resultado = 2 + 2
        self.assertEqual(resultado, 5)
        # ↑ 4 != 5 → veremos el error en consola

# Todos los tests del proyecto
python manage.py test

# Solo una app
python manage.py test productos

# Una clase específica
python manage.py test productos.tests.MiPrimerTest

# Un test específico
python manage.py test productos.tests.MiPrimerTest.test_suma_basica

# Con más detalle
python manage.py test --verbosity=2

# ✅ Cuando TODO pasa
Creating test database for alias 'default'...
test_suma_basica (productos.tests.MiPrimerTest) ... ok
Ran 1 test in 0.003s
OK
Destroying test database for alias 'default'...

# ❌ Cuando algo FALLA
FAIL: test_falla_a_proposito (productos.tests.MiPrimerTest)
AssertionError: 4 != 5
# ↑ Te dice exactamente qué esperabas vs qué obtuviste

from django.test import TestCase


def calcular_precio_final(precio_original, descuento_pct):
    """Calcula precio con descuento. Rango válido: 0-100."""
    if descuento_pct < 0 or descuento_pct > 100:
        raise ValueError(
            f"Descuento inválido: {descuento_pct}. Debe ser 0-100."
        )
    return precio_original * (1 - descuento_pct / 100)


class PrecioFinalRapidoYaTest(TestCase):

    def test_descuento_valido_calcula_correctamente(self):
        # $500 con 20% de descuento → $400
        precio = calcular_precio_final(500, 20)
        self.assertEqual(precio, 400.0)

    def test_descuento_100_da_precio_cero(self):
        precio = calcular_precio_final(300, 100)
        self.assertEqual(precio, 0.0)

    def test_sin_descuento_precio_no_cambia(self):
        precio = calcular_precio_final(250, 0)
        self.assertEqual(precio, 250.0)

    def test_descuento_mayor_100_lanza_error(self):
        # ← el bug que llegó a producción
        with self.assertRaises(ValueError):
            calcular_precio_final(100, 150)

    def test_descuento_negativo_lanza_error(self):
        with self.assertRaises(ValueError):
            calcular_precio_final(100, -10)

    def test_mensaje_error_contiene_valor_recibido(self):
        with self.assertRaises(ValueError) as ctx:
            calcular_precio_final(100, 200)
        self.assertIn("200", str(ctx.exception))

$ python manage.py test productos --verbosity=2

test_descuento_100_da_precio_cero ............ ok
test_descuento_mayor_100_lanza_error ......... ok
test_descuento_negativo_lanza_error .......... ok
test_descuento_valido_calcula_correctamente .. ok
test_mensaje_error_contiene_valor_recibido ... ok
test_sin_descuento_precio_no_cambia .......... ok

Ran 6 tests in 0.001s
OK 🎉 — Bug de producción eliminado