.. _`File Datasources`:

.. _`org.sysess.sympathy.datasources.filedatasourcemultiple`:

File Datasources
````````````````

.. image:: datasource.svg
   :width: 48


Create datasources from filenames in a directory that matches the pattern.




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

Search the selected `directory` for filenames matching the search pattern
and output their absolute paths as datasources on the output port.

The `pattern` for matching filenames uses shell style wildcards (glob) with
special character: `?` for matching any single character, and `*` for
matching any characters. For more details, see
`fnmatch <https://docs.python.org/3/library/fnmatch.html#module-fnmatch>`_.

When `recursive` search is enabled, all subdirectories of the selected
directory will also be searched.

The output can be configured to `include` only files, only directories or
both files and directories.


Definition
::::::::::


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

    **port1**
        | Type: [datasource]
        | Description: Datasources with file paths



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

    **Directory** (directory)
        Directory where to search for files.
    **Include** (include_types)
        File types to include in the output
    **Recursive** (recursive)
        Recursive search in subdirectories.
    **Search pattern** (search_pattern)
        Pattern for matching filenames.





Related nodes
.............

* :ref:`org.sysess.sympathy.datasources.filedatasource`




Examples
........



Example flows demonstrating this node:

* :download:`InputOutputGenerate.syx </Examples/Sympathy for Data/InputOutputGenerate/InputOutputGenerate.syx>`




The node can be found in:

* :download:`LambdaOperations.syx </Examples/Sympathy for Data/Generic/Lambda/LambdaOperations.syx>`

* :download:`Types.syx </Examples/Sympathy for Data/Misc/Types.syx>`

* :download:`CalculatorAdvanced.syx </Examples/Sympathy for Data/Data Processing/Calculate/CalculatorAdvanced.syx>`

* :download:`image_binary_classification.syx </Examples/Advanced Machine Learning/image_binary_classification.syx>`

* :download:`tabular_binary_classification.syx </Examples/Advanced Machine Learning/tabular_binary_classification.syx>`




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

.. automodule:: node_file_datasource
    :noindex:

.. class:: FileDatasourceMultiple
    :noindex: