niquery.io.utils module

niquery.io.utils.append_label_to_filename(in_filename: Path, label: str) → Path

Compose a new path by appending the label tag to the file rootname.

Parameters:

• in_filename (Path) – Filename.

• label (str) – Label tag.

Returns:

Composed filename.

Return type:

Path

niquery.io.utils.write_dataset_file_lists(file_dict: dict, dirname: Path, sep: str) → None

Write each dataset’s list of files to a TSV file.

Writes each file list as a TSV named <dataset_id>.tsv, and uses dict keys as columns. Skips entries with empty lists.

Parameters:

• file_dict (dict) – A mapping from dataset ID to a list of file metadata dicts.

• dirname (Path) – Directory where TSV files will be written.

• sep (str) – Separator.

niquery.io.utils.write_dataset_paths(dataset_paths: list, fname: Path, sep: str) → None

Write dataset tag dictionaries to a TSV file.

Parameters:

• dataset_paths (list) – Dictionaries of dataset ID and fullpath.

• fname (Path) – Filename.

• sep (str) – Separator.

niquery.io.utils.write_dataset_tags(dataset_tags: list, fname: Path, sep: str) → None

Write dataset tag dictionaries to a TSV file.

Parameters:

• dataset_tags (list) – Dictionaries of dataset ID and snapshot tags.

• fname (Path) – Filename.

• sep (str) – Separator.