.. _`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.

*Ports*:

    **Inputs**:

        :port1: [datasource]

            Files to be renamed
        :port2: table

            List of new filenames

    **Outputs**:

        :port1: [datasource]

            Renamed files

*Configuration*:

    **current**
        The column with the current file names
    **new**
        The column with the new filenames
    **error**
        If a file operation fails, do not raise an exception

.. automodule:: node_file_operations

.. class:: RenameFilesWithTable