.. _auto_text_diff:

*COMPUTE THE DIFFERENCE BETWEEN TWO TESTS*
==========================================

Computes a line-by-line text difference between two strings (or file paths), returning the diff result as a single text output. Use this worker to compare configuration files, keyword decks, or any text content within a workflow and surface what changed between two versions.

When to use
-----------

Classification: **process**.

Tagged: ``comparison``, ``delta``, ``diff``, ``process``, ``string``, ``text``, ``text_diff``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Text 1
     - text1
     - text
     - —
     - 
     - First text string or file path to compare; leave empty if no baseline is available.
   * - Text 2
     - text2
     - text
     - —
     - 
     - Second text string or file path to compare against Text 1; leave empty if no candidate is available.
   * - Trim
     - trim_c
     - text
     - —
     - 
     - Characters to strip from both inputs before computing the diff (e.g. whitespace or newline chars); leave blank to skip trimming.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - text_diff_output_1
     - text_diff_output_1
     - text
     - Plain-text diff result showing lines added, removed, or changed between Text 1 and Text 2; empty string if the inputs are identical.

Disciplines
-----------

- data.dataset.transform

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>transformation</code> schema. Worker id: <code>text_diff</code>. Schema hash: <code>b69aae984492</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>