Skip to main content
show_files(paths=None, options=)[source]

Shows information about files in KiFS. Can be used for individual files, or to show all files in a given directory.

Parameters

paths (list of str) –

File paths to show. Each path can be a KiFS directory name, or a full path to a KiFS file. File paths may contain wildcard characters after the KiFS directory delimiter.

Accepted wildcard characters are asterisk (*) to represent any string of zero or more characters, and question mark (?) to indicate a single character. The user can provide a single element (which will be automatically promoted to a list internally) or a list.

options (dict of str to str) –

Optional parameters. The default value is an empty dict ( ).

Returns

A dict with the following entries–

file_names (list of str) –

A listing of files in the paths specified.

sizes (list of longs) –

Size of each file, in bytes.

users (list of str) –

User that created the file.

creation_times (list of longs) –

Creation time for each file, in milliseconds since epoch.

info (dict of str to str) –

Additional information. Allowed keys are:

  • multipart_uploads – JSON-encoded information about multipart uploads in progress.