0.1.dev2192+g7c539c3.d20250403

flytekit.core.data_persistence

The Data persistence module is used by core flytekit and most of the core TypeTransformers to manage data fetch & store, between the durable backend store and the runtime environment. This is designed to be a pluggable system, with a default simple implementation that ships with the core.

Class	Description
`FileAccessProvider`	This is the class that is available through the FlyteContext and can be used for persisting data to the remote.

Method	Description
`azure_setup_args()`
`get_additional_fsspec_call_kwargs()`	These are different from the setup args functions defined above.
`get_fsspec_storage_options()`
`s3_setup_args()`

Property	Type	Description
`default_local_file_access_provider`	`FileAccessProvider`
`flyte_tmp_dir`	`str`

Methods

azure_setup_args()

        
    
def azure_setup_args(
    azure_cfg: flytekit.configuration.AzureBlobStorageConfig,
    anonymous: bool,
) -> typing.Dict[str, typing.Any]

Parameter	Type
`azure_cfg`	`flytekit.configuration.AzureBlobStorageConfig`
`anonymous`	`bool`

get_additional_fsspec_call_kwargs()

        
    
def get_additional_fsspec_call_kwargs(
    protocol: typing.Union[str, tuple],
    method_name: str,
) -> typing.Dict[str, typing.Any]

These are different from the setup args functions defined above. Those kwargs are applied when asking fsspec to create the filesystem. These kwargs returned here are for when the filesystem’s methods are invoked.

Parameter	Type
`protocol`	`typing.Union[str, tuple]`
`method_name`	`str`

get_fsspec_storage_options()

        
    
def get_fsspec_storage_options(
    protocol: str,
    data_config: typing.Optional[flytekit.configuration.DataConfig],
    anonymous: bool,
    kwargs,
) -> typing.Dict[str, typing.Any]

Parameter	Type
`protocol`	`str`
`data_config`	`typing.Optional[flytekit.configuration.DataConfig]`
`anonymous`	`bool`
`kwargs`	`**kwargs`

s3_setup_args()

        
    
def s3_setup_args(
    s3_cfg: flytekit.configuration.S3Config,
    anonymous: bool,
) -> typing.Dict[str, typing.Any]

Parameter	Type
`s3_cfg`	`flytekit.configuration.S3Config`
`anonymous`	`bool`

flytekit.core.data_persistence.FileAccessProvider

This is the class that is available through the FlyteContext and can be used for persisting data to the remote durable store.

        
    
class FileAccessProvider(
    local_sandbox_dir: typing.Union[str, os.PathLike],
    raw_output_prefix: str,
    data_config: typing.Optional[flytekit.configuration.DataConfig],
    execution_metadata: typing.Optional[dict],
)

Parameter	Type
`local_sandbox_dir`	`typing.Union[str, os.PathLike]`
`raw_output_prefix`	`str`
`data_config`	`typing.Optional[flytekit.configuration.DataConfig]`
`execution_metadata`	`typing.Optional[dict]`

Methods

Method	Description
`async_get_data()`	.
`async_put_data()`	The implication here is that we’re always going to put data to the remote location, so we .
`async_put_raw_data()`	This is a more flexible version of put that accepts a file-like object or a string path.
`download()`	Downloads from remote to local.
`download_directory()`	Downloads directory from given remote to local path.
`exists()`
`generate_new_custom_path()`	Generates a new path with the raw output prefix and a random string appended to it.
`get()`
`get_async_filesystem_for_path()`
`get_data()`	.
`get_file_tail()`
`get_filesystem()`
`get_filesystem_for_path()`
`get_random_local_directory()`
`get_random_local_path()`	Use file_path_or_file_name, when you want a random directory, but want to preserve the leaf file name.
`get_random_remote_directory()`
`get_random_remote_path()`
`get_random_string()`
`is_remote()`	Deprecated.
`join()`
`put_data()`	The implication here is that we’re always going to put data to the remote location, so we .
`put_raw_data()`	This is a more flexible version of put that accepts a file-like object or a string path.
`recursive_paths()`
`sep()`
`strip_file_header()`	Drops file:// if it exists from the file.
`upload()`	.
`upload_directory()`	.

async_get_data()

        
    
def async_get_data(
    remote_path: str,
    local_path: str,
    is_multipart: bool,
    kwargs,
)

Parameter	Type
`remote_path`	`str`
`local_path`	`str`
`is_multipart`	`bool`
`kwargs`	`**kwargs`

async_put_data()

        
    
def async_put_data(
    local_path: typing.Union[str, os.PathLike],
    remote_path: str,
    is_multipart: bool,
    kwargs,
) -> str

The implication here is that we’re always going to put data to the remote location, so we .remote to ensure we don’t use the true local proxy if the remote path is a file://

