.. _auto_text_write_to_file:

*WRITE TEXT CONTENTS TO A FILE*
===============================

Writes a provided text string to a named file and returns the resulting file path. Use this worker whenever a workflow needs to persist plain-text content (logs, snippets, generated code, etc.) to disk for downstream consumption.

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

Classification: **process**.

Tagged: ``file``, ``persist``, ``plain-text``, ``save``, ``text``, ``write``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - File name
     - filename
     - scalar
     - —
     - 
     - Target file name (including extension, e.g. 'output.txt') to which the text will be written; leave blank to let the worker auto-generate a default name.
   * - Text to be written
     - texttobewritten
     - text
     - —
     - 
     - Plain-text content to write into the file; accepts any UTF-8 string — newlines and special characters are preserved as-is.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - text_write_to_file_output_1
     - text_write_to_file_output_1
     - text
     - Path or reference to the newly created file containing the written text; pass this to downstream file-read or archive workers.

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>text_write_to_file</code>. Schema hash: <code>f3ffa9f98c2e</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>