oaspec/codegen/client_request

build_param_list

pub fn build_param_list(
  path_params: List(spec.Parameter(spec.Resolved)),
  query_params: List(spec.Parameter(spec.Resolved)),
  header_params: List(spec.Parameter(spec.Resolved)),
  cookie_params: List(spec.Parameter(spec.Resolved)),
  operation: spec.Operation(spec.Resolved),
  op_id: String,
  ctx: context.Context,
) -> String

Build parameter list for function signature.

build_request_object_call_args

</>

pub fn build_request_object_call_args(
  path_params: List(spec.Parameter(spec.Resolved)),
  query_params: List(spec.Parameter(spec.Resolved)),
  header_params: List(spec.Parameter(spec.Resolved)),
  cookie_params: List(spec.Parameter(spec.Resolved)),
  operation: spec.Operation(spec.Resolved),
) -> option.Option(String)

Build the call-site argument list for the _with_request wrapper that unpacks a request_types.*Request record into the flat client function it delegates to. Returns None if the operation uses a multi-content body (where the flat API also takes a content_type argument that the request type does not carry).

generate_deep_object_query_param

</>

pub fn generate_deep_object_query_param(
  sb: string_tree.StringTree,
  param: spec.Parameter(spec.Resolved),
  param_name: String,
  ctx: context.Context,
) -> string_tree.StringTree

Generate deepObject-style query parameters: key[prop]=value for each property.

generate_delimited_array_query_param

</>

pub fn generate_delimited_array_query_param(
  sb: string_tree.StringTree,
  param: spec.Parameter(spec.Resolved),
  param_name: String,
  joiner: String,
  ctx: context.Context,
) -> string_tree.StringTree

Generate non-exploded delimited array query parameter: tags=a|b|c (pipeDelimited) or tags=a%20b%20c (spaceDelimited).

generate_exploded_array_query_param

</>

pub fn generate_exploded_array_query_param(
  sb: string_tree.StringTree,
  param: spec.Parameter(spec.Resolved),
  param_name: String,
  ctx: context.Context,
) -> string_tree.StringTree

Generate exploded array query parameter: tags=a&tags=b

generate_form_urlencoded_body

</>

pub fn generate_form_urlencoded_body(
  sb: string_tree.StringTree,
  rb: spec.RequestBody(spec.Resolved),
  op_id: String,
  ctx: context.Context,
) -> string_tree.StringTree

Generate application/x-www-form-urlencoded body encoding in the client function.

generate_multipart_body

</>

pub fn generate_multipart_body(
  sb: string_tree.StringTree,
  rb: spec.RequestBody(spec.Resolved),
  op_id: String,
  ctx: context.Context,
) -> string_tree.StringTree

Generate multipart/form-data body encoding in the client function.

get_body_encode_expr

</>

pub fn get_body_encode_expr(
  rb: spec.RequestBody(spec.Resolved),
  op_id: String,
  ctx: context.Context,
) -> String

Get the encode expression for a request body.

get_body_type

</>

pub fn get_body_type(
  rb: spec.RequestBody(spec.Resolved),
  op_id: String,
) -> String

Get the Gleam type for a request body parameter.

is_deep_object_param

</>

pub fn is_deep_object_param(
  param: spec.Parameter(spec.Resolved),
  ctx: context.Context,
) -> Bool

Check if a parameter uses deepObject style with an object schema.

is_delimited_array_param

</>

pub fn is_delimited_array_param(
  param: spec.Parameter(spec.Resolved),
  ctx: context.Context,
) -> option.Option(String)

Returns Some(joiner) if the parameter is a non-exploded delimited array (pipeDelimited or spaceDelimited). Returns None for everything else including form arrays — we keep that on the existing path.

is_exploded_array_param

</>

pub fn is_exploded_array_param(
  param: spec.Parameter(spec.Resolved),
  ctx: context.Context,
) -> Bool

Check if a parameter is an array with explode behavior. OpenAPI default: style: form has explode: true by default.

multipart_field_is_binary

</>

pub fn multipart_field_is_binary(
  field_schema: schema.SchemaRef,
  ctx: context.Context,
) -> Bool

param_to_string_expr

</>

pub fn param_to_string_expr(
  param: spec.Parameter(spec.Resolved),
  param_name: String,
  ctx: context.Context,
) -> String

Convert a parameter value to its String representation for URL/header use.

to_str_for_optional_value

</>

pub fn to_str_for_optional_value(
  param: spec.Parameter(spec.Resolved),
  ctx: context.Context,
) -> String

Convert an optional param value (bound to v) to string.

to_str_for_required

</>

pub fn to_str_for_required(
  param: spec.Parameter(spec.Resolved),
  param_name: String,
  ctx: context.Context,
) -> String

Convert a required param to string for query building.

oaspec - v0.16.0

Values