.. _`Rename Files with Table`:

.. _`org.sysess.sympathy.files.renamefileswithtable`:

Rename Files with Table
~~~~~~~~~~~~~~~~~~~~~~~

.. image:: rename.svg
   :width: 48


Using a table with old names and new names in two columns, this node
renames files in the same folder as the input datasources.
The datasources can point to multiple files in different directories.
The column with the current filenames can be an absolute or relative path,
but the column with the new names should only contain the filename, with no
directory prefix. If a prefix is present it will be discarded.

*Input ports*:
    :port1: [datasource]

        Files to be renamed
    :port2: table

        List of new filenames

*Output ports*:
    :port1: [datasource]

        Renamed files

*Configuration*:
    **Current filenames** (current)
        The column with the current file names
    **New filenames** (new)
        The column with the new filenames
    **Do not raise exceptions** (error)
        If a file operation fails, do not raise an exception

.. automodule:: node_file_operations

.. class:: RenameFilesWithTable