.. _stdlib_das_source_formatter_fio:

================================
File-based source code formatter
================================

.. das:module:: das_source_formatter_fio

The DAS_SOURCE_FORMATTER_FIO module extends the source formatter with file I/O
capabilities, enabling formatting of daslang source files on disk.
It reads, formats, and writes back source files in place or to new locations.

All functions and symbols are in "das_source_formatter_fio" module, use require to get access to it.

.. code-block:: das

    require daslib/das_source_formatter_fio



+++++++++++++++
File formatting
+++++++++++++++

  *  :ref:`format_file (file_name: string) <function-das_source_formatter_fio_format_file_string>`
  *  :ref:`format_files (file_names: array\<string\>) <function-das_source_formatter_fio_format_files_array_ls_string_gr_>`

.. _function-das_source_formatter_fio_format_file_string:

.. das:function:: format_file(file_name: string)

Reads a daslang source file, formats it, and writes the result back if changed.


:Arguments: * **file_name** : string

.. _function-das_source_formatter_fio_format_files_array_ls_string_gr_:

.. das:function:: format_files(file_names: array<string>)

Formats multiple daslang source files in place.


:Arguments: * **file_names** : array<string>