.. _auto_file_info:

*EXTRACT FILE PROPERTIES*
=========================

Extracts a single metadata property from a file attached to the workflow. Choose the desired property via Info Type — options include file size, extension, MIME type, creation/modification timestamps, and first/last lines of content. Use this worker whenever a downstream step needs a file attribute rather than the file contents itself.

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

Classification: **process**.

Tagged: ``extension``, ``file``, ``file_info``, ``head``, ``metadata``, ``mime_type``, ``process``, ``size``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - File Name
     - filename
     - view
     - —
     - 
     - The workflow file view to inspect; connect the output of a file-producing worker or upload a file directly — leave unset to have the worker operate on a file resolved at runtime.
   * - Info Type
     - info_type
     - string
     - size
     - 
     - The file property to extract: 'size' (bytes), 'extension' (e.g. '.csv'), 'type' (MIME type), 'created_on' (creation timestamp), 'updated_on' (last-modified timestamp), 'head' (first lines of text content), or 'tail' (last lines of text content); defaults to 'size'.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - file_info_output_1
     - file_info_output_1
     - mixed
     - The extracted file property value — type varies by Info Type selection: a numeric byte count for 'size', a string for 'extension'/'type', an ISO-8601 timestamp string for 'created_on'/'updated_on', or a text excerpt for 'head'/'tail'.

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