Packages
oaspec
0.59.0
0.68.0
0.67.0
0.66.0
0.65.0
0.64.0
0.63.0
0.62.0
0.61.0
0.60.0
0.59.0
0.58.1
0.58.0
0.57.0
0.56.0
0.55.0
0.54.0
0.53.0
0.52.0
0.51.0
0.50.0
0.49.0
0.48.0
0.47.0
0.46.0
0.45.0
0.44.0
0.43.0
0.42.0
0.41.0
0.40.0
0.39.0
0.38.0
0.37.0
0.36.0
0.35.0
0.34.0
0.33.0
0.32.0
0.31.0
0.30.0
0.29.0
0.28.0
0.27.0
0.26.0
0.25.0
0.24.0
0.23.0
0.22.0
0.21.0
0.20.0
0.19.0
0.18.0
0.17.0
0.16.0
0.15.0
0.14.0
0.13.0
0.12.0
0.11.0
0.10.0
0.9.0
0.8.0
0.7.0
0.6.3
0.6.1
0.6.0
0.5.0
0.4.0
0.3.0
0.1.3
Generate Gleam code from OpenAPI 3.x specifications
Current section
Files
Jump to
Current section
Files
src/oaspec@internal@codegen@context.erl
-module(oaspec@internal@codegen@context).
-compile([no_auto_import, nowarn_unused_vars, nowarn_unused_function, nowarn_nomatch, inline]).
-define(FILEPATH, "src/oaspec/internal/codegen/context.gleam").
-export([spec/1, config/1, operations/1, resolve_schema_ref/2, schema_metadata/2, component_type_names/1, new/2]).
-export_type([context/0, file_target/0, write_mode/0, generated_file/0]).
-if(?OTP_RELEASE >= 27).
-define(MODULEDOC(Str), -moduledoc(Str)).
-define(DOC(Str), -doc(Str)).
-else.
-define(MODULEDOC(Str), -compile([])).
-define(DOC(Str), -compile([])).
-endif.
?MODULEDOC(false).
-opaque context() :: {context,
oaspec@internal@openapi@spec:open_api_spec(oaspec@internal@openapi@spec:resolved()),
oaspec@config:config(),
list({binary(),
oaspec@internal@openapi@spec:operation(oaspec@internal@openapi@spec:resolved()),
binary(),
oaspec@internal@openapi@spec:http_method()}),
gleam@dict:dict(binary(), {ok,
oaspec@internal@openapi@schema:schema_object()} |
{error, oaspec@internal@openapi@resolver:resolve_error()}),
gleam@dict:dict(binary(), nil)}.
-type file_target() :: shared_target | server_target | client_target.
-type write_mode() :: overwrite | skip_if_exists.
-type generated_file() :: {generated_file,
binary(),
binary(),
file_target(),
write_mode()}.
-file("src/oaspec/internal/codegen/context.gleam", 58).
?DOC(false).
-spec spec(context()) -> oaspec@internal@openapi@spec:open_api_spec(oaspec@internal@openapi@spec:resolved()).
spec(Ctx) ->
erlang:element(2, Ctx).
-file("src/oaspec/internal/codegen/context.gleam", 63).
?DOC(false).
-spec config(context()) -> oaspec@config:config().
config(Ctx) ->
erlang:element(3, Ctx).
-file("src/oaspec/internal/codegen/context.gleam", 70).
?DOC(false).
-spec operations(context()) -> list({binary(),
oaspec@internal@openapi@spec:operation(oaspec@internal@openapi@spec:resolved()),
binary(),
oaspec@internal@openapi@spec:http_method()}).
operations(Ctx) ->
erlang:element(4, Ctx).
-file("src/oaspec/internal/codegen/context.gleam", 79).
?DOC(false).
-spec resolve_schema_ref(oaspec@internal@openapi@schema:schema_ref(), context()) -> {ok,
oaspec@internal@openapi@schema:schema_object()} |
{error, oaspec@internal@openapi@resolver:resolve_error()}.
resolve_schema_ref(Schema_ref, Ctx) ->
case Schema_ref of
{inline, Schema_obj} ->
{ok, Schema_obj};
{reference, Ref, _} ->
case gleam_stdlib:map_get(erlang:element(5, Ctx), Ref) of
{ok, Resolved} ->
Resolved;
{error, _} ->
oaspec@internal@openapi@resolver:resolve_schema_ref(
Schema_ref,
erlang:element(2, Ctx)
)
end
end.
-file("src/oaspec/internal/codegen/context.gleam", 95).
?DOC(false).
-spec schema_metadata(oaspec@internal@openapi@schema:schema_ref(), context()) -> gleam@option:option(oaspec@internal@openapi@schema:schema_metadata()).
schema_metadata(Schema_ref, Ctx) ->
case resolve_schema_ref(Schema_ref, Ctx) of
{ok, Schema_obj} ->
{some, oaspec@internal@openapi@schema:get_metadata(Schema_obj)};
{error, _} ->
none
end.
-file("src/oaspec/internal/codegen/context.gleam", 112).
?DOC(false).
-spec component_type_names(context()) -> gleam@dict:dict(binary(), nil).
component_type_names(Ctx) ->
erlang:element(6, Ctx).
-file("src/oaspec/internal/codegen/context.gleam", 116).
?DOC(false).
-spec build_component_type_names(
oaspec@internal@openapi@spec:open_api_spec(oaspec@internal@openapi@spec:resolved())
) -> gleam@dict:dict(binary(), nil).
build_component_type_names(Spec) ->
case erlang:element(5, Spec) of
{some, Components} ->
gleam@list:fold(
maps:keys(erlang:element(2, Components)),
maps:new(),
fun(Acc, Name) ->
gleam@dict:insert(
Acc,
oaspec@internal@util@naming:schema_to_type_name(Name),
nil
)
end
);
none ->
maps:new()
end.
-file("src/oaspec/internal/codegen/context.gleam", 146).
?DOC(false).
-spec component_schema_ref(binary()) -> binary().
component_schema_ref(Name) ->
<<"#/components/schemas/"/utf8, Name/binary>>.
-file("src/oaspec/internal/codegen/context.gleam", 128).
?DOC(false).
-spec build_schema_cache(
oaspec@internal@openapi@spec:open_api_spec(oaspec@internal@openapi@spec:resolved())
) -> gleam@dict:dict(binary(), {ok,
oaspec@internal@openapi@schema:schema_object()} |
{error, oaspec@internal@openapi@resolver:resolve_error()}).
build_schema_cache(Spec) ->
case erlang:element(5, Spec) of
{some, Components} ->
gleam@list:fold(
maps:to_list(erlang:element(2, Components)),
maps:new(),
fun(Acc, Entry) ->
{Name, _} = Entry,
Ref = component_schema_ref(Name),
gleam@dict:insert(
Acc,
Ref,
oaspec@internal@openapi@resolver:resolve_schema_ref(
{reference, Ref, Name},
Spec
)
)
end
);
none ->
maps:new()
end.
-file("src/oaspec/internal/codegen/context.gleam", 47).
?DOC(false).
-spec new(
oaspec@internal@openapi@spec:open_api_spec(oaspec@internal@openapi@spec:resolved()),
oaspec@config:config()
) -> context().
new(Spec, Config) ->
{context,
Spec,
Config,
oaspec@internal@openapi@operations:collect_operations(Spec),
build_schema_cache(Spec),
build_component_type_names(Spec)}.