def test_localize_self_ref(
local_test_path,
gcs_j1_json_self_ref,
gcs_v41_json_self_ref,
gcs_v421_tsv_self_ref,
gcs_v5_csv_self_ref,
gcs_v6_txt_self_ref,
) -> Tuple[str, bool]:
"""Test detection of direct/indirect self reference
while localizing GCS files on local storage.
This is not only for detecting self references but also for any deep recursion
beyond the depth limit (10 by default)
Indirect self referencing in GCS files suffixed with _self_ref:
v1.json -> v421.tsv -> v1.json -> ...
"""
loc_prefix = os.path.join(local_test_path, "test_localize_self_ref")
# localization from remote storages
for j1_json in (gcs_j1_json_self_ref, ):
u_j1_json = AutoURI(j1_json)
loc_prefix_ = loc_prefix + u_j1_json.__class__.get_loc_suffix()
with pytest.raises(AutoURIRecursionError):
loc_uri, localized = AbsPath.localize(u_j1_json,
recursive=True,
loc_prefix=loc_prefix_)
def test_localize_mixed(
local_test_path,
mixed_j1_json,
mixed_v41_json,
mixed_v421_tsv,
mixed_v5_csv,
mixed_v6_txt,
) -> Tuple[str, bool]:
"""Test recursive localization of files on mixed storages
Target is local storage.
"""
loc_prefix = os.path.join(local_test_path, "test_localize_mixed")
# localization from remote storages
for j1_json in (mixed_j1_json, ):
u_j1_json = AutoURI(j1_json)
loc_prefix_ = loc_prefix + u_j1_json.__class__.get_loc_suffix()
loc_uri, localized = AbsPath.localize(u_j1_json,
recursive=True,
return_flag=True,
loc_prefix=loc_prefix_)
# check if all URIs defeind in localized JSON file exist
recurse_raise_if_uri_not_exist(loc_uri)
def test_abspath_localize(
local_test_path,
local_j1_json,
local_v41_json,
local_v421_tsv,
local_v5_csv,
local_v6_txt,
s3_j1_json,
s3_v41_json,
s3_v421_tsv,
s3_v5_csv,
s3_v6_txt,
gcs_j1_json,
gcs_v41_json,
gcs_v421_tsv,
gcs_v5_csv,
gcs_v6_txt,
url_j1_json,
url_v41_json,
url_v421_tsv,
url_v5_csv,
url_v6_txt,
) -> Tuple[str, bool]:
"""Recursive localization is supported for the following file extensions:
.json:
Files defined only in values (not keys) can be recursively localized.
.tsv/.csv:
Files defined in all values can be recursively localized.
This function will test localizing j1.json file on each remote storage.
This JSON file has file paths including .tsv and .csv, which also include
other files in its contents.
Therefore, when the recursive flag is on, all files in these JSON, TSV, CSV
files should be localized recursively with correct file names
(controlled by cls.loc_prefix and cls.loc_suffix).
Filenaming for (recursive) localization:
cls.loc_prefix + remote_file_path_without_scheme + cls.loc_suffix (for recursvely only)
For example,
s3://test-bucket/j1.json has some file paths on s3://.
With recursive localization, all these files must be localized on /tmp/user/loc_prefix/ with
a correct directory structure (keeping original structure on source: i.e. bucket name, path)
and the name of the JSON file should be j1.local.json since contents of this file should be
modified to point to localized files in it. This is recursively done for all files in it too.
Without recursive localization, autouri doesn't look inside that JSON file and just localize
the file itself alone on /tmp/user/loc_prefix/ while keeping the same filename j1.local.json.
Test localizing on a local storage from the following remote storages:
local_test_path: local -> local
s3_test_path: s3 -> local
gcs_test_path: gcs -> local
url_test_path: url -> local
Parameters to be tested:
make_md5_file:
Make md5 file on destination only when it's REQUIRED.
It's required only if we need to compare md5 hash of source and target.
This is already tested cp and it's actually needed for local storage.
Cloud URIs will provide md5 hash info in their metadata so md5 file
is not required and hence will not be created even with this flag on.
recursive:
j1.json
"""
loc_prefix = os.path.join(local_test_path, "test_abspath_localize")
for j1_json in (local_j1_json, ):
# localization from local storage
u_j1_json = AutoURI(j1_json)
loc_prefix_ = loc_prefix + u_j1_json.__class__.get_loc_suffix()
# for localization both with or without recursive
# nothing should be localized actually
# since they are already on a local storage
# so loc_prefix directory itself shouldn't be created
loc_uri, localized = AbsPath.localize(u_j1_json,
recursive=False,
return_flag=True,
loc_prefix=loc_prefix_)
assert loc_uri == u_j1_json.uri and not localized
assert not os.path.exists(loc_prefix)
loc_uri, localized = AbsPath.localize(u_j1_json,
recursive=True,
return_flag=True,
loc_prefix=loc_prefix_)
assert loc_uri == u_j1_json.uri and not localized
assert not os.path.exists(loc_prefix)
# check if all URIs defeind in localized JSON file exist
recurse_raise_if_uri_not_exist(loc_uri)
# localization from remote storages
for j1_json in (gcs_j1_json, s3_j1_json, url_j1_json):
u_j1_json = AutoURI(j1_json)
loc_prefix_ = loc_prefix + u_j1_json.__class__.get_loc_suffix()
loc_uri, localized = AbsPath.localize(u_j1_json,
recursive=False,
return_flag=True,
loc_prefix=loc_prefix_)
assert loc_uri == os.path.join(loc_prefix_, u_j1_json.loc_dirname,
u_j1_json.basename)
assert localized and os.path.exists(loc_uri)
loc_uri, localized = AbsPath.localize(u_j1_json,
recursive=True,
return_flag=True,
loc_prefix=loc_prefix_)
assert loc_uri == os.path.join(
loc_prefix_,
u_j1_json.loc_dirname,
u_j1_json.basename_wo_ext + AbsPath.get_loc_suffix() +
u_j1_json.ext,
)
assert localized and os.path.exists(loc_uri)
# check if all URIs defeind in localized JSON file exist
recurse_raise_if_uri_not_exist(loc_uri)
