refrakt/upload

File upload handling.

Provides helpers for processing multipart file uploads from Wisp’s form data.

Usage

import refrakt/upload

pub fn create(req: Request, ctx: Context) -> Response {
  use form_data <- wisp.require_form(req)

  case upload.get_file(form_data, "avatar") {
    Ok(file) -> {
      // Save to disk
      let assert Ok(path) = upload.save(file, to: "priv/uploads")
      // path is like "priv/uploads/abc123_avatar.jpg"
    }
    Error(_) -> // No file uploaded
  }
}

pub type UploadConfig {
  UploadConfig(
    max_size_bytes: Int,
    allowed_types: List(String),
    upload_dir: String,
  )
}

pub type UploadedFile {
  UploadedFile(
    field_name: String,
    file_name: String,
    path: String,
    content_type: String,
  )
}

pub fn default_config() -> UploadConfig

pub fn get_file(
  form_data: wisp.FormData,
  field_name: String,
) -> Result(UploadedFile, String)

pub fn save(
  file: UploadedFile,
  to dest_dir: String,
) -> Result(String, String)