Threadline.Storage.S3 (Threadline v0.12.0)

Copy Markdown View Source

Stores Threadline exports in S3-compatible object storage.

Use this optional Threadline.Storage adapter when export files must be available across nodes. Add the optional :ex_aws, :ex_aws_s3, :req, and :sweet_xml dependencies to the host project, then configure the adapter and its required bucket:

config :threadline, storage_adapter: Threadline.Storage.S3
config :threadline, Threadline.Storage.S3, bucket: "my-audit-exports"

Module-keyed options are merged with per-call options, with per-call values taking precedence. Supported runtime options are:

  • :bucket - required non-empty bucket name
  • :expires_in - presigned-download lifetime in seconds; defaults to 900
  • :presigned_url_opts - options forwarded while creating the download URL
  • :ex_aws_request_opts - request overrides passed to ExAws.request/2; defaults to [http_client: ExAws.Request.Req]

put/2 uploads the binary content it receives; it does not interpret a binary as a local filename. path/1 returns {:error, :not_local}, so export delivery uses a presigned URL. Missing dependencies or bucket configuration fail init/1; request and presigning failures are returned as descriptive errors.