multipartkit - v0.4.0

multipartkit/part

Types

Part

opaque </>

A parsed multipart part.

Opaque — construct with new/5 (or receive from parser.parse) and inspect through all_headers/1, name/1, filename/1, content_type/1, and body/1. The case-insensitive header(part, name) and headers(part, name) helpers below are the supported way to look up a header value by name. The internal layout may evolve to cache more derived fields without breaking external callers.

Header semantics on the headers list:

  • Entries are kept in the order they appeared on the wire.
  • Header names retain their original casing.
  • Header values have surrounding optional whitespace stripped per RFC 7230 §3.2.4 but are otherwise preserved (no quote unescaping, no parameter normalisation, no inner whitespace collapse).

Header bytes must be valid UTF-8 — header blocks that contain non-UTF-8 bytes are rejected with InvalidHeader. The body has no such restriction: it is always treated as raw bytes; the parser does not transcode or UTF-8-validate it.

name, filename, and content_type are convenience caches derived from Content-Disposition and Content-Type headers per the field/file detection rules. They are not re-derived automatically when a caller constructs a Part manually with new/5.

pub opaque type Part

Values

all_headers

</> 
pub fn all_headers(part: Part) -> List(#(String, String))

All headers as (name, value) pairs in input order.

body

</> 
pub fn body(part: Part) -> BitArray

The raw body bytes of the part.

content_type

</> 
pub fn content_type(part: Part) -> option.Option(String)

The Content-Type header value, or None if the part has no Content-Type header.

filename

</> 
pub fn filename(part: Part) -> option.Option(String)

The convenience filename field derived from Content-Disposition for form-data parts, or None.

</> 
pub fn header(part: Part, name: String) -> option.Option(String)

Return the first header value whose name matches name ASCII case-insensitively.

headers

</> 
pub fn headers(part: Part, name: String) -> List(String)

Return all header values whose name matches name ASCII case-insensitively in the order they appear in the part headers.

name

</> 
pub fn name(part: Part) -> option.Option(String)

The convenience name field derived from Content-Disposition for form-data parts, or None for non-form parts and parts without a disposition header.

new

</> 
pub fn new(
  headers headers: List(#(String, String)),
  name name: option.Option(String),
  filename filename: option.Option(String),
  content_type content_type: option.Option(String),
  body body: BitArray,
) -> Part

Construct a Part. The name, filename, and content_type fields are not re-derived from the headers list — pass the values you expect callers to see, or use parser.parse for automatic derivation.

✨ Search Document