.. _auto_file_merge:

*FILE MERGE*
============

Concatenates or merges multiple files into a single output file. Use this worker when you need to combine several files from upstream workflow steps into one consolidated file for downstream processing or archiving.

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

Classification: **process**.

Tagged: ``combine``, ``concatenate``, ``file_merge``, ``files``, ``merge``, ``process``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Files to Merge
     - files
     - file
     - —
     - 
     - One or more files to be merged together; accepts any file type and can be left empty if files are provided dynamically by upstream workers.
   * - New file NameFiles to Merge
     - filename
     - text
     - —
     - 
     - Desired name for the resulting merged output file (e.g. 'combined_results.csv'); if left blank a default name will be assigned automatically.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Merged File
     - merged_file
     - file
     - The single consolidated file produced by merging all inputs; format and extension match the content of the provided source files.

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

- data.io.file

.. raw:: html

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