Herramientas de texto

Comparar dos bloques de texto es algo que la gente hace constantemente y casi siempre en un mal momento: una configuración que funciona en un host y no en otro, un cuerpo de respuesta que cambió entre despliegues, una cláusula de contrato que alguien editó sin control de cambios, una línea de registro que es casi, pero no del todo, la de ayer.

La tentación es echarle un vistazo. Eso funciona con tres líneas y falla en silencio con treinta, porque la atención humana es buenísima viendo lo que espera ver. Un diff no es una comodidad en esa situación; es la diferencia entre encontrar el cambio y convencerte de que no lo hay.

Lo que hace buena una herramienta de diff es la granularidad. La comparación por líneas es el valor por defecto adecuado y lo que te muestra el control de versiones, pero es activamente engañosa con dos clases de entrada: los archivos minificados o de una sola línea, donde el documento entero es una línea y el diff degenera en «esta línea cambió»; y las líneas largas de prosa, donde una edición de una palabra pinta un párrafo entero como reescrito. Los modos de palabra y de carácter existen justo para esos casos, y poder alternar entre los tres sin volver a pegar es la mayor parte del valor.

La otra mitad es que la salida tiene que ser portátil. Un diff que solo puedes mirar vale menos que uno que puedes entregar a otra persona, así que la exportación de parche unificado produce un parche estándar con cabeceras de hunk correctas —el formato que patch(1) acepta y el que una herramienta de revisión de código renderiza bien cuando lo pegas en un comentario.

El texto suele ser lo más delicado de este sitio. Un payload JSON suele ser datos de máquina; un diff de texto es con frecuencia un borrador de contrato, una nota interna, una cronología de un incidente o un correo de un cliente. Esa es la razón de que la comparación ocurra en tu navegador y no en un servidor: no como una función destacada, sino porque subir ese material a un host desconocido para responder una pregunta que podrías responder localmente es un mal negocio a cualquier precio.

Si las dos cosas que estás comparando son JSON en lugar de prosa, usa mejor Comparar JSON. Compara la estructura analizada en lugar del texto, así que reformatear y reordenar claves —lo que un diff de texto reporta como cientos de cambios— se muestra correctamente como ningún cambio en absoluto.