Files
n8n-openai-adapter/lib/elixir/src/elixir_expand.erl
T

1354 lines
52 KiB
Erlang

%% SPDX-License-Identifier: Apache-2.0
%% SPDX-FileCopyrightText: 2021 The Elixir Team
%% SPDX-FileCopyrightText: 2012 Plataformatec
-module(elixir_expand).
-export([expand/3, expand_args/3, expand_arg/3, format_error/1]).
-import(elixir_errors, [file_error/4, module_error/4, function_error/4]).
-include("elixir.hrl").
-define(kernel, 'Elixir.Kernel').
%% =
expand({'=', Meta, [_, _]} = Expr, S, #{context := match} = E) ->
elixir_clauses:parallel_match(Meta, Expr, S, E);
expand({'=', Meta, [Left, Right]}, S, E) ->
assert_no_guard_scope(Meta, "=", S, E),
{ERight, SR, ER} = expand(Right, S, E),
{ELeft, SL, EL} = elixir_clauses:match(fun expand/3, Meta, Left, SR, S, ER),
{{'=', Meta, [ELeft, ERight]}, SL, EL};
%% Literal operators
expand({'{}', Meta, Args}, S, E) ->
{EArgs, SA, EA} = expand_args(Args, S, E),
{{'{}', Meta, EArgs}, SA, EA};
expand({'%{}', Meta, Args}, S, E) ->
elixir_map:expand_map(Meta, Args, S, E);
expand({'%', Meta, [Left, Right]}, S, E) ->
elixir_map:expand_struct(Meta, Left, Right, S, E);
expand({'<<>>', Meta, Args}, S, E) ->
elixir_bitstring:expand(Meta, Args, S, E, false);
expand({'->', Meta, [_, _]}, _S, E) ->
file_error(Meta, E, ?MODULE, unhandled_arrow_op);
expand({'::', Meta, [_, _]}, _S, E) ->
file_error(Meta, E, ?MODULE, unhandled_type_op);
expand({'|', Meta, [_, _]}, _S, E) ->
file_error(Meta, E, ?MODULE, unhandled_cons_op);
%% __block__
expand({'__block__', _Meta, []}, S, E) ->
{nil, S, E};
expand({'__block__', _Meta, [Arg]}, S, E) ->
expand(Arg, S, E);
expand({'__block__', Meta, Args}, S, E) when is_list(Args) ->
{EArgs, SA, EA} = expand_block(Args, [], Meta, S, E),
{{'__block__', Meta, EArgs}, SA, EA};
%% __aliases__
expand({'__aliases__', _, _} = Alias, S, E) ->
expand_aliases(Alias, S, E, true);
%% alias
expand({Kind, Meta, [{{'.', _, [Base, '{}']}, _, Refs} | Rest]}, S, E)
when Kind == alias; Kind == require; Kind == import ->
case Rest of
[] ->
expand_multi_alias_call(Kind, Meta, Base, Refs, [], S, E);
[Opts] ->
lists:keymember(as, 1, Opts) andalso file_error(Meta, E, ?MODULE, as_in_multi_alias_call),
expand_multi_alias_call(Kind, Meta, Base, Refs, Opts, S, E)
end;
expand({alias, Meta, [Ref]}, S, E) ->
expand({alias, Meta, [Ref, []]}, S, E);
expand({alias, Meta, [Ref, Opts]}, S, E) ->
assert_no_match_or_guard_scope(Meta, "alias", S, E),
{ERef, SR, ER} = expand_without_aliases_report(Ref, S, E),
{EOpts, ST, ET} = expand_opts(Meta, alias, [as, warn], no_alias_opts(Opts), SR, ER),
is_atom(ERef) orelse
file_error(Meta, E, ?MODULE, {expected_compile_time_module, alias, Ref}),
{ok, New, EQ} = alias(Meta, ERef, true, EOpts, ET),
Quoted =
case (New /= false) andalso should_warn(Meta, EOpts, EQ) of
false ->
ERef;
Pid when ?key(EQ, function) /= nil ->
?tracker:warn_alias(Pid, Meta, New, ERef);
Pid ->
{{'.', Meta, [?tracker, warn_alias]}, Meta, [Pid, Meta, New, ERef]}
end,
{Quoted, ST, EQ};
expand({require, Meta, [Ref]}, S, E) ->
expand({require, Meta, [Ref, []]}, S, E);
expand({require, Meta, [Ref, Opts]}, S, E) ->
assert_no_match_or_guard_scope(Meta, "require", S, E),
{ERef, SR, ER} = expand_without_aliases_report(Ref, S, E),
{EOpts, ST, ET} = expand_opts(Meta, require, [as, warn], no_alias_opts(Opts), SR, ER),
%% Add the alias to context_modules if defined is set.
%% This is used by defmodule in order to store the defined
%% module in context modules.
case lists:keyfind(defined, 1, Meta) of
{defined, Mod} when is_atom(Mod) ->
Mods = [Mod | ?key(ET, context_modules)],
{ok, _, EU} = alias(Meta, ERef, false, EOpts, ET#{context_modules := Mods}),
SU = case E of
#{function := nil} -> ST;
_ -> ST#elixir_ex{runtime_modules=[Mod | ST#elixir_ex.runtime_modules]}
end,
{ERef, SU, EU};
false when is_atom(ERef) ->
elixir_aliases:ensure_loaded(Meta, ERef, ET),
RE = elixir_aliases:require(Meta, ERef, EOpts, ET, true),
{ok, Alias, EU} = alias(Meta, ERef, false, EOpts, RE),
Quoted =
case should_warn(Meta, EOpts, EU) of
false ->
ERef;
Pid when ?key(EU, function) /= nil ->
?tracker:warn_require(Pid, Meta, ERef, Alias);
Pid ->
{{'.', Meta, [?tracker, warn_require]}, Meta, [Pid, Meta, ERef, Alias]}
end,
{Quoted, ST, EU};
false ->
file_error(Meta, E, ?MODULE, {expected_compile_time_module, require, Ref})
end;
expand({import, Meta, [Left]}, S, E) ->
expand({import, Meta, [Left, []]}, S, E);
expand({import, Meta, [Ref, Opts]}, S, E) ->
assert_no_match_or_guard_scope(Meta, "import", S, E),
{ERef, SR, ER} = expand_without_aliases_report(Ref, S, E),
{EOpts, ST, ET} = expand_opts(Meta, import, [only, except, warn], Opts, SR, ER),
is_atom(ERef) orelse
file_error(Meta, E, ?MODULE, {expected_compile_time_module, import, Ref}),
elixir_aliases:ensure_loaded(Meta, ERef, ET),
case elixir_import:import(Meta, ERef, EOpts, ET, true, true) of
{ok, Imported, EI} ->
Quoted =
case Imported andalso should_warn(Meta, EOpts, ET) of
false ->
ERef;
Pid ->
Only =
case lists:keyfind(only, 1, EOpts) of
{only, List} when is_list(List) -> List;
_ -> []
end,
%% If we are outside a function, we turn on the warnings at execution time.
case ET of
#{function := nil} ->
?tracker:add_import(Pid, ERef, Only, Meta, false),
{{'.', Meta, [?tracker, warn_import]}, Meta, [Pid, ERef]};
#{} ->
?tracker:add_import(Pid, ERef, Only, Meta, true),
ERef
end
end,
{Quoted, ST, EI};
{error, Reason} ->
elixir_errors:file_error(Meta, E, elixir_import, Reason)
end;
%% Compilation environment macros
expand({'__MODULE__', _, Atom}, S, E) when is_atom(Atom) ->
{?key(E, module), S, E};
expand({'__DIR__', _, Atom}, S, E) when is_atom(Atom) ->
{filename:dirname(?key(E, file)), S, E};
expand({'__CALLER__', Meta, Atom} = Caller, S, E) when is_atom(Atom) ->
assert_no_match_scope(Meta, "__CALLER__", E),
(not S#elixir_ex.caller) andalso function_error(Meta, E, ?MODULE, caller_not_allowed),
{Caller, S, E};
expand({'__STACKTRACE__', Meta, Atom} = Stacktrace, S, E) when is_atom(Atom) ->
assert_no_match_scope(Meta, "__STACKTRACE__", E),
(not S#elixir_ex.stacktrace) andalso function_error(Meta, E, ?MODULE, stacktrace_not_allowed),
{Stacktrace, S, E};
expand({'__ENV__', Meta, Atom}, S, E) when is_atom(Atom) ->
assert_no_match_scope(Meta, "__ENV__", E),
{escape_map(escape_env_entries(Meta, S, E)), S, E};
expand({{'.', DotMeta, [{'__ENV__', Meta, Atom}, Field]}, CallMeta, []}, S, E)
when is_atom(Atom), is_atom(Field) ->
assert_no_match_scope(Meta, "__ENV__", E),
Env = escape_env_entries(Meta, S, E),
case maps:is_key(Field, Env) of
true -> {maps:get(Field, Env), S, E};
false -> {{{'.', DotMeta, [escape_map(Env), Field]}, CallMeta, []}, S, E}
end;
expand({'__cursor__', Meta, Args}, _S, E) when is_list(Args) ->
file_error(Meta, E, ?MODULE, '__cursor__');
%% Quote
expand({Unquote, Meta, [_]}, _S, E) when Unquote == unquote; Unquote == unquote_splicing ->
file_error(Meta, E, ?MODULE, {unquote_outside_quote, Unquote});
expand({quote, Meta, [Opts]}, S, E) when is_list(Opts) ->
case lists:keytake(do, 1, Opts) of
{value, {do, Do}, DoOpts} ->
expand({quote, Meta, [DoOpts, [{do, Do}]]}, S, E);
false ->
file_error(Meta, E, ?MODULE, {missing_option, 'quote', [do]})
end;
expand({quote, Meta, [_]}, _S, E) ->
file_error(Meta, E, ?MODULE, {invalid_args, 'quote'});
expand({quote, Meta, [Opts, Do]}, S, E) when is_list(Do) ->
Exprs =
case lists:keyfind(do, 1, Do) of
{do, Expr} -> Expr;
false -> file_error(Meta, E, ?MODULE, {missing_option, 'quote', [do]})
end,
ValidOpts = [context, location, line, file, unquote, bind_quoted, generated],
{EOpts, ST, ET} = expand_opts(Meta, quote, ValidOpts, Opts, S, E),
Context = proplists:get_value(context, EOpts, case ?key(E, module) of
nil -> 'Elixir';
Mod -> Mod
end),
{File, Line} = case lists:keyfind(location, 1, EOpts) of
{location, keep} ->
{?key(E, file), true};
false ->
{proplists:get_value(file, EOpts, nil), proplists:get_value(line, EOpts, false)}
end,
{Binding, DefaultUnquote} = case lists:keyfind(bind_quoted, 1, EOpts) of
{bind_quoted, BQ} ->
case is_list(BQ) andalso
lists:all(fun({Key, _}) when is_atom(Key) -> true; (_) -> false end, BQ) of
true -> {BQ, false};
false -> file_error(Meta, E, ?MODULE, {invalid_bind_quoted_for_quote, BQ})
end;
false ->
{[], true}
end,
Unquote = proplists:get_value(unquote, EOpts, DefaultUnquote),
Generated = proplists:get_value(generated, EOpts, false),
(map_get(context, E) /= nil) andalso Unquote andalso elixir_quote:has_unquotes(Exprs) andalso
file_error(Meta, E, ?MODULE, quote_in_pattern_with_unquote),
{Q, QContext, QPrelude} = elixir_quote:build(Meta, Line, File, Context, Unquote, Generated, ET),
{EPrelude, SP, EP} = expand(QPrelude, ST, ET),
{EContext, SC, EC} = expand(QContext, SP, EP),
Quoted = elixir_quote:quote(Exprs, Q),
{EQuoted, ES, EQ} = expand(Quoted, SC, EC),
BindingMeta = lists:keydelete(column, 1, Meta),
EBinding =
[{'{}', [],
['=', [], [
{'{}', [], [K, BindingMeta, EContext]},
V
]
]} || {K, V} <- Binding],
EBindingQuoted =
case EBinding of
[] -> EQuoted;
_ -> {'{}', [], ['__block__', [], EBinding ++ [EQuoted]]}
end,
EBlock =
case EPrelude of
[] -> EBindingQuoted;
_ -> {'__block__', [], EPrelude ++ [EBindingQuoted]}
end,
case ?key(E, context) of
nil -> {{{'.', Meta, [elixir_quote, validate_quote]}, Meta, [EBlock]}, ES, EQ};
_ -> {EBlock, ES, EQ}
end;
expand({quote, Meta, [_, _]}, _S, E) ->
file_error(Meta, E, ?MODULE, {invalid_args, 'quote'});
%% Functions
expand({'&', Meta, [{super, SuperMeta, Args} = Expr]}, S, E) when is_list(Args) ->
assert_no_match_or_guard_scope(Meta, "&", S, E),
case resolve_super(Meta, length(Args), E) of
{Kind, Name, _} when Kind == def; Kind == defp ->
expand_fn_capture(Meta, {Name, SuperMeta, Args}, S, E);
_ ->
expand_fn_capture(Meta, Expr, S, E)
end;
expand({'&', Meta, [{'/', ArityMeta, [{super, SuperMeta, Context}, Arity]} = Expr]}, S, E) when is_atom(Context), is_integer(Arity) ->
assert_no_match_or_guard_scope(Meta, "&", S, E),
case resolve_super(Meta, Arity, E) of
{Kind, Name, _} when Kind == def; Kind == defp ->
expand({'&', Meta, [{'/', ArityMeta, [{Name, SuperMeta, Context}, Arity]}]}, S, E);
_ ->
expand_fn_capture(Meta, Expr, S, E)
end;
expand({'&', Meta, [Arg]}, S, E) ->
assert_no_match_or_guard_scope(Meta, "&", S, E),
expand_fn_capture(Meta, Arg, S, E);
expand({fn, Meta, Pairs}, S, E) ->
assert_no_match_or_guard_scope(Meta, "fn", S, E),
elixir_fn:expand(Meta, Pairs, S, E);
%% Case/Receive/Try
expand({'cond', Meta, [Opts]}, S, E) ->
assert_no_match_or_guard_scope(Meta, "cond", S, E),
assert_no_underscore_clause_in_cond(Opts, E),
{EClauses, SC, EC} = elixir_clauses:'cond'(Meta, Opts, S, E),
#elixir_ex{version=Counter} = SC,
{{'cond', [{version, Counter} | Meta], [EClauses]}, SC#elixir_ex{version=Counter+1}, EC};
expand({'case', Meta, [Expr, Options]}, S, E) ->
assert_no_match_or_guard_scope(Meta, "case", S, E),
expand_case(Meta, Expr, Options, S, E);
expand({'receive', Meta, [Opts]}, S, E) ->
assert_no_match_or_guard_scope(Meta, "receive", S, E),
{EClauses, SC, EC} = elixir_clauses:'receive'(Meta, Opts, S, E),
#elixir_ex{version=Counter} = SC,
{{'receive', [{version, Counter} | Meta], [EClauses]}, SC#elixir_ex{version=Counter+1}, EC};
expand({'try', Meta, [Opts]}, S, E) ->
assert_no_match_or_guard_scope(Meta, "try", S, E),
{EClauses, SC, EC} = elixir_clauses:'try'(Meta, Opts, S, E),
#elixir_ex{version=Counter} = SC,
{{'try', [{version, Counter} | Meta], [EClauses]}, SC#elixir_ex{version=Counter+1}, EC};
%% Comprehensions
expand({for, _, [_ | _] } = Expr, S, E) ->
expand_for(Expr, S, E, true);
%% With
expand({with, Meta, [_ | _] = Args}, S, E) ->
assert_no_match_or_guard_scope(Meta, "with", S, E),
elixir_clauses:with(Meta, Args, S, E);
%% Super
expand({super, Meta, Args}, S, E) when is_list(Args) ->
assert_no_match_or_guard_scope(Meta, "super", S, E),
Arity = length(Args),
{Kind, Name, _} = resolve_super(Meta, Arity, E),
elixir_env:trace({local_function, Meta, Name, Arity}, E),
{EArgs, SA, EA} = expand_args(Args, S, E),
{{super, [{super, {Kind, Name}} | Meta], EArgs}, SA, EA};
%% Vars
expand({'^', Meta, [Arg]}, #elixir_ex{prematch={Prematch, _, _}, vars={_, Write}} = S, E) ->
NoMatchS = S#elixir_ex{prematch=pin, vars={Prematch, Write}},
case expand(Arg, NoMatchS, E#{context := nil}) of
{{Name, _, Kind} = Var, #elixir_ex{unused=Unused}, _} when is_atom(Name), is_atom(Kind) ->
{{'^', Meta, [Var]}, S#elixir_ex{unused=Unused}, E};
_ ->
function_error(Meta, E, ?MODULE, {invalid_arg_for_pin, Arg}),
{{'^', Meta, [Arg]}, S#elixir_ex{tainted_function=true}, E}
end;
expand({'^', Meta, [Arg]}, S, E) ->
function_error(Meta, E, ?MODULE, {pin_outside_of_match, Arg}),
{{'^', Meta, [Arg]}, S#elixir_ex{tainted_function=true}, E};
expand({'_', Meta, Kind}, #elixir_ex{version=Counter} = S, #{context := Context} = E) when is_atom(Kind) ->
NewVar = {'_', [{version, Counter} | Meta], Kind},
case Context of
match ->
{NewVar, S#elixir_ex{version=Counter+1}, E};
_ ->
function_error(Meta, E, ?MODULE, unbound_underscore),
{NewVar, S#elixir_ex{tainted_function=true, version=Counter+1}, E}
end;
expand({Name, Meta, Kind}, S, #{context := match} = E) when is_atom(Name), is_atom(Kind) ->
#elixir_ex{
prematch={_, _, PrematchVersion},
vars={Read, Write},
unused=Unused
} = S,
Pair = {Name, elixir_utils:var_context(Meta, Kind)},
case Read of
%% Variable was already overridden
#{Pair := VarVersion} when VarVersion >= PrematchVersion ->
maybe_warn_underscored_var_repeat(Meta, Name, Kind, E),
NewUnused = var_used(Pair, Meta, VarVersion, Unused),
NewWrite = (Write /= false) andalso Write#{Pair => VarVersion},
Var = {Name, [{version, VarVersion} | Meta], Kind},
{Var, S#elixir_ex{vars={Read, NewWrite}, unused=NewUnused}, E};
%% Variable is being overridden now
#{Pair := _} ->
Version = S#elixir_ex.version,
NewUnused = var_unused(Pair, Meta, Version, Unused, true),
NewRead = Read#{Pair => Version},
NewWrite = (Write /= false) andalso Write#{Pair => Version},
Var = {Name, [{version, Version} | Meta], Kind},
{Var, S#elixir_ex{vars={NewRead, NewWrite}, unused=NewUnused, version=Version + 1}, E};
%% Variable defined for the first time
_ ->
Version = S#elixir_ex.version,
NewUnused = var_unused(Pair, Meta, Version, Unused, false),
NewRead = Read#{Pair => Version},
NewWrite = (Write /= false) andalso Write#{Pair => Version},
Var = {Name, [{version, Version} | Meta], Kind},
{Var, S#elixir_ex{vars={NewRead, NewWrite}, unused=NewUnused, version=Version + 1}, E}
end;
expand({Name, Meta, Kind}, S, E) when is_atom(Name), is_atom(Kind) ->
#elixir_ex{vars={Read, _Write}, unused=Unused, prematch=Prematch} = S,
Pair = {Name, elixir_utils:var_context(Meta, Kind)},
Result =
case Read of
#{Pair := CurrentVersion} ->
case Prematch of
{Pre, _Cycle, {bitsize, Original}} ->
if
map_get(Pair, Pre) /= CurrentVersion ->
{ok, CurrentVersion};
is_map_key(Pair, Pre) ->
%% TODO: Remove me on Elixir 2.0
elixir_errors:file_warn(Meta, E, ?MODULE, {unpinned_bitsize_var, Name, Kind}),
{ok, CurrentVersion};
not is_map_key(Pair, Original) ->
{ok, CurrentVersion};
true ->
raise
end;
_ ->
{ok, CurrentVersion}
end;
_ ->
case E of
#{context := guard} -> raise;
#{} when S#elixir_ex.prematch =:= pin -> pin;
%% TODO: Remove fallback on on_undefined_variable
_ -> elixir_config:get(on_undefined_variable)
end
end,
case Result of
{ok, PairVersion} ->
maybe_warn_underscored_var_access(Meta, Name, Kind, E),
Var = {Name, [{version, PairVersion} | Meta], Kind},
{Var, S#elixir_ex{unused=var_used(Pair, Meta, PairVersion, Unused)}, E};
Error ->
case lists:keyfind(if_undefined, 1, Meta) of
{if_undefined, apply} ->
expand({Name, Meta, []}, S, E);
%% TODO: Remove this clause on v2.0 as we will raise by default
{if_undefined, raise} ->
function_error(Meta, E, ?MODULE, {undefined_var, Name, Kind}),
{{Name, Meta, Kind}, S#elixir_ex{tainted_function=true}, E};
%% TODO: Remove this clause on v2.0 as we will no longer support warn
_ when Error == warn ->
elixir_errors:file_warn(Meta, E, ?MODULE, {undefined_var_to_call, Name}),
expand({Name, [{if_undefined, warn} | Meta], []}, S, E);
_ when Error == pin ->
function_error(Meta, E, ?MODULE, {undefined_var_pin, Name, Kind}),
{{Name, Meta, Kind}, S#elixir_ex{tainted_function=true}, E};
_ when Error == raise ->
SpanMeta = elixir_env:calculate_span(Meta, Name),
function_error(SpanMeta, E, ?MODULE, {undefined_var, Name, Kind}),
{{Name, SpanMeta, Kind}, S#elixir_ex{tainted_function=true}, E}
end
end;
%% Local calls
expand({Atom, Meta, Args}, S, E) when is_atom(Atom), is_list(Meta), is_list(Args) ->
assert_no_ambiguous_op(Atom, Meta, Args, S, E),
elixir_dispatch:dispatch_import(Meta, Atom, Args, S, E, fun
({AR, AF}) ->
expand_remote(AR, Meta, AF, Meta, Args, S, elixir_env:prepare_write(S, E), E);
(local) ->
expand_local(Meta, Atom, Args, S, E)
end);
%% Remote calls
expand({{'.', DotMeta, [Left, Right]}, Meta, Args}, S, E)
when (is_tuple(Left) orelse is_atom(Left)), is_atom(Right), is_list(Meta), is_list(Args) ->
{ELeft, SL, EL} = expand(Left, elixir_env:prepare_write(S, E), E),
elixir_dispatch:dispatch_require(Meta, ELeft, Right, Args, S, EL, fun(AR, AF) ->
expand_remote(AR, DotMeta, AF, Meta, Args, S, SL, EL)
end);
%% Anonymous calls
expand({{'.', DotMeta, [Expr]}, Meta, Args}, S, E) when is_list(Args) ->
assert_no_match_or_guard_scope(Meta, "anonymous call", S, E),
{[EExpr | EArgs], SA, EA} = expand_args([Expr | Args], S, E),
{{{'.', DotMeta, [EExpr]}, Meta, EArgs}, SA, EA};
%% Invalid calls
expand({_, Meta, Args} = Invalid, _S, E) when is_list(Meta) and is_list(Args) ->
file_error(Meta, E, ?MODULE, {invalid_call, Invalid});
%% Literals
expand({Left, Right}, S, E) ->
{[ELeft, ERight], SE, EE} = expand_args([Left, Right], S, E),
{{ELeft, ERight}, SE, EE};
expand(List, S, #{context := match} = E) when is_list(List) ->
expand_list(List, fun expand/3, S, E, []);
expand(List, S, E) when is_list(List) ->
{EArgs, {SE, _}, EE} =
expand_list(List, fun expand_arg/3, {elixir_env:prepare_write(S), S}, E, []),
{EArgs, elixir_env:close_write(SE, S), EE};
expand(Zero, S, #{context := match} = E) when is_float(Zero), Zero == 0.0 ->
elixir_errors:file_warn([], E, ?MODULE, invalid_match_on_zero_float),
{Zero, S, E};
expand(Other, S, E) when is_number(Other); is_atom(Other); is_binary(Other) ->
{Other, S, E};
expand(Function, S, E) when is_function(Function) ->
case (erlang:fun_info(Function, type) == {type, external}) andalso
(erlang:fun_info(Function, env) == {env, []}) of
true ->
{elixir_quote:fun_to_quoted(Function), S, E};
false ->
file_error([{line, 0}], ?key(E, file), ?MODULE, {invalid_quoted_expr, Function})
end;
expand(Pid, S, E) when is_pid(Pid) ->
case ?key(E, function) of
nil ->
{Pid, S, E};
Function ->
%% TODO: Make me an error on v2.0
elixir_errors:file_warn([], E, ?MODULE, {invalid_pid_in_function, Pid, Function}),
{Pid, S, E}
end;
expand(Other, _S, E) ->
file_error([{line, 0}], ?key(E, file), ?MODULE, {invalid_quoted_expr, Other}).
%% Helpers
escape_env_entries(Meta, #elixir_ex{vars={Read, _}}, Env0) ->
Env1 = case Env0 of
#{function := nil} -> Env0;
_ -> Env0#{lexical_tracker := nil, tracers := []}
end,
Env1#{versioned_vars := escape_map(Read), line := ?line(Meta)}.
escape_map(Map) -> {'%{}', [], lists:sort(maps:to_list(Map))}.
expand_multi_alias_call(Kind, Meta, Base, Refs, Opts, S, E) ->
{BaseRef, SB, EB} = expand_without_aliases_report(Base, S, E),
case is_atom(BaseRef) of
true ->
Fun = fun
({'__aliases__', _, Ref}, SR, ER) ->
expand({Kind, Meta, [elixir_aliases:concat([BaseRef | Ref]), Opts]}, SR, ER);
(Ref, SR, ER) when is_atom(Ref) ->
expand({Kind, Meta, [elixir_aliases:concat([BaseRef, Ref]), Opts]}, SR, ER);
(Other, _SR, _ER) ->
file_error(Meta, E, ?MODULE, {expected_compile_time_module, Kind, Other})
end,
mapfold(Fun, SB, EB, Refs);
false ->
file_error(Meta, E, ?MODULE, {invalid_alias, Base})
end.
resolve_super(Meta, Arity, E) ->
Module = assert_module_scope(Meta, super, E),
Function = assert_function_scope(Meta, super, E),
case Function of
{_, Arity} ->
{Kind, Name, SuperMeta} = elixir_overridable:super(Meta, Module, Function, E),
maybe_warn_deprecated_super_in_gen_server_callback(Meta, Function, SuperMeta, E),
{Kind, Name, SuperMeta};
_ ->
file_error(Meta, E, ?MODULE, wrong_number_of_args_for_super)
end.
expand_fn_capture(Meta, Arg, S, E) ->
case elixir_fn:capture(Meta, Arg, S, E) of
{{remote, Remote, Fun, Arity}, RequireMeta, DotMeta, SE, EE} ->
AttachedMeta = attach_runtime_module(Remote, RequireMeta, S, E),
{{'&', Meta, [{'/', [], [{{'.', DotMeta, [Remote, Fun]}, AttachedMeta, []}, Arity]}]}, SE, EE};
{{local, Fun, Arity}, _, _, _SE, #{function := nil}} ->
file_error(Meta, E, ?MODULE, {undefined_local_capture, Fun, Arity});
{{local, Fun, Arity}, LocalMeta, _, SE, EE} ->
{{'&', Meta, [{'/', [], [{Fun, LocalMeta, nil}, Arity]}]}, SE, EE};
{expand, Expr, SE, EE} ->
expand(Expr, SE, EE)
end.
expand_list([{'|', Meta, [_, _] = Args}], Fun, S, E, List) ->
{EArgs, SAcc, EAcc} = mapfold(Fun, S, E, Args),
expand_list([], Fun, SAcc, EAcc, [{'|', Meta, EArgs} | List]);
expand_list([H | T], Fun, S, E, List) ->
{EArg, SAcc, EAcc} = Fun(H, S, E),
expand_list(T, Fun, SAcc, EAcc, [EArg | List]);
expand_list([], _Fun, S, E, List) ->
{lists:reverse(List), S, E}.
expand_block([], Acc, _Meta, S, E) ->
{lists:reverse(Acc), S, E};
expand_block([H], Acc, Meta, S, E) ->
{EH, SE, EE} = expand(H, S, E),
expand_block([], [EH | Acc], Meta, SE, EE);
expand_block([{for, _, [_ | _]} = H | T], Acc, Meta, S, E) ->
{EH, SE, EE} = expand_for(H, S, E, false),
expand_block(T, [EH | Acc], Meta, SE, EE);
expand_block([{'=', _, [{'_', _, Ctx}, {for, _, [_ | _]} = H]} | T], Acc, Meta, S, E) when is_atom(Ctx) ->
{EH, SE, EE} = expand_for(H, S, E, false),
expand_block(T, [EH | Acc], Meta, SE, EE);
expand_block([H | T], Acc, Meta, S, E) ->
{EH, SE, EE} = expand(H, S, E),
%% Note that checks rely on the code BEFORE expansion
%% instead of relying on Erlang checks.
%%
%% That's because expansion may generate useless
%% terms on their own (think compile time removed
%% logger calls) and we don't want to catch those.
%%
%% Or, similarly, the work is all in the expansion
%% (for example, to register something) and it is
%% simply returning something as replacement.
case is_useless_building(H, EH, Meta) of
{UselessMeta, UselessTerm} ->
elixir_errors:file_warn(UselessMeta, E, ?MODULE, UselessTerm);
false ->
ok
end,
expand_block(T, [EH | Acc], Meta, SE, EE).
%% Note that we don't handle atoms on purpose. They are common
%% when unquoting AST and it is unlikely that we would catch
%% bugs as we don't do binary operations on them like in
%% strings or numbers.
is_useless_building(H, _, Meta) when is_binary(H); is_number(H) ->
{Meta, {useless_literal, H}};
is_useless_building({'@', Meta, [{Var, _, Ctx}]}, _, _) when is_atom(Ctx); Ctx == [] ->
{Meta, {useless_attr, Var}};
is_useless_building({Var, Meta, Ctx}, {Var, _, Ctx}, _) when is_atom(Ctx) ->
{Meta, {useless_var, Var}};
is_useless_building(_, _, _) ->
false.
%% Variables in arguments are not propagated from one
%% argument to the other. For instance:
%%
%% x = 1
%% foo(x = x + 2, x)
%% x
%%
%% Should be the same as:
%%
%% foo(3, 1)
%% 3
%%
%% However, lexical information is.
expand_arg(Arg, Acc, E) when is_number(Arg); is_atom(Arg); is_binary(Arg); is_pid(Arg) ->
{Arg, Acc, E};
expand_arg(Arg, {Acc, S}, E) ->
{EArg, SAcc, EAcc} = expand(Arg, elixir_env:reset_read(Acc, S), E),
{EArg, {SAcc, S}, EAcc}.
expand_args([Arg], S, E) ->
{EArg, SE, EE} = expand(Arg, S, E),
{[EArg], SE, EE};
expand_args(Args, S, #{context := match} = E) ->
mapfold(fun expand/3, S, E, Args);
expand_args(Args, S, E) ->
{EArgs, {SA, _}, EA} = mapfold(fun expand_arg/3, {elixir_env:prepare_write(S), S}, E, Args),
{EArgs, elixir_env:close_write(SA, S), EA}.
mapfold(Fun, S, E, List) ->
mapfold(Fun, S, E, List, []).
mapfold(Fun, S, E, [H | T], Acc) ->
{RH, RS, RE} = Fun(H, S, E),
mapfold(Fun, RS, RE, T, [RH | Acc]);
mapfold(_Fun, S, E, [], Acc) ->
{lists:reverse(Acc), S, E}.
%% Match/var helpers
var_unused({_, Kind} = Pair, Meta, Version, Unused, Override) ->
case (Kind == nil) andalso should_warn(Meta) of
true -> Unused#{{Pair, Version} => {Meta, Override}};
false -> Unused
end.
var_used({_, Kind} = Pair, Meta, Version, Unused) ->
KeepUnused = lists:keymember(keep_unused, 1, Meta),
if
KeepUnused -> Unused;
is_atom(Kind) -> Unused#{{Pair, Version} => false};
true -> Unused
end.
maybe_warn_underscored_var_repeat(Meta, Name, Kind, E) ->
case should_warn(Meta) andalso atom_to_list(Name) of
"_" ++ _ ->
elixir_errors:file_warn(Meta, E, ?MODULE, {underscored_var_repeat, Name, Kind});
_ ->
ok
end.
maybe_warn_underscored_var_access(Meta, Name, Kind, E) ->
case (Kind == nil) andalso should_warn(Meta) andalso atom_to_list(Name) of
"_" ++ _ ->
elixir_errors:file_warn(Meta, E, ?MODULE, {underscored_var_access, Name});
_ ->
ok
end.
%% TODO: Remove this on Elixir v2.0 and make all GenServer callbacks optional
maybe_warn_deprecated_super_in_gen_server_callback(Meta, Function, SuperMeta, E) ->
case lists:keyfind(context, 1, SuperMeta) of
{context, 'Elixir.GenServer'} ->
case Function of
{child_spec, 1} ->
ok;
_ ->
elixir_errors:file_warn(Meta, E, ?MODULE, {super_in_genserver, Function})
end;
_ ->
ok
end.
should_warn(Meta) ->
lists:keyfind(generated, 1, Meta) /= {generated, true}.
%% Case
expand_case(Meta, Expr, Opts, S, E) ->
{EExpr, SE, EE} = expand(Expr, S, E),
ROpts =
case lists:member({optimize_boolean, true}, Meta) andalso elixir_utils:returns_boolean(EExpr) of
true -> rewrite_case_clauses(Opts);
false -> Opts
end,
{EOpts, #elixir_ex{version=Counter} = SO, EO} = elixir_clauses:'case'(Meta, ROpts, SE, EE),
{{'case', [{version, Counter} | Meta], [EExpr, EOpts]}, SO#elixir_ex{version=Counter+1}, EO}.
rewrite_case_clauses([{do, [
{'->', FalseMeta, [
[{'when', _, [{Var, _, ?kernel}, {{'.', _, ['erlang', 'orelse']}, _, [
{{'.', _, ['erlang', '=:=']}, _, [{Var, _, ?kernel}, false]},
{{'.', _, ['erlang', '=:=']}, _, [{Var, _, ?kernel}, nil]}
]}]}],
FalseExpr
]},
{'->', TrueMeta, [
[{'_', _, _}],
TrueExpr
]}
]}]) ->
rewrite_case_clauses(FalseMeta, FalseExpr, TrueMeta, TrueExpr);
rewrite_case_clauses([{do, [
{'->', FalseMeta, [[false], FalseExpr]},
{'->', TrueMeta, [[true], TrueExpr]} | _
]}]) ->
rewrite_case_clauses(FalseMeta, FalseExpr, TrueMeta, TrueExpr);
rewrite_case_clauses(Opts) ->
Opts.
rewrite_case_clauses(FalseMeta, FalseExpr, TrueMeta, TrueExpr) ->
[{do, [
{'->', FalseMeta, [[false], FalseExpr]},
{'->', TrueMeta, [[true], TrueExpr]}
]}].
%% Comprehensions
expand_for({for, Meta, [_ | _] = Args}, S, E, Return) ->
assert_no_match_or_guard_scope(Meta, "for", S, E),
{Cases, Block} = elixir_utils:split_opts(Args),
validate_opts(Meta, for, [do, into, uniq, reduce], Block, E),
{Expr, Opts} =
case lists:keytake(do, 1, Block) of
{value, {do, Do}, DoOpts} ->
{Do, DoOpts};
false ->
file_error(Meta, E, ?MODULE, {missing_option, for, [do]})
end,
{EOpts, SO, EO} = expand(Opts, elixir_env:reset_unused_vars(S), E),
{ECases, SC, EC} = mapfold(fun expand_for_generator/3, SO, EO, Cases),
assert_generator_start(Meta, ECases, E),
{{EExpr, SE, EE}, NormalizedOpts} =
case validate_for_options(EOpts, false, false, false, Return, Meta, E, []) of
{ok, MaybeReduce, NOpts} -> {expand_for_do_block(Meta, Expr, SC, EC, MaybeReduce), NOpts};
{error, Error} -> {file_error(Meta, E, ?MODULE, Error), EOpts}
end,
#elixir_ex{version=Counter} = SF = elixir_env:merge_and_check_unused_vars(SE, S, EE),
{{for, [{version, Counter} | Meta], ECases ++ [[{do, EExpr} | NormalizedOpts]]},
SF#elixir_ex{version=Counter+1}, E}.
validate_for_options([{into, _} = Pair | Opts], _Into, Uniq, Reduce, Return, Meta, E, Acc) ->
validate_for_options(Opts, Pair, Uniq, Reduce, Return, Meta, E, [Pair | Acc]);
validate_for_options([{uniq, Boolean} = Pair | Opts], Into, _Uniq, Reduce, Return, Meta, E, Acc) when is_boolean(Boolean) ->
validate_for_options(Opts, Into, Pair, Reduce, Return, Meta, E, [Pair | Acc]);
validate_for_options([{uniq, Value} | _], _, _, _, _, _, _, _) ->
{error, {for_invalid_uniq, Value}};
validate_for_options([{reduce, _} = Pair | Opts], Into, Uniq, _Reduce, Return, Meta, E, Acc) ->
validate_for_options(Opts, Into, Uniq, Pair, Return, Meta, E, [Pair | Acc]);
validate_for_options([], Into, Uniq, {reduce, _}, _Return, _Meta, _E, _Acc) when Into /= false; Uniq /= false ->
{error, for_conflicting_reduce_into_uniq};
validate_for_options([], _Into = false, Uniq, Reduce = false, Return = true, Meta, E, Acc) ->
Pair = {into, []},
validate_for_options([Pair], Pair, Uniq, Reduce, Return, Meta, E, Acc);
validate_for_options([], Into = false, {uniq, true}, Reduce = false, Return = false, Meta, E, Acc) ->
elixir_errors:file_warn(Meta, E, ?MODULE, for_with_unused_uniq),
AccWithoutUniq = lists:keydelete(uniq, 1, Acc),
validate_for_options([], Into, false, Reduce, Return, Meta, E, AccWithoutUniq);
validate_for_options([], _Into, _Uniq, Reduce, _Return, _Meta, _E, Acc) ->
{ok, Reduce, lists:reverse(Acc)}.
expand_for_do_block(Meta, [{'->', _, _} | _], _S, E, false) ->
file_error(Meta, E, ?MODULE, for_without_reduce_bad_block);
expand_for_do_block(_Meta, Expr, S, E, false) ->
expand(Expr, S, E);
expand_for_do_block(Meta, [{'->', _, _} | _] = Clauses, S, E, {reduce, _}) ->
Transformer = fun
({_, _, [[{'when', _, [_, _, _ | _]}], _]}, _) ->
file_error(Meta, E, ?MODULE, for_with_reduce_bad_block);
({_, _, [[_], _]} = Clause, SA) ->
SReset = elixir_env:reset_unused_vars(SA),
{EClause, SAcc, EAcc} =
elixir_clauses:clause(Meta, fn, fun elixir_clauses:head/4, Clause, SReset, E),
{EClause, elixir_env:merge_and_check_unused_vars(SAcc, SA, EAcc)};
(_, _) ->
file_error(Meta, E, ?MODULE, for_with_reduce_bad_block)
end,
{Do, SA} = lists:mapfoldl(Transformer, S, Clauses),
{Do, SA, E};
expand_for_do_block(Meta, _Expr, _S, E, {reduce, _}) ->
file_error(Meta, E, ?MODULE, for_with_reduce_bad_block).
%% Locals
assert_no_ambiguous_op(Name, Meta, [Arg], S, E) ->
case lists:keyfind(ambiguous_op, 1, Meta) of
{ambiguous_op, Kind} ->
Pair = {Name, Kind},
case S#elixir_ex.vars of
{#{Pair := _}, _} ->
file_error(Meta, E, ?MODULE, {op_ambiguity, Name, Arg});
_ ->
ok
end;
_ ->
ok
end;
assert_no_ambiguous_op(_Atom, _Meta, _Args, _S, _E) ->
ok.
expand_local(Meta, Name, Args, S, #{function := Function, context := Context} = E)
when Function /= nil ->
%% In case we have the wrong context, we log a module error
%% so we can print multiple entries at the same time.
case Context of
match ->
module_error(Meta, E, ?MODULE, {invalid_local_invocation, "match", {Name, Meta, Args}});
guard ->
module_error(Meta, E, ?MODULE, {invalid_local_invocation, elixir_utils:guard_info(S), {Name, Meta, Args}});
nil ->
elixir_env:trace({local_function, Meta, Name, length(Args)}, E)
end,
{EArgs, SA, EA} = expand_args(Args, S, E),
{{Name, Meta, EArgs}, SA, EA};
expand_local(Meta, Name, Args, _S, #{function := nil} = E) ->
file_error(Meta, E, ?MODULE, {undefined_function, Name, Args}).
%% Remote
expand_remote(Receiver, DotMeta, Right, Meta, Args, S, SL, #{context := Context} = E)
when is_atom(Receiver) or is_tuple(Receiver) ->
if
Context =:= guard, is_tuple(Receiver) ->
(lists:keyfind(no_parens, 1, Meta) /= {no_parens, true}) andalso
function_error(Meta, E, ?MODULE, {parens_map_lookup, Receiver, Right, elixir_utils:guard_info(S)}),
{{{'.', DotMeta, [Receiver, Right]}, Meta, []}, SL, E};
Context =:= nil ->
AttachedMeta = attach_runtime_module(Receiver, Meta, S, E),
{EArgs, {SA, _}, EA} = mapfold(fun expand_arg/3, {SL, S}, E, Args),
SA#elixir_ex.tainted_function andalso is_atom(Receiver) andalso
is_loaded_and_not_exported(Receiver, Right, Args) andalso
elixir_errors:file_warn(Meta, E, ?MODULE, {undefined_function, Receiver, Right, length(Args)}),
Rewritten = elixir_rewrite:rewrite(Receiver, DotMeta, Right, AttachedMeta, EArgs),
{Rewritten, elixir_env:close_write(SA, S), EA};
true ->
case {Receiver, Right, Args} of
{erlang, '+', [Arg]} when is_number(Arg) -> {+Arg, SL, E};
{erlang, '-', [Arg]} when is_number(Arg) -> {-Arg, SL, E};
_ ->
{EArgs, SA, EA} = mapfold(fun expand/3, SL, E, Args),
case elixir_rewrite:Context(Receiver, DotMeta, Right, Meta, EArgs, S) of
{ok, Rewritten} -> {Rewritten, SA, EA};
{error, Error} -> file_error(Meta, E, elixir_rewrite, Error)
end
end
end;
expand_remote(Receiver, DotMeta, Right, Meta, Args, _, _, E) ->
Call = {{'.', DotMeta, [Receiver, Right]}, Meta, Args},
file_error(Meta, E, ?MODULE, {invalid_call, Call}).
is_loaded_and_not_exported(Receiver, Fun, Args) ->
(code:ensure_loaded(Receiver) =:= {module, Receiver}) andalso
not erlang:function_exported(Receiver, Fun, length(Args)).
attach_runtime_module(Receiver, Meta, S, _E) ->
case lists:member(Receiver, S#elixir_ex.runtime_modules) of
true -> [{runtime_module, true} | Meta];
false -> Meta
end.
%% Lexical helpers
expand_opts(Meta, Kind, Allowed, Opts, S, E) ->
{EOpts, SE, EE} = expand(Opts, S, E),
validate_opts(Meta, Kind, Allowed, EOpts, EE),
{EOpts, SE, EE}.
validate_opts(Meta, Kind, Allowed, Opts, E) when is_list(Opts) ->
[begin
file_error(Meta, E, ?MODULE, {unsupported_option, Kind, Key})
end || {Key, _} <- Opts, not lists:member(Key, Allowed)];
validate_opts(Meta, Kind, _Allowed, Opts, E) ->
file_error(Meta, E, ?MODULE, {options_are_not_keyword, Kind, Opts}).
no_alias_opts(Opts) when is_list(Opts) ->
case lists:keyfind(as, 1, Opts) of
{as, As} -> lists:keystore(as, 1, Opts, {as, no_alias_expansion(As)});
false -> Opts
end;
no_alias_opts(Opts) -> Opts.
no_alias_expansion({'__aliases__', _, [H | T]}) when is_atom(H) ->
elixir_aliases:concat([H | T]);
no_alias_expansion(Other) ->
Other.
should_warn(_Meta, _Opts, #{lexical_tracker := nil}) ->
false;
should_warn(Meta, Opts, #{lexical_tracker := Pid}) ->
case lists:keyfind(warn, 1, Opts) of
{warn, false} -> false;
{warn, true} -> Pid;
false ->
case lists:keymember(context, 1, Meta) of
true -> false;
false -> Pid
end
end.
%% Aliases
alias(Meta, Ref, IncludeByDefault, Opts, E) ->
case elixir_aliases:alias(Meta, Ref, IncludeByDefault, Opts, E, true) of
{ok, New, EA} -> {ok, New, EA};
{error, Reason} -> elixir_errors:file_error(Meta, E, elixir_aliases, Reason)
end.
expand_without_aliases_report({'__aliases__', _, _} = Alias, S, E) ->
expand_aliases(Alias, S, E, false);
expand_without_aliases_report(Other, S, E) ->
expand(Other, S, E).
expand_aliases({'__aliases__', Meta, List} = Alias, S, E, Report) ->
case elixir_aliases:expand_or_concat(Meta, List, E, true) of
Receiver when is_atom(Receiver) ->
if
Receiver =:= 'Elixir.True'; Receiver =:= 'Elixir.False'; Receiver =:= 'Elixir.Nil' ->
elixir_errors:file_warn(Meta, E, ?MODULE, {commonly_mistaken_alias, Receiver});
true ->
ok
end,
Report andalso elixir_env:trace({alias_reference, Meta, Receiver}, E),
{Receiver, S, E};
[Head | Tail] ->
{EHead, SA, EA} = expand(Head, S, E),
case is_atom(EHead) of
true ->
Receiver = elixir_aliases:concat([EHead | Tail]),
Report andalso elixir_env:trace({alias_reference, Meta, Receiver}, E),
{Receiver, SA, EA};
false ->
file_error(Meta, E, ?MODULE, {invalid_alias, Alias})
end
end.
%% Comprehensions
expand_for_generator({'<-', Meta, [Left, Right]}, S, E) ->
{ERight, SR, ER} = expand(Right, S, E),
SM = elixir_env:reset_read(SR, S),
{[ELeft], SL, EL} = elixir_clauses:head(Meta, [Left], SM, ER),
{{'<-', Meta, [ELeft, ERight]}, SL, EL};
expand_for_generator({'<<>>', Meta, Args} = X, S, E) when is_list(Args) ->
case elixir_utils:split_last(Args) of
{LeftStart, {'<-', OpMeta, [LeftEnd, Right]}} ->
{ERight, SR, ER} = expand(Right, S, E),
SM = elixir_env:reset_read(SR, S),
{ELeft, SL, EL} = elixir_clauses:match(fun(BArg, BS, BE) ->
elixir_bitstring:expand(Meta, BArg, BS, BE, true)
end, Meta, LeftStart ++ [LeftEnd], SM, SM, ER),
{{'<<>>', Meta, [{'<-', OpMeta, [ELeft, ERight]}]}, SL, EL};
_ ->
expand(X, S, E)
end;
expand_for_generator(X, S, E) ->
expand(X, S, E).
assert_generator_start(_, [{'<-', _, [_, _]} | _], _) ->
ok;
assert_generator_start(_, [{'<<>>', _, [{'<-', _, [_, _]}]} | _], _) ->
ok;
assert_generator_start(Meta, _, E) ->
elixir_errors:file_error(Meta, E, ?MODULE, for_generator_start).
%% Assertions
assert_module_scope(Meta, Kind, #{module := nil, file := File}) ->
file_error(Meta, File, ?MODULE, {invalid_expr_in_scope, "module", Kind});
assert_module_scope(_Meta, _Kind, #{module:=Module}) -> Module.
assert_function_scope(Meta, Kind, #{function := nil, file := File}) ->
file_error(Meta, File, ?MODULE, {invalid_expr_in_scope, "function", Kind});
assert_function_scope(_Meta, _Kind, #{function := Function}) -> Function.
assert_no_match_or_guard_scope(Meta, Kind, S, E) ->
assert_no_match_scope(Meta, Kind, E),
assert_no_guard_scope(Meta, Kind, S, E).
assert_no_match_scope(Meta, Kind, #{context := match, file := File}) ->
file_error(Meta, File, ?MODULE, {invalid_pattern_in_match, Kind});
assert_no_match_scope(_Meta, _Kind, _E) -> ok.
assert_no_guard_scope(Meta, Kind, S, #{context := guard, file := File}) ->
Key =
case S of
#elixir_ex{prematch={_, _, {bitsize, _}}} -> invalid_expr_in_bitsize;
_ -> invalid_expr_in_guard
end,
file_error(Meta, File, ?MODULE, {Key, Kind});
assert_no_guard_scope(_Meta, _Kind, _S, _E) -> ok.
%% Here we look into the Clauses "optimistically", that is, we don't check for
%% multiple "do"s and similar stuff. After all, the error we're gonna give here
%% is just a friendlier version of the "undefined variable _" error that we
%% would raise if we found a "_ -> ..." clause in a "cond". For this reason, if
%% Clauses has a bad shape, we just do nothing and let future functions catch
%% this.
assert_no_underscore_clause_in_cond([{do, Clauses}], E) when is_list(Clauses) ->
case lists:last(Clauses) of
{'->', Meta, [[{'_', _, Atom}], _]} when is_atom(Atom) ->
file_error(Meta, E, ?MODULE, underscore_in_cond);
_Other ->
ok
end;
assert_no_underscore_clause_in_cond(_Other, _E) ->
ok.
%% Errors
format_error({undefined_function, Module, Fun, Arity}) ->
Opts = [{module, Module}, {function, Fun}, {arity, Arity}],
Exception = 'Elixir.UndefinedFunctionError':exception(Opts),
{BlamedException, _} = 'Elixir.UndefinedFunctionError':blame(Exception, []),
'Elixir.UndefinedFunctionError':message(BlamedException);
format_error(invalid_match_on_zero_float) ->
"pattern matching on 0.0 is equivalent to matching only on +0.0. Instead you must match on +0.0 or -0.0";
format_error({useless_literal, Term}) ->
io_lib:format("code block contains unused literal ~ts "
"(remove the literal or assign it to _ to avoid warnings)",
['Elixir.Macro':to_string(Term)]);
format_error({useless_var, Var}) ->
io_lib:format("variable ~ts in code block has no effect as it is never returned "
"(remove the variable or assign it to _ to avoid warnings)",
[Var]);
format_error({useless_attr, Attr}) ->
io_lib:format("module attribute @~ts in code block has no effect as it is never returned "
"(remove the attribute or assign it to _ to avoid warnings)",
[Attr]);
format_error({missing_option, Construct, Opts}) when is_list(Opts) ->
StringOpts = lists:map(fun(Opt) -> [$: | atom_to_list(Opt)] end, Opts),
io_lib:format("missing ~ts option in \"~ts\"", [string:join(StringOpts, "/"), Construct]);
format_error({invalid_args, Construct}) ->
io_lib:format("invalid arguments for \"~ts\"", [Construct]);
format_error({for_invalid_uniq, Value}) ->
io_lib:format(":uniq option for comprehensions only accepts a boolean, got: ~ts", ['Elixir.Macro':to_string(Value)]);
format_error(for_conflicting_reduce_into_uniq) ->
"cannot use :reduce alongside :into/:uniq in comprehension";
format_error(for_with_reduce_bad_block) ->
"when using :reduce with comprehensions, the do block must be written using acc -> expr clauses, where each clause expects the accumulator as a single argument";
format_error(for_without_reduce_bad_block) ->
"the do block was written using acc -> expr clauses but the :reduce option was not given";
format_error(for_generator_start) ->
"for comprehensions must start with a generator";
format_error(for_with_unused_uniq) ->
"the :uniq option has no effect since the result of the for comprehension is not used";
format_error(unhandled_arrow_op) ->
"misplaced operator ->\n\n"
"This typically means invalid syntax or a macro is not available in scope";
format_error(unhandled_cons_op) ->
"misplaced operator |/2\n\n"
"The | operator is typically used between brackets to mark the tail of a list:\n\n"
" [head | tail]\n"
" [head, middle, ... | tail]\n\n"
"It is also used to update maps and structs, via the %{map | key: value} notation, "
"and in typespecs, such as @type and @spec, to express the union of two types";
format_error(unhandled_type_op) ->
"misplaced operator ::/2\n\n"
"The :: operator is typically used in bitstrings to specify types and sizes of segments:\n\n"
" <<size::32-integer, letter::utf8, rest::binary>>\n\n"
"It is also used in typespecs, such as @type and @spec, to describe inputs and outputs";
format_error(as_in_multi_alias_call) ->
":as option is not supported by multi-alias call";
format_error({commonly_mistaken_alias, Ref}) ->
Module = 'Elixir.Macro':to_string(Ref),
io_lib:format("reserved alias \"~ts\" expands to the atom :\"Elixir.~ts\". Perhaps you meant to write \"~ts\" instead?", [Module, Module, string:casefold(Module)]);
format_error({expected_compile_time_module, Kind, GivenTerm}) ->
io_lib:format("invalid argument for ~ts, expected a compile time atom or alias, got: ~ts",
[Kind, 'Elixir.Macro':to_string(GivenTerm)]);
format_error({unquote_outside_quote, Unquote}) ->
%% Unquote can be "unquote" or "unquote_splicing".
io_lib:format("~p called outside quote", [Unquote]);
format_error(quote_in_pattern_with_unquote) ->
"unquote is not allowed when quote is used inside a pattern or guard";
format_error({invalid_bind_quoted_for_quote, BQ}) ->
io_lib:format("invalid :bind_quoted for quote, expected a keyword list of variable names, got: ~ts",
['Elixir.Macro':to_string(BQ)]);
format_error(wrong_number_of_args_for_super) ->
"super must be called with the same number of arguments as the current definition";
format_error({invalid_arg_for_pin, Arg}) ->
io_lib:format("invalid argument for unary operator ^, expected an existing variable, got: ^~ts",
['Elixir.Macro':to_string(Arg)]);
format_error({pin_outside_of_match, Arg}) ->
io_lib:format(
"misplaced operator ^~ts\n\n"
"The pin operator ^ is supported only inside matches or inside custom macros. "
"Make sure you are inside a match or all necessary macros have been required",
['Elixir.Macro':to_string(Arg)]
);
format_error(unbound_underscore) ->
"invalid use of _. _ can only be used inside patterns to ignore values and cannot be used in expressions. Make sure you are inside a pattern or change it accordingly";
format_error({undefined_var, Name, Kind}) ->
io_lib:format("undefined variable ~ts", [elixir_utils:var_info(Name, Kind)]);
format_error({undefined_var_pin, Name, Kind}) ->
Message = "undefined variable ^~ts. No variable ~ts has been defined before the current pattern",
io_lib:format(Message, [Name, elixir_utils:var_info(Name, Kind)]);
format_error(underscore_in_cond) ->
"invalid use of _ inside \"cond\". If you want the last clause to always match, "
"you probably meant to use: true ->";
format_error({invalid_pattern_in_match, Kind}) ->
io_lib:format("invalid pattern in match, ~ts is not allowed in matches", [Kind]);
format_error({invalid_expr_in_scope, Scope, Kind}) ->
io_lib:format("cannot invoke ~ts outside ~ts", [Kind, Scope]);
format_error({invalid_expr_in_guard, Kind}) ->
Message =
"invalid expression in guards, ~ts is not allowed in guards. To learn more about "
"guards, visit: https://hexdocs.pm/elixir/patterns-and-guards.html#guards",
io_lib:format(Message, [Kind]);
format_error({invalid_expr_in_bitsize, Kind}) ->
Message =
"~ts is not allowed inside a bitstring size specifier. The size specifier in matches works like guards. "
"To learn more about guards, visit: https://hexdocs.pm/elixir/patterns-and-guards.html#guards",
io_lib:format(Message, [Kind]);
format_error({invalid_alias, Expr}) ->
Message =
"invalid alias: \"~ts\". If you wanted to define an alias, an alias must expand "
"to an atom at compile time but it did not, you may use Module.concat/2 to build "
"it at runtime. If instead you wanted to invoke a function or access a field, "
"wrap the function or field name in double quotes",
io_lib:format(Message, ['Elixir.Macro':to_string(Expr)]);
format_error({op_ambiguity, Name, Arg}) ->
NameString = atom_to_binary(Name),
ArgString = 'Elixir.Macro':to_string(Arg),
Message =
"\"~ts ~ts\" looks like a function call but there is a variable named \"~ts\". "
"If you want to perform a function call, use parentheses:\n"
"\n"
" ~ts(~ts)\n"
"\n"
"If you want to perform an operation on the variable ~ts, use spaces "
"around the unary operator",
io_lib:format(Message, [NameString, ArgString, NameString, NameString, ArgString, NameString]);
format_error({invalid_clauses, Name}) ->
Message =
"the function \"~ts\" cannot handle clauses with the -> operator because it is not a macro. "
"Please make sure you are invoking the proper name and that it is a macro",
io_lib:format(Message, [Name]);
format_error({invalid_call, Call}) ->
io_lib:format("invalid call ~ts", ['Elixir.Macro':to_string(Call)]);
format_error({invalid_quoted_expr, Expr}) ->
Message =
"invalid quoted expression: ~ts\n\n"
"Please make sure your quoted expressions are made of valid AST nodes. "
"If you would like to introduce a value into the AST, such as a four-element "
"tuple or a map, make sure to call Macro.escape/1 before",
io_lib:format(Message, ['Elixir.Kernel':inspect(Expr, [])]);
format_error({invalid_local_invocation, Context, {Name, _, Args} = Call}) ->
Message =
"cannot find or invoke local ~ts/~B inside a ~ts. "
"Only macros can be invoked inside a ~ts and they must be defined before their invocation. Called as: ~ts",
io_lib:format(Message, [Name, length(Args), Context, Context, 'Elixir.Macro':to_string(Call)]);
format_error({invalid_pid_in_function, Pid, {Name, Arity}}) ->
io_lib:format("cannot compile PID ~ts inside quoted expression for function ~ts/~B",
['Elixir.Kernel':inspect(Pid, []), Name, Arity]);
format_error({unsupported_option, Kind, Key}) ->
io_lib:format("unsupported option ~ts given to ~s",
['Elixir.Macro':to_string(Key), Kind]);
format_error({options_are_not_keyword, Kind, Opts}) ->
io_lib:format("invalid options for ~s, expected a keyword list, got: ~ts",
[Kind, 'Elixir.Macro':to_string(Opts)]);
format_error({undefined_function, Name, Args}) ->
io_lib:format("undefined function ~ts/~B (there is no such import)", [Name, length(Args)]);
format_error({unpinned_bitsize_var, Name, Kind}) ->
io_lib:format("the variable ~ts is accessed inside size(...) of a bitstring "
"but it was defined outside of the match. You must precede it with the "
"pin operator", [elixir_utils:var_info(Name, Kind)]);
format_error({underscored_var_repeat, Name, Kind}) ->
io_lib:format("the underscored variable ~ts appears more than once in a "
"match. This means the pattern will only match if all \"~ts\" bind "
"to the same value. If this is the intended behaviour, please "
"remove the leading underscore from the variable name, otherwise "
"give the variables different names", [elixir_utils:var_info(Name, Kind), Name]);
format_error({underscored_var_access, Name}) ->
io_lib:format("the underscored variable \"~ts\" is used after being set. "
"A leading underscore indicates that the value of the variable "
"should be ignored. If this is intended please rename the "
"variable to remove the underscore", [Name]);
format_error({nested_comparison, CompExpr}) ->
String = 'Elixir.Macro':to_string(CompExpr),
io_lib:format("Elixir does not support nested comparisons. Something like\n\n"
" x < y < z\n\n"
"is equivalent to\n\n"
" (x < y) < z\n\n"
"which ultimately compares z with the boolean result of (x < y). "
"Instead, consider joining together each comparison segment with an \"and\", for example,\n\n"
" x < y and y < z\n\n"
"You wrote: ~ts", [String]);
format_error({undefined_local_capture, Fun, Arity}) ->
io_lib:format("undefined function ~ts/~B (there is no such import)", [Fun, Arity]);
format_error(caller_not_allowed) ->
"__CALLER__ is available only inside defmacro and defmacrop";
format_error(stacktrace_not_allowed) ->
"__STACKTRACE__ is available only inside catch and rescue clauses of try expressions";
format_error({undefined_var_to_call, Name}) ->
io_lib:format("variable \"~ts\" does not exist and is being expanded to \"~ts()\","
" please use parentheses to remove the ambiguity or change the variable name", [Name, Name]);
format_error({parens_map_lookup, Map, Field, Context}) ->
io_lib:format("cannot invoke remote function inside a ~ts. "
"If you want to do a map lookup instead, please remove parens from ~ts.~ts()",
[Context, 'Elixir.Macro':to_string(Map), Field]);
format_error({super_in_genserver, {Name, Arity}}) ->
io_lib:format("calling super for GenServer callback ~ts/~B is deprecated", [Name, Arity]);
format_error('__cursor__') ->
"reserved special form __cursor__ cannot be expanded, it is used exclusively to annotate ASTs".