¿Cómo añades pruebas al código heredado?

Question

Accepted Answer

**Código heredado** (frecuentemente sin pruebas, difícil de cambiar) es desafiante de probar — puede tener dependencias enmarañadas y ninguna prueba. Añadir pruebas de forma segura implica técnicas como **pruebas de caracterización**, **seams** para romper dependencias, y mejora incremental, permitiendo cambios más seguros.

## El desafío del código heredado

```text
Legacy code is often: untested, tightly coupled, hard to understand, risky to change:
  → no tests → changing it is dangerous (you can't tell if you broke something)
  → hard to test → dependencies are tangled (can't isolate units); not designed for testing
→ a chicken-and-egg problem: to change safely you need tests, but it's hard to test.
```

## Pruebas de caracterización (fijar el comportamiento actual)

```text
CHARACTERIZATION (golden master) tests → capture the code's CURRENT behavior as-is
  (even if you don't fully understand it / it has bugs):
  → write tests asserting what it ACTUALLY does now → a SAFETY NET
  → then you can refactor/change with confidence that behavior is preserved
→ Don't assert what it SHOULD do — assert what it DOES, to protect against regressions.
```

## Rompiendo dependencias (seams)

```text
To isolate hard-to-test code, find/create SEAMS (places to substitute dependencies):
  → extract dependencies behind interfaces; inject them; use the smallest safe refactors
    to make code testable (Michael Feathers' techniques)
  → carefully break dependencies so you can get the code under test, then test, then refactor
```

## Enfoque incremental

```text
✓ Add tests AROUND code BEFORE changing it (a safety net for the change)
✓ Focus on areas you're CHANGING / high-risk / high-value (not the whole codebase at once)
✓ Improve incrementally — leave code a bit better each time (the "boy scout rule")
✓ Use characterization tests to capture behavior, then refactor toward testability
```

## Por qué es importante

Entender cómo añadir pruebas al código heredado es un conocimiento valioso de nivel senior porque **la mayoría del trabajo del mundo real implica código existente, frecuentemente sin pruebas**, y mejorarlo de forma segura es un desafío común e importante, por lo que es prácticamente relevante.

El código heredado (sin pruebas, fuertemente acoplado, difícil de cambiar) presenta un verdadero **problema del huevo y la gallina**: para cambiarlo de forma segura necesitas pruebas, pero es difícil de probar (dependencias enmarañadas, no diseñado para pruebas) — y cambiar código sin pruebas es peligroso porque no puedes saber si rompiste algo.

Entender las técnicas para abordar esto es un conocimiento práctico valioso. **Las pruebas de caracterización** (capturando el comportamiento *actual* del código tal cual es, afirmando lo que realmente hace en lugar de lo que debería — incluso si no se entiende completamente) proporcionan una **red de seguridad** que te permite refactorizar y cambiar con confianza de que el comportamiento existente se preserva — una técnica clave para trabajar con código que no entiendes completamente.

Entender **la ruptura de dependencias vía seams** (encontrar o crear lugares para sustituir dependencias, usando refactorizaciones mínimas y seguras para hacer testeable el código enmarañado — las técnicas del trabajo de Michael Feathers sobre código heredado) es esencial para poner bajo prueba el código difícil de probar.

Entender el **enfoque incremental** — añadiendo pruebas alrededor del código antes de cambiarlo (una red de seguridad para el cambio), enfocándose en áreas siendo cambiadas o alto riesgo/alto valor (no todo el código a la vez), y mejorando incrementalmente (la regla del boy scout) — refleja la forma pragmática y realista de mejorar sistemas heredados con el tiempo.

Ya que la mayoría del desarrollo del mundo real implica código heredado existente, frecuentemente sin pruebas que debe cambiarse de forma segura (una situación común y desafiante), y ya que entender las técnicas (pruebas de caracterización para una red de seguridad, seams para romper dependencias, mejora incremental) permite hacer esto, entender cómo añadir pruebas al código heredado es un conocimiento valioso de nivel senior — prácticamente relevante para la realidad común de trabajar con código heredado existente sin pruebas, reflejando la experiencia y técnicas necesarias para mejorar de forma segura sistemas heredados, una competencia importante para ingenieros senior que frecuentemente deben hacer código sin pruebas más seguro de cambiar.