Behaviour and dispatch helpers for CSV export storage adapters.

Storage adapters persist generated CSV content and return a path that can be saved on HawkEx.CSV.Export. The path is adapter-specific: local storage returns a filesystem path, while S3 storage returns an s3://... URI.

HawkEx ships two adapters:

• HawkEx.CSV.Storage.Local - writes to local disk (default).
• HawkEx.CSV.Storage.S3 - writes to S3 (requires ex_aws).

Configuration

# Local disk (default)
config :hawk_ex,
  csv_storage: {HawkEx.CSV.Storage.Local, path: "priv/exports"}

# S3
config :hawk_ex,
  csv_storage: {HawkEx.CSV.Storage.S3,
    bucket: "my-bucket",
    prefix: "exports/"}

Custom adapters

Implement this behaviour to support other storage backends:

defmodule MyApp.CSV.GCSStorage do
  @behaviour HawkEx.CSV.Storage

  @impl true
  def write(filename, content, opts) do
    bucket = Keyword.fetch!(opts, :bucket)
    # write to GCS
    {:ok, "gs://#{bucket}/#{filename}"}
  end

  @impl true
  def read(path, opts) do
    # read from GCS
    {:ok, content}
  end

  @impl true
  def delete(path, opts) do
    # delete from GCS
    :ok
  end
end

Then configure it:

config :hawk_ex,
  csv_storage: {MyApp.CSV.GCSStorage, bucket: "my-bucket"}