Parameter	Type
`local_path`	`typing.Union[str, os.PathLike]`
`remote_path`	`str`
`is_multipart`	`bool`
`kwargs`	`**kwargs`

async_put_raw_data()

        
    
def async_put_raw_data(
    lpath: typing.Union[str, os.PathLike, pathlib._local.Path, bytes, _io.BufferedReader, _io.BytesIO, _io.StringIO],
    upload_prefix: typing.Optional[str],
    file_name: typing.Optional[str],
    read_chunk_size_bytes: int,
    encoding: str,
    skip_raw_data_prefix: bool,
    kwargs,
) -> n: Returns the final path data was written to.

This is a more flexible version of put that accepts a file-like object or a string path. Writes to the raw output prefix only. If you want to write to another fs use put_data or get the fsspec file system directly. FYI: Currently the raw output prefix set by propeller is already unique per retry and looks like s3://my-s3-bucket/data/o4/feda4e266c748463a97d-n0-0

If lpath is a folder, then recursive will be set. If lpath is a streamable, then it can only be a single file.

Writes to: {raw output prefix}/{upload_prefix}/{file_name}

Parameter	Type
`lpath`	`typing.Union[str, os.PathLike, pathlib._local.Path, bytes, _io.BufferedReader, _io.BytesIO, _io.StringIO]`
`upload_prefix`	`typing.Optional[str]`
`file_name`	`typing.Optional[str]`
`read_chunk_size_bytes`	`int`
`encoding`	`str`
`skip_raw_data_prefix`	`bool`
`kwargs`	`**kwargs`

download()

        
    
def download(
    remote_path: str,
    local_path: str,
    kwargs,
)

Downloads from remote to local

Parameter	Type
`remote_path`	`str`
`local_path`	`str`
`kwargs`	`**kwargs`

download_directory()

        
    
def download_directory(
    remote_path: str,
    local_path: str,
    kwargs,
)

Downloads directory from given remote to local path

Parameter	Type
`remote_path`	`str`
`local_path`	`str`
`kwargs`	`**kwargs`

exists()

        
    
def exists(
    path: str,
) -> bool

Parameter	Type
`path`	`str`

generate_new_custom_path()

        
    
def generate_new_custom_path(
    fs: typing.Optional[fsspec.spec.AbstractFileSystem],
    alt: typing.Optional[str],
    stem: typing.Optional[str],
) -> n: The new path.

Generates a new path with the raw output prefix and a random string appended to it. Optionally, you can provide an alternate prefix and a stem. If stem is provided, it will be appended to the path instead of a random string. If alt is provided, it will replace the first part of the output prefix, e.g. the S3 or GCS bucket.

If wanting to write to a non-random prefix in a non-default S3 bucket, this can be called with alt=“my-alt-bucket” and stem=“my-stem” to generate a path like s3://my-alt-bucket/default-prefix-part/my-stem

Parameter	Type
`fs`	`typing.Optional[fsspec.spec.AbstractFileSystem]`
`alt`	`typing.Optional[str]`
`stem`	`typing.Optional[str]`

get()

        
    
def get(
    from_path: str,
    to_path: str,
    recursive: bool,
    kwargs,
)

Parameter	Type
`from_path`	`str`
`to_path`	`str`
`recursive`	`bool`
`kwargs`	`**kwargs`

get_async_filesystem_for_path()

        
    
def get_async_filesystem_for_path(
    path: str,
    anonymous: bool,
    kwargs,
) -> typing.Union[fsspec.asyn.AsyncFileSystem, fsspec.spec.AbstractFileSystem]

Parameter	Type
`path`	`str`
`anonymous`	`bool`
`kwargs`	`**kwargs`

get_data()

        
    
def get_data(
    remote_path: str,
    local_path: str,
    is_multipart: bool,
    kwargs,
)

Parameter	Type
`remote_path`	`str`
`local_path`	`str`
`is_multipart`	`bool`
`kwargs`	`**kwargs`

get_file_tail()

        
    
def get_file_tail(
    file_path_or_file_name: str,
) -> str

Parameter	Type
`file_path_or_file_name`	`str`

get_filesystem()

        
    
def get_filesystem(
    protocol: typing.Optional[str],
    anonymous: bool,
    path: typing.Optional[str],
    kwargs,
) -> fsspec.spec.AbstractFileSystem

Parameter	Type
`protocol`	`typing.Optional[str]`
`anonymous`	`bool`
`path`	`typing.Optional[str]`
`kwargs`	`**kwargs`

get_filesystem_for_path()

        
    
def get_filesystem_for_path(
    path: str,
    anonymous: bool,
    kwargs,
) -> fsspec.spec.AbstractFileSystem

Parameter	Type
`path`	`str`
`anonymous`	`bool`
`kwargs`	`**kwargs`

get_random_local_directory()

