http-multipart-formdata 3.0.1

Http_multipart_formdata is a non-blocking, streaming HTTP multipart formdata parser. Its design is based on two main ideas:

The parser should stream the results as soon as possible in a non-buffered, non-backtracking manner; and
The parser input must be non-blocking and incremental in nature.

The parser implements HTTP multipart/form-data standard as defined in RFC 7578.

Types

type reader

reader represents a HTTP multipart formdata reader.

and read = [

| `End
(*
The reader has completed reading.
*)
| `Header of part_header
(*
Multipart part header data.
*)
| `Body of Cstruct.t
(*
Multipart part body data.
*)
| `Body_end
(*
reader has completed reading the Multipart body data.
*)
| `Awaiting_input of [ `Cstruct of Cstruct.t | `Eof ] -> read
(*
The reader is waiting for it to be provided with input data. This is only returned when `Incremental is chosen as input.
*)
| `Error of string

]

read represents both the current state and data read by a reader.

Represents an error in input data.

and input = [

| `Cstruct of Cstruct.t
(*
A bigstring input.
*)
| `Incremental
(*
The caller of the library periodically provides input to the parser.
*)

]

and part_header

Represents a parsed multipart part header data.

and boundary

Represents the multipart boundary value.

Mulipart Boundary parser

val boundary : string -> (boundary, string) Stdlib.result

boundary content_type parses content_type to extract boundary value. content_type is the HTTP request Content-Type header value.

let content_type =
  "multipart/form-data; \
   boundary=---------------------------735323031399963166993862150"
in
Http_multipart_formdata.boundary content_type

Multipart Reader

val reader : ?read_buffer_size:int -> boundary -> input -> reader

reader ?read_buffer_size boundary input creates reader. The default value for read_buffer_size is 1KB.

val read : reader -> read

read_part ?read_body_len ~boundary reader reads a http multipart body and returns a read value.

val unconsumed : reader -> Cstruct.t

uncoonsumed rader returns any leftover data still remaining after reader returns `End.

Part header

val name : part_header -> string

name t returns the form field name

val content_type : part_header -> string

content_type t returns the part content-type.

val filename : part_header -> string option

filename t returns the uploaded filename is the multipart is a file

val find : string -> part_header -> string option

param_value name t returns the multipart parameter value with name name.

Pretty Printers

val pp_part_header : Stdlib.Format.formatter -> part_header -> unit

val pp_read_result : Stdlib.Format.formatter -> read -> unit

val pp_boundary : Stdlib.Format.formatter -> boundary -> unit

package http-multipart-formdata

Types

Mulipart Boundary parser

Multipart Reader

Part header

Pretty Printers