Skip to content

yasp-toolkit transfer

Move job inputs and results between your machine and yasp storage — streamed to or from presigned S3 URLs — and pull individual files out of the gzipped tar archives that embedded compile produces.

Usage:

$ yasp-toolkit transfer [OPTIONS] COMMAND [ARGS]...

Options: * --help: Show this message and exit.

Commands:

  • upload: Upload to a presigned S3 URL.
  • download: Download into .
  • extract: Extract the first member matching...

yasp-toolkit transfer upload

Upload to a presigned S3 URL.

Usage:

$ yasp-toolkit transfer upload [OPTIONS] {file_path} {target_url}
Argument Default Description
file_path required Local file to upload.
target_url required Presigned S3 PUT URL.
Option Default Description
--progress / --no-progress progress Render a progress bar.

yasp-toolkit transfer download

Download into .

Usage:

$ yasp-toolkit transfer download [OPTIONS] {target_url} {file_path}
Argument Default Description
target_url required Presigned S3 GET URL.
file_path required Local destination path.
Option Default Description
--progress / --no-progress progress Render a progress bar.

yasp-toolkit transfer extract

Extract the first member matching --suffix from a gzipped tar.

Silent on stdout when writing to a file — the bytes are the only thing written when -o - is used, so the command composes with pipes.

Example — pull the demo log out of a compile result:

yasp-toolkit transfer extract output.tgz --suffix /demo_run.log -o demo_run.log

Usage:

$ yasp-toolkit transfer extract [OPTIONS] {file}
Argument Default Description
file required Gzipped tar archive to read.
Option Default Description
--suffix <str> required Member-name suffix to match (e.g. /demo_run.log); matches the first regular file whose name ends with it.
-o, --output <filename> required Destination path, or - to write the raw bytes to stdout.