def get_random_local_directory()

get_random_local_path()

        
    
def get_random_local_path(
    file_path_or_file_name: typing.Optional[str],
) -> str

Use file_path_or_file_name, when you want a random directory, but want to preserve the leaf file name

Parameter	Type
`file_path_or_file_name`	`typing.Optional[str]`

get_random_remote_directory()

def get_random_remote_directory()

get_random_remote_path()

        
    
def get_random_remote_path(
    file_path_or_file_name: typing.Optional[str],
) -> str

Parameter	Type
`file_path_or_file_name`	`typing.Optional[str]`

get_random_string()

def get_random_string()

is_remote()

        
    
def is_remote(
    path: typing.Union[str, os.PathLike],
) -> bool

Deprecated. Let’s find a replacement

Parameter	Type
`path`	`typing.Union[str, os.PathLike]`

join()

        
    
def join(
    args: `*args`,
    unstrip: bool,
    fs: typing.Optional[fsspec.spec.AbstractFileSystem],
) -> str

Parameter	Type
`args`	`*args`
`unstrip`	`bool`
`fs`	`typing.Optional[fsspec.spec.AbstractFileSystem]`

put_data()

        
    
def put_data(
    local_path: typing.Union[str, os.PathLike],
    remote_path: str,
    is_multipart: bool,
    kwargs,
) -> str

The implication here is that we’re always going to put data to the remote location, so we .remote to ensure we don’t use the true local proxy if the remote path is a file://

Parameter	Type
`local_path`	`typing.Union[str, os.PathLike]`
`remote_path`	`str`
`is_multipart`	`bool`
`kwargs`	`**kwargs`

put_raw_data()

        
    
def put_raw_data(
    lpath: typing.Union[str, os.PathLike, pathlib._local.Path, bytes, _io.BufferedReader, _io.BytesIO, _io.StringIO],
    upload_prefix: typing.Optional[str],
    file_name: typing.Optional[str],
    read_chunk_size_bytes: int,
    encoding: str,
    skip_raw_data_prefix: bool,
    kwargs,
) -> n: Returns the final path data was written to.

If lpath is a folder, then recursive will be set. If lpath is a streamable, then it can only be a single file.

Writes to: {raw output prefix}/{upload_prefix}/{file_name}

Parameter	Type
`lpath`	`typing.Union[str, os.PathLike, pathlib._local.Path, bytes, _io.BufferedReader, _io.BytesIO, _io.StringIO]`
`upload_prefix`	`typing.Optional[str]`
`file_name`	`typing.Optional[str]`
`read_chunk_size_bytes`	`int`
`encoding`	`str`
`skip_raw_data_prefix`	`bool`
`kwargs`	`**kwargs`

recursive_paths()

        
    
def recursive_paths(
    f: str,
    t: str,
) -> typing.Tuple[str, str]

Parameter	Type
`f`	`str`
`t`	`str`

sep()

        
    
def sep(
    file_system: typing.Optional[fsspec.spec.AbstractFileSystem],
) -> str

Parameter	Type
`file_system`	`typing.Optional[fsspec.spec.AbstractFileSystem]`

strip_file_header()

        
    
def strip_file_header(
    path: str,
    trim_trailing_sep: bool,
) -> str

Drops file:// if it exists from the file

Parameter	Type
`path`	`str`
`trim_trailing_sep`	`bool`

upload()

        
    
def upload(
    file_path: str,
    to_path: str,
    kwargs,
)

Parameter	Type
`file_path`	`str`
`to_path`	`str`
`kwargs`	`**kwargs`

upload_directory()

        
    
def upload_directory(
    local_path: str,
    remote_path: str,
    kwargs,
)

Parameter	Type
`local_path`	`str`
`remote_path`	`str`
`kwargs`	`**kwargs`

Properties

Property	Type	Description
`data_config`
`local_access`
`local_sandbox_dir`		This is a context based temp dir.
`raw_output_fs`		Returns a file system corresponding to the provided raw output prefix
`raw_output_prefix`

On this page

flytekit.core.data_persistence

Directory

Classes

Methods

Variables

Methods

azure_setup_args()

get_additional_fsspec_call_kwargs()

get_fsspec_storage_options()

s3_setup_args()

flytekit.core.data_persistence.FileAccessProvider

Methods

async_get_data()

async_put_data()

async_put_raw_data()

download()

download_directory()

exists()

generate_new_custom_path()

get()

get_async_filesystem_for_path()

get_data()

get_file_tail()

get_filesystem()

get_filesystem_for_path()

get_random_local_directory()

get_random_local_path()

get_random_remote_directory()

get_random_remote_path()

get_random_string()

is_remote()

join()

put_data()

put_raw_data()

recursive_paths()

sep()

strip_file_header()

upload()

upload_directory()

Properties