Validar un formato sin inventar otro
Un control previo puede aprobar archivos que su consumidor rechaza. Cómo compartir el parser sin confundir formato válido con contenido suficiente.
Al agregar un control antes de dar una tarea por terminada, apareció una decisión pequeña: cómo leer el documento que debía respaldarla. El programa que consumía ese documento ya tenía un parser. El control nuevo podía usarlo o escribir su propia interpretación del formato.
Copiar unas reglas parecía más sencillo que incorporar una dependencia. Pero dejaba dos lugares capaces de decidir qué significaba el mismo archivo. Si uno aceptaba algo que el otro ignoraba, el control podía aprobar un documento que después no servía.
La decisión fue reutilizar el parser existente y agregar las condiciones del control sobre su resultado. La revisión del código permite comprobar esa separación. No demuestra que hayan desaparecido todos los errores del circuito.
Dos preguntas que conviene separar
Un parser transforma texto en una estructura que otro programa puede usar. Según su contrato, también rechaza entradas inválidas o devuelve errores. El control que viene después necesita responder otra pregunta: si esa estructura alcanza para la operación que se quiere hacer.
Un documento puede tener un formato válido y no contener la información requerida. También puede incluir todas las palabras esperadas y estar escrito de una manera que el consumidor no reconoce.
Pensá en un ejemplo hipotético: un archivo describe ejercicios de un curso. Para habilitar uno, necesitás que tenga una consigna y una solución. Buscar las palabras consigna y solución en el texto no alcanza: podrían aparecer en un comentario o pertenecer a ejercicios distintos. Tampoco alcanza con que el archivo se pueda leer sin errores; quizás el ejercicio elegido todavía no tiene solución.
El orden útil es:
- Interpretar el archivo con las reglas de quien lo consume.
- Rechazar los errores que ese contrato considere invalidantes.
- Buscar en la estructura el elemento que corresponde a la operación.
- Comprobar sus requisitos específicos antes de avanzar.
Así, la sintaxis se define en un lugar y la condición para avanzar se expresa donde hace falta.
Qué cuesta cada alternativa
Una búsqueda de texto sirve para una advertencia aproximada. Si vas a usarla para autorizar un cambio de estado, sus límites pesan más: encontrar una palabra no demuestra que el programa la interprete como un campo.
Copiar el parser evita depender de otro módulo, pero exige mantener dos implementaciones. Cada extensión del formato necesita llegar a ambas. Aunque hoy den el mismo resultado, la próxima modificación puede separarlas.
Reutilizar el parser reduce esa duplicación. A cambio, el control queda sujeto a su interfaz, sus dependencias y su versión. Si para importarlo hay que iniciar toda una aplicación, conviene extraer la lectura del formato a un módulo que pueda ejecutarse por separado. Compartir código no debería obligarte a arrancar servicios ajenos a la comprobación.
Otra opción es consultar una API de validación. Puede ser adecuada si el consumidor es remoto o usa otro lenguaje. Agrega disponibilidad, permisos y compatibilidad de versiones al problema. No hace falta montar ese servicio cuando una función compartida alcanza.
En el cambio revisado, el control importaba el parser del programa consumidor. Leía el documento desde la misma revisión de código preparada para esa comprobación y aplicaba después una función con los requisitos propios de la operación. Esa función rechazaba tanto los errores de formato como la falta del contenido requerido.
Compartir código no alcanza si cambian las versiones
Dos programas pueden importar un módulo con el mismo nombre y ejecutar versiones diferentes. Por eso, decir “usamos el mismo parser” deja una pregunta abierta: cuál.
Para que una validación sea reproducible, conviene registrar qué documento se leyó y con qué versión del parser. Si validás contra una revisión más nueva que la desplegada, la aprobación sólo habla de esa revisión más nueva.
Esto también limita el significado de un resultado verde. Puede confirmar que una entrada cumple el contrato elegido. No confirma que el destino ya use ese contrato, que un recurso enlazado exista o que una persona entienda el contenido.
En el ejemplo del curso, una solución presente y bien formada podría ser incorrecta. El parser no corrige el ejercicio.
Qué comprobó la revisión
La lectura del cambio mostró la importación del parser existente, el paso de su resultado al control adicional y la comprobación antes de actualizar el estado. También se inspeccionaron tests con estructuras construidas a mano: contemplaban errores de formato, contenido faltante y un caso completo.
Esos tests sirven para revisar la condición adicional, pero no prueban por sí solos que un archivo real atraviese correctamente el parser y el resto del circuito. En esta revisión no se ejecutó la suite ni una prueba de punta a punta. No corresponde presentar la existencia de los tests como un resultado de ejecución.
Para comprobar una implementación de este diseño, podés sumar un ensayo con archivos mínimos reales:
- Un archivo válido y suficiente debe pasar por el parser real y habilitar la operación de prueba.
- Uno válido pero incompleto debe quedar rechazado por la condición adicional.
- Uno inválido no debe aprobarse aunque contenga las palabras esperadas.
- Un archivo escrito para una versión distinta debe producir el resultado definido por la política de compatibilidad, no una aprobación accidental.
Estas son pruebas propuestas. Conviene ejecutarlas en un entorno aislado y verificar también que los rechazos no cambien el estado que protegen.
Antes de escribir otra expresión regular
Buscá dónde se interpreta el formato que querés validar. Si ya existe esa función, evaluá reutilizarla antes de escribir una versión abreviada.
Después definí por separado qué le exigís al resultado para permitir la operación. Esa separación deja más claro qué falló: el archivo no se pudo interpretar, se interpretó pero está incompleto, o cumple el control elegido. Y evita que una validación auxiliar termine inventando otro formato sin que nadie lo haya decidido.