tabsdata.LocalFileSource#

class LocalFileSource(path: str | List[str], format: str | dict | FileFormat = None, initial_last_modified: str | datetime = None)[source]#

Bases: Input

Class for managing the configuration of local-file-based data inputs.

format#

The format of the file. If not provided, it will be inferred from the file extension of the data.

Type:

FileFormat

path#

The path where the files can be found. It can be a single path or a list of paths.

Type:

str | List[str]

initial_last_modified#

If not None, only the files modified after this date and time will be considered.

Type:

str | None

to_dict()[source]#

Converts the LocalFileSource object to a dictionary.

__init__(path: str | List[str], format: str | dict | FileFormat = None, initial_last_modified: str | datetime = None)[source]#
Initializes the LocalFileSource with the given path, and optionally a format and

a date and time after which the files were modified.

Parameters:

  • path (str | List[str]) – The path where the files can be found. It can be a single path or a list of paths.

  • format (str | dict | FileFormat, optional) – The format of the file. If not provided, it will be inferred from the file extension of the data. Can be either a string with the format, a FileFormat object or a dictionary with the format as the ‘type’ key and any additional format-specific information. Currently supported formats are ‘csv’, ‘parquet’, ‘ndjson’, ‘jsonl’ and ‘log’.

  • initial_last_modified (str | datetime.datetime, optional) – If provided, only the files modified after this date and time will be considered. The date and time can be provided as a string in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) or as a datetime object. If no timezone is provided, UTC will be assumed.

Raises:

  • InputConfigurationError –

  • FormatConfigurationError –

Methods

__init__(path[, format, initial_last_modified])

Initializes the LocalFileSource with the given path, and optionally a format and

Attributes

format

The format of the file or files.

initial_last_modified

The date and time after which the files were modified.

path

The path or paths to the files to load.