Current section
Files
Jump to
Current section
Files
src/gleam@otp@supervisor.erl
-module(gleam@otp@supervisor).
-compile(no_auto_import).
-export([add/2, supervisor/1, worker/1, returning/2, start_spec/1, start/1, application_stopped/0, to_erlang_start_result/1]).
-export_type([spec/2, children/1, child_spec/3, child_start_error/0, message/0, instruction/0, state/1, starter/1, child/1, handle_exit_error/0, application_start_mode/0, application_stop/0]).
-type spec(FCZ, FDA) :: {spec,
FCZ,
integer(),
integer(),
fun((children(FCZ)) -> children(FDA))}.
-opaque children(FDB) :: {ready, starter(FDB)} | {failed, child_start_error()}.
-opaque child_spec(FDC, FDD, FDE) :: {child_spec,
fun((FDD) -> {ok,
gleam@erlang@process:subject(FDC)} |
{error, gleam@otp@actor:start_error()}),
fun((FDD, gleam@erlang@process:subject(FDC)) -> FDE)}.
-type child_start_error() :: {child_start_error,
gleam@option:option(gleam@erlang@process:pid_()),
gleam@otp@actor:start_error()}.
-opaque message() :: {exit, gleam@erlang@process:exit_message()} |
{retry_restart, gleam@erlang@process:pid_()}.
-type instruction() :: start_all | {start_from, gleam@erlang@process:pid_()}.
-type state(FDF) :: {state,
gleam@otp@intensity_tracker:intensity_tracker(),
starter(FDF),
gleam@erlang@process:subject(gleam@erlang@process:pid_())}.
-type starter(FDG) :: {starter,
FDG,
gleam@option:option(fun((instruction()) -> {ok,
{starter(FDG),
instruction()}} |
{error, child_start_error()}))}.
-type child(FDH) :: {child, gleam@erlang@process:pid_(), FDH}.
-type handle_exit_error() :: {restart_failed,
gleam@erlang@process:pid_(),
gleam@otp@intensity_tracker:intensity_tracker()} |
too_many_restarts.
-type application_start_mode() :: normal |
{takeover, gleam@otp@node:node_()} |
{failover, gleam@otp@node:node_()}.
-type application_stop() :: any().
-spec start_child(child_spec(any(), FEK, FEL), FEK) -> {ok, child(FEL)} |
{error, child_start_error()}.
start_child(Child_spec, Argument) ->
case begin
_pipe = (erlang:element(2, Child_spec))(Argument),
gleam@result:map_error(
_pipe,
fun(_capture) -> {child_start_error, none, _capture} end
)
end of
{error, _try} -> {error, _try};
{ok, Subject} ->
{ok,
{child,
gleam@erlang@process:subject_owner(Subject),
(erlang:element(3, Child_spec))(Argument, Subject)}}
end.
-spec shutdown_child(
gleam@erlang@process:pid_(),
child_spec(any(), any(), any())
) -> nil.
shutdown_child(Pid, _) ->
gleam@erlang@process:send_exit(Pid).
-spec perform_instruction_for_child(
FEY,
instruction(),
child_spec(any(), FEY, FFA),
child(FFA)
) -> {ok, {child(FFA), instruction()}} | {error, child_start_error()}.
perform_instruction_for_child(Argument, Instruction, Child_spec, Child) ->
Current = erlang:element(2, Child),
case Instruction of
{start_from, Target} when Target =/= Current ->
{ok, {Child, Instruction}};
_@1 ->
shutdown_child(Current, Child_spec),
case start_child(Child_spec, Argument) of
{error, _try} -> {error, _try};
{ok, Child@1} ->
{ok, {Child@1, start_all}}
end
end.
-spec add_child_to_starter(
starter(FFI),
child_spec(any(), FFI, FFL),
child(FFL)
) -> starter(FFL).
add_child_to_starter(Starter, Child_spec, Child) ->
Starter@3 = fun(Instruction) -> case case erlang:element(3, Starter) of
{some, Start} ->
Start(Instruction);
none ->
{ok, {Starter, Instruction}}
end of
{error, _try} -> {error, _try};
{ok, {Starter@1, Instruction@1}} ->
case perform_instruction_for_child(
erlang:element(2, Starter@1),
Instruction@1,
Child_spec,
Child
) of
{error, _try@1} -> {error, _try@1};
{ok, {Child@1, Instruction@2}} ->
Starter@2 = add_child_to_starter(
Starter@1,
Child_spec,
Child@1
),
{ok, {Starter@2, Instruction@2}}
end
end end,
{starter, erlang:element(3, Child), {some, Starter@3}}.
-spec start_and_add_child(starter(FFR), child_spec(any(), FFR, FFU)) -> children(FFU).
start_and_add_child(State, Child_spec) ->
case start_child(Child_spec, erlang:element(2, State)) of
{ok, Child} ->
{ready, add_child_to_starter(State, Child_spec, Child)};
{error, Reason} ->
{failed, Reason}
end.
-spec add(children(FFZ), child_spec(any(), FFZ, FGC)) -> children(FGC).
add(Children, Child_spec) ->
case Children of
{failed, Fail} ->
{failed, Fail};
{ready, State} ->
start_and_add_child(State, Child_spec)
end.
-spec supervisor(
fun((FGH) -> {ok, gleam@erlang@process:subject(FGI)} |
{error, gleam@otp@actor:start_error()})
) -> child_spec(FGI, FGH, FGH).
supervisor(Start) ->
{child_spec, Start, fun(Argument, _) -> Argument end}.
-spec worker(
fun((FGP) -> {ok, gleam@erlang@process:subject(FGQ)} |
{error, gleam@otp@actor:start_error()})
) -> child_spec(FGQ, FGP, FGP).
worker(Start) ->
{child_spec, Start, fun(Argument, _) -> Argument end}.
-spec returning(
child_spec(FGX, FGY, any()),
fun((FGY, gleam@erlang@process:subject(FGX)) -> FHE)
) -> child_spec(FGX, FGY, FHE).
returning(Child, Updater) ->
{child_spec, erlang:element(2, Child), Updater}.
-spec init(spec(any(), FHJ)) -> gleam@otp@actor:init_result(state(FHJ), message()).
init(Spec) ->
Retry = gleam@erlang@process:new_subject(),
gleam@erlang@process:trap_exits(true),
Selector = begin
_pipe = gleam@erlang@process:new_selector(),
_pipe@1 = gleam@erlang@process:selecting(
_pipe,
Retry,
fun(A) -> {retry_restart, A} end
),
gleam@erlang@process:selecting_trapped_exits(
_pipe@1,
fun(A) -> {exit, A} end
)
end,
Result = begin
_pipe@2 = {starter, erlang:element(2, Spec), none},
_pipe@3 = {ready, _pipe@2},
(erlang:element(5, Spec))(_pipe@3)
end,
case Result of
{ready, Starter} ->
Restarts = gleam@otp@intensity_tracker:new(
erlang:element(3, Spec),
erlang:element(4, Spec)
),
State = {state, Restarts, Starter, Retry},
{ready, State, Selector};
{failed, Error} ->
{failed, case erlang:element(3, Error) of
init_timeout ->
<<"Child initialisation timed out"/utf8>>;
{init_crashed, Reason} ->
gleam@string:append(
<<"Child crashed during initialisation: "/utf8>>,
gleam@string:inspect(Reason)
);
{init_failed, Reason@1} ->
gleam@string:append(
<<"Child failed to start during initialisation: "/utf8>>,
gleam@string:inspect(Reason@1)
)
end}
end.
-spec handle_exit(gleam@erlang@process:pid_(), state(FHP)) -> gleam@otp@actor:next(state(FHP)).
handle_exit(Pid, State) ->
Outcome = begin
{some, Start@1} = case erlang:element(3, erlang:element(3, State)) of
{some, Start} -> {some, Start};
_try ->
erlang:error(#{gleam_error => assert,
message => <<"Assertion pattern match failed"/utf8>>,
value => _try,
module => <<"gleam/otp/supervisor"/utf8>>,
function => <<"handle_exit"/utf8>>,
line => 293})
end,
case begin
_pipe = erlang:element(2, State),
_pipe@1 = gleam@otp@intensity_tracker:add_event(_pipe),
gleam@result:map_error(_pipe@1, fun(_) -> too_many_restarts end)
end of
{error, _try@1} -> {error, _try@1};
{ok, Restarts} ->
case begin
_pipe@2 = Start@1({start_from, Pid}),
gleam@result:map_error(
_pipe@2,
fun(E) ->
{restart_failed,
gleam@option:unwrap(erlang:element(2, E), Pid),
Restarts}
end
)
end of
{error, _try@2} -> {error, _try@2};
{ok, {Starter, _@1}} ->
{ok,
erlang:setelement(
2,
erlang:setelement(3, State, Starter),
Restarts
)}
end
end
end,
case Outcome of
{ok, State@1} ->
{continue, State@1};
{error, {restart_failed, Failed_child, Restarts@1}} ->
gleam@erlang@process:send(erlang:element(4, State), Failed_child),
State@2 = erlang:setelement(2, State, Restarts@1),
{continue, State@2};
{error, too_many_restarts} ->
{stop,
{abnormal,
<<"Child processes restarted too many times within allowed period"/utf8>>}}
end.
-spec loop(message(), state(FHT)) -> gleam@otp@actor:next(state(FHT)).
loop(Message, State) ->
case Message of
{exit, Exit_message} ->
handle_exit(erlang:element(2, Exit_message), State);
{retry_restart, Pid} ->
handle_exit(Pid, State)
end.
-spec start_spec(spec(any(), any())) -> {ok,
gleam@erlang@process:subject(message())} |
{error, gleam@otp@actor:start_error()}.
start_spec(Spec) ->
gleam@otp@actor:start_spec(
{spec, fun() -> init(Spec) end, 60000, fun loop/2}
).
-spec start(fun((children(nil)) -> children(any()))) -> {ok,
gleam@erlang@process:subject(message())} |
{error, gleam@otp@actor:start_error()}.
start(Init) ->
start_spec({spec, nil, 5, 1, Init}).
-spec application_stopped() -> application_stop().
application_stopped() ->
gleam_otp_external:application_stopped().
-spec to_erlang_start_result(
{ok, gleam@erlang@process:subject(any())} |
{error, gleam@otp@actor:start_error()}
) -> {ok, gleam@erlang@process:pid_()} | {error, gleam@dynamic:dynamic()}.
to_erlang_start_result(Res) ->
gleam@otp@actor:to_erlang_start_result(Res).