.. _`Copy file`:

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

Copy file
`````````

.. image:: copy.svg
   :width: 48


Copy a file to another location.




Documentation
:::::::::::::

Copy a file from Datasource PATH to a destination. Missing directories will
be created if possible. It is possible to modify the destination of the
copy using a regular expression (regex). For more information about how to
write regex, see :ref:`appendix_regex`.


Definition
::::::::::


Input ports
...........

    **port1**  datasource
        Datasource of file to be copied


Output ports
............

    **port1**  datasource
        Datasource of copied file




Configuration
.............

    **Do not raise exceptions** (error)
        If a file operation fails, do not raise an exception
    **Filename** (filename)
        Manually enter a filename, if not using a regular expression
    **Search** (pattern)
        Specify the regular expression that will be used for matching. Learn more about Regular expression syntax in the documentation appendix.
    **Replace** (replace)
        The string to replace the match found with the regular expression
    **Regex** (use_regex)
        Turn on/off naming using a regular expression







Examples
........

* :download:`FileOperations.syx </Examples/Sympathy/Disk/File/FileOperations.syx>`




Implementation
..............

.. automodule:: node_file_operations
    :noindex:

.. class:: CopyFile
    :noindex: