FoundryDataSidecarFileSystem: 경량 파일시스템

transforms.api.FoundryDataSidecarFileSystem은 경량 단일 노드 변환에서 데이터셋의 원시 파일을 읽고 씁니다. 파일 접근에는 FoundryDataSidecarFile을 사용합니다.

transforms.api.FoundryDataSidecarFileSystem(
    param, read_only=False, read_mode="current",
)

ls

ls(glob=None, regex=".*", show_hidden=False)

데이터셋 루트에서 모든 디렉터리를 재귀적으로 탐색하여 패턴에 맞는 파일을 나열합니다.

인자	형식	기본값과 의미
`glob`	str	Unix 파일 패턴, globstar 지원. 기본값 None
`regex`	str	파일 이름에 적용하는 정규식. 기본값 .*
`show_hidden`	bool	점 또는 밑줄로 시작하는 숨김 파일 포함 여부. 기본값 False

논리 경로, 파일 크기와 수정 시각을 담은 FileStatus를 내보냅니다. 파일 메타데이터와 실제 파일 스트림을 구분합니다.

open(path, mode="r", **kwargs)

path는 데이터셋 안의 논리 파일 경로이며 기본 모드는 읽기입니다. 나머지 키워드 인자는 io.open으로 전달합니다. 스트림에 연결된 Python 파일 유사 객체를 반환합니다.

파일을 with 문으로 열고 닫는 것이 권장되며, 특히 쓰기에서 수명 관리가 중요합니다. 원시 파일을 형식과 관계없이 복사할 때는 rb와 wb를 사용하여 바이트를 보존합니다. 파일 복사 예시는 이 인터페이스를 사용합니다.