569 lines
15 KiB
Elixir
569 lines
15 KiB
Elixir
defmodule Kernel.CLI do
|
|
@moduledoc false
|
|
|
|
@compile {:no_warn_undefined, [Logger, IEx]}
|
|
|
|
@blank_config %{
|
|
commands: [],
|
|
output: ".",
|
|
compile: [],
|
|
no_halt: false,
|
|
compiler_options: [],
|
|
errors: [],
|
|
pa: [],
|
|
pz: [],
|
|
verbose_compile: false,
|
|
profile: nil
|
|
}
|
|
|
|
@doc """
|
|
This is the API invoked by Elixir boot process.
|
|
"""
|
|
def main(argv) do
|
|
argv = for arg <- argv, do: IO.chardata_to_string(arg)
|
|
|
|
{config, argv} = parse_argv(argv)
|
|
System.argv(argv)
|
|
System.no_halt(config.no_halt)
|
|
|
|
fun = fn _ ->
|
|
errors = process_commands(config)
|
|
|
|
if errors != [] do
|
|
Enum.each(errors, &IO.puts(:stderr, &1))
|
|
System.halt(1)
|
|
end
|
|
end
|
|
|
|
run(fun)
|
|
end
|
|
|
|
@doc """
|
|
Runs the given function by catching any failure
|
|
and printing them to stdout. `at_exit` hooks are
|
|
also invoked before exiting.
|
|
|
|
This function is used by Elixir's CLI and also
|
|
by escripts generated by Elixir.
|
|
"""
|
|
def run(fun) do
|
|
{ok_or_shutdown, status} = exec_fun(fun, {:ok, 0})
|
|
|
|
if ok_or_shutdown == :shutdown or not System.no_halt() do
|
|
{_, status} = at_exit({ok_or_shutdown, status})
|
|
|
|
# Ensure Logger messages are flushed before halting
|
|
case :erlang.whereis(Logger) do
|
|
pid when is_pid(pid) -> Logger.flush()
|
|
_ -> :ok
|
|
end
|
|
|
|
System.halt(status)
|
|
end
|
|
end
|
|
|
|
@doc """
|
|
Parses the CLI arguments. Made public for testing.
|
|
"""
|
|
def parse_argv(argv) do
|
|
parse_argv(argv, @blank_config)
|
|
end
|
|
|
|
@doc """
|
|
Process CLI commands. Made public for testing.
|
|
"""
|
|
def process_commands(config) do
|
|
results = Enum.map(Enum.reverse(config.commands), &process_command(&1, config))
|
|
errors = for {:error, msg} <- results, do: msg
|
|
Enum.reverse(config.errors, errors)
|
|
end
|
|
|
|
@doc """
|
|
Shared helper for error formatting on CLI tools.
|
|
"""
|
|
def format_error(kind, reason, stacktrace) do
|
|
{blamed, stacktrace} = Exception.blame(kind, reason, stacktrace)
|
|
|
|
iodata =
|
|
case blamed do
|
|
%FunctionClauseError{} ->
|
|
formatted = Exception.format_banner(kind, reason, stacktrace)
|
|
padded_blame = pad(FunctionClauseError.blame(blamed, &inspect/1, &blame_match/2))
|
|
[formatted, padded_blame]
|
|
|
|
_ ->
|
|
Exception.format_banner(kind, blamed, stacktrace)
|
|
end
|
|
|
|
[iodata, ?\n, Exception.format_stacktrace(prune_stacktrace(stacktrace))]
|
|
end
|
|
|
|
@doc """
|
|
Function invoked across nodes for `--rpc-eval`.
|
|
"""
|
|
def rpc_eval(expr) do
|
|
wrapper(fn -> Code.eval_string(expr) end)
|
|
catch
|
|
kind, reason -> {kind, reason, __STACKTRACE__}
|
|
end
|
|
|
|
## Helpers
|
|
|
|
defp at_exit(res) do
|
|
hooks = :elixir_config.get_and_put(:at_exit, [])
|
|
res = Enum.reduce(hooks, res, &exec_fun/2)
|
|
if hooks == [], do: res, else: at_exit(res)
|
|
end
|
|
|
|
defp exec_fun(fun, res) when is_function(fun, 1) and is_tuple(res) do
|
|
parent = self()
|
|
|
|
{pid, ref} =
|
|
spawn_monitor(fn ->
|
|
try do
|
|
fun.(elem(res, 1))
|
|
catch
|
|
:exit, {:shutdown, int} when is_integer(int) ->
|
|
send(parent, {self(), {:shutdown, int}})
|
|
exit({:shutdown, int})
|
|
|
|
:exit, reason
|
|
when reason == :normal
|
|
when reason == :shutdown
|
|
when tuple_size(reason) == 2 and elem(reason, 0) == :shutdown ->
|
|
send(parent, {self(), {:shutdown, 0}})
|
|
exit(reason)
|
|
|
|
kind, reason ->
|
|
print_error(kind, reason, __STACKTRACE__)
|
|
send(parent, {self(), {:shutdown, 1}})
|
|
exit(to_exit(kind, reason, __STACKTRACE__))
|
|
else
|
|
_ ->
|
|
send(parent, {self(), res})
|
|
end
|
|
end)
|
|
|
|
receive do
|
|
{^pid, res} ->
|
|
:erlang.demonitor(ref, [:flush])
|
|
res
|
|
|
|
{:DOWN, ^ref, _, _, other} ->
|
|
print_error({:EXIT, pid}, other, [])
|
|
{:shutdown, 1}
|
|
end
|
|
end
|
|
|
|
defp to_exit(:throw, reason, stack), do: {{:nocatch, reason}, stack}
|
|
defp to_exit(:error, reason, stack), do: {reason, stack}
|
|
defp to_exit(:exit, reason, _stack), do: reason
|
|
|
|
defp shared_option?(list, config, callback) do
|
|
case parse_shared(list, config) do
|
|
{[h | hs], _} when h == hd(list) ->
|
|
new_config = %{config | errors: ["#{h} : Unknown option" | config.errors]}
|
|
callback.(hs, new_config)
|
|
|
|
{new_list, new_config} ->
|
|
callback.(new_list, new_config)
|
|
end
|
|
end
|
|
|
|
## Error handling
|
|
|
|
defp print_error(kind, reason, stacktrace) do
|
|
IO.write(:stderr, format_error(kind, reason, stacktrace))
|
|
end
|
|
|
|
defp blame_match(%{match?: true, node: node}, _), do: blame_ansi(:normal, "+", node)
|
|
defp blame_match(%{match?: false, node: node}, _), do: blame_ansi(:red, "-", node)
|
|
defp blame_match(_, string), do: string
|
|
|
|
defp blame_ansi(color, no_ansi, node) do
|
|
if IO.ANSI.enabled?() do
|
|
[color | Macro.to_string(node)]
|
|
|> IO.ANSI.format(true)
|
|
|> IO.iodata_to_binary()
|
|
else
|
|
no_ansi <> Macro.to_string(node) <> no_ansi
|
|
end
|
|
end
|
|
|
|
defp pad(string) do
|
|
" " <> String.replace(string, "\n", "\n ")
|
|
end
|
|
|
|
@elixir_internals [:elixir, :elixir_aliases, :elixir_expand, :elixir_compiler, :elixir_module] ++
|
|
[:elixir_clauses, :elixir_lexical, :elixir_def, :elixir_map] ++
|
|
[:elixir_erl, :elixir_erl_clauses, :elixir_erl_pass, Kernel.ErrorHandler]
|
|
|
|
defp prune_stacktrace([{mod, _, _, _} | t]) when mod in @elixir_internals do
|
|
prune_stacktrace(t)
|
|
end
|
|
|
|
defp prune_stacktrace([{__MODULE__, :wrapper, 1, _} | _]) do
|
|
[]
|
|
end
|
|
|
|
defp prune_stacktrace([h | t]) do
|
|
[h | prune_stacktrace(t)]
|
|
end
|
|
|
|
defp prune_stacktrace([]) do
|
|
[]
|
|
end
|
|
|
|
# Parse shared options
|
|
|
|
defp parse_shared([opt | _t], _config) when opt in ["-v", "--version"] do
|
|
if function_exported?(IEx, :started?, 0) and IEx.started?() do
|
|
IO.puts("IEx " <> System.build_info()[:build])
|
|
else
|
|
IO.puts(:erlang.system_info(:system_version))
|
|
IO.puts("Elixir " <> System.build_info()[:build])
|
|
end
|
|
|
|
System.halt(0)
|
|
end
|
|
|
|
defp parse_shared(["-pa", h | t], config) do
|
|
paths = expand_code_path(h)
|
|
Enum.each(paths, &:code.add_patha/1)
|
|
parse_shared(t, %{config | pa: config.pa ++ paths})
|
|
end
|
|
|
|
defp parse_shared(["-pz", h | t], config) do
|
|
paths = expand_code_path(h)
|
|
Enum.each(paths, &:code.add_pathz/1)
|
|
parse_shared(t, %{config | pz: config.pz ++ paths})
|
|
end
|
|
|
|
defp parse_shared(["--app", h | t], config) do
|
|
parse_shared(t, %{config | commands: [{:app, h} | config.commands]})
|
|
end
|
|
|
|
defp parse_shared(["--no-halt" | t], config) do
|
|
parse_shared(t, %{config | no_halt: true})
|
|
end
|
|
|
|
defp parse_shared(["-e", h | t], config) do
|
|
parse_shared(t, %{config | commands: [{:eval, h} | config.commands]})
|
|
end
|
|
|
|
defp parse_shared(["--eval", h | t], config) do
|
|
parse_shared(t, %{config | commands: [{:eval, h} | config.commands]})
|
|
end
|
|
|
|
defp parse_shared(["--rpc-eval", node, h | t], config) do
|
|
node = append_hostname(node)
|
|
parse_shared(t, %{config | commands: [{:rpc_eval, node, h} | config.commands]})
|
|
end
|
|
|
|
defp parse_shared(["-r", h | t], config) do
|
|
parse_shared(t, %{config | commands: [{:require, h} | config.commands]})
|
|
end
|
|
|
|
defp parse_shared(["-pr", h | t], config) do
|
|
parse_shared(t, %{config | commands: [{:parallel_require, h} | config.commands]})
|
|
end
|
|
|
|
defp parse_shared(list, config) do
|
|
{list, config}
|
|
end
|
|
|
|
defp append_hostname(node) do
|
|
case :string.find(node, "@") do
|
|
:nomatch -> node <> :string.find(Atom.to_string(node()), "@")
|
|
_ -> node
|
|
end
|
|
end
|
|
|
|
defp expand_code_path(path) do
|
|
path = Path.expand(path)
|
|
|
|
case Path.wildcard(path) do
|
|
[] -> [to_charlist(path)]
|
|
list -> Enum.map(list, &to_charlist/1)
|
|
end
|
|
end
|
|
|
|
# Process init options
|
|
|
|
defp parse_argv(["--" | t], config) do
|
|
{config, t}
|
|
end
|
|
|
|
defp parse_argv(["+elixirc" | t], config) do
|
|
parse_compiler(t, config)
|
|
end
|
|
|
|
defp parse_argv(["+iex" | t], config) do
|
|
parse_iex(t, config)
|
|
end
|
|
|
|
defp parse_argv(["-S", h | t], config) do
|
|
{%{config | commands: [{:script, h} | config.commands]}, t}
|
|
end
|
|
|
|
defp parse_argv([h | t] = list, config) do
|
|
case h do
|
|
"-" <> _ ->
|
|
shared_option?(list, config, &parse_argv(&1, &2))
|
|
|
|
_ ->
|
|
if List.keymember?(config.commands, :eval, 0) do
|
|
{config, list}
|
|
else
|
|
{%{config | commands: [{:file, h} | config.commands]}, t}
|
|
end
|
|
end
|
|
end
|
|
|
|
defp parse_argv([], config) do
|
|
{config, []}
|
|
end
|
|
|
|
# Parse compiler options
|
|
|
|
defp parse_compiler(["--" | t], config) do
|
|
{config, t}
|
|
end
|
|
|
|
defp parse_compiler(["-o", h | t], config) do
|
|
parse_compiler(t, %{config | output: h})
|
|
end
|
|
|
|
defp parse_compiler(["--no-docs" | t], config) do
|
|
parse_compiler(t, %{config | compiler_options: [{:docs, false} | config.compiler_options]})
|
|
end
|
|
|
|
defp parse_compiler(["--no-debug-info" | t], config) do
|
|
compiler_options = [{:debug_info, false} | config.compiler_options]
|
|
parse_compiler(t, %{config | compiler_options: compiler_options})
|
|
end
|
|
|
|
defp parse_compiler(["--ignore-module-conflict" | t], config) do
|
|
compiler_options = [{:ignore_module_conflict, true} | config.compiler_options]
|
|
parse_compiler(t, %{config | compiler_options: compiler_options})
|
|
end
|
|
|
|
defp parse_compiler(["--warnings-as-errors" | t], config) do
|
|
compiler_options = [{:warnings_as_errors, true} | config.compiler_options]
|
|
parse_compiler(t, %{config | compiler_options: compiler_options})
|
|
end
|
|
|
|
defp parse_compiler(["--verbose" | t], config) do
|
|
parse_compiler(t, %{config | verbose_compile: true})
|
|
end
|
|
|
|
# Private compiler options
|
|
|
|
defp parse_compiler(["--profile", "time" | t], config) do
|
|
parse_compiler(t, %{config | profile: :time})
|
|
end
|
|
|
|
defp parse_compiler([h | t] = list, config) do
|
|
case h do
|
|
"-" <> _ ->
|
|
shared_option?(list, config, &parse_compiler(&1, &2))
|
|
|
|
_ ->
|
|
pattern = if File.dir?(h), do: "#{h}/**/*.ex", else: h
|
|
parse_compiler(t, %{config | compile: [pattern | config.compile]})
|
|
end
|
|
end
|
|
|
|
defp parse_compiler([], config) do
|
|
{%{config | commands: [{:compile, config.compile} | config.commands]}, []}
|
|
end
|
|
|
|
# Parse IEx options
|
|
|
|
defp parse_iex(["--" | t], config) do
|
|
{config, t}
|
|
end
|
|
|
|
# This clause is here so that Kernel.CLI does not
|
|
# error out with "unknown option"
|
|
defp parse_iex(["--dot-iex", _ | t], config) do
|
|
parse_iex(t, config)
|
|
end
|
|
|
|
defp parse_iex([opt, _ | t], config) when opt in ["--remsh"] do
|
|
parse_iex(t, config)
|
|
end
|
|
|
|
defp parse_iex(["-S", h | t], config) do
|
|
{%{config | commands: [{:script, h} | config.commands]}, t}
|
|
end
|
|
|
|
defp parse_iex([h | t] = list, config) do
|
|
case h do
|
|
"-" <> _ -> shared_option?(list, config, &parse_iex(&1, &2))
|
|
_ -> {%{config | commands: [{:file, h} | config.commands]}, t}
|
|
end
|
|
end
|
|
|
|
defp parse_iex([], config) do
|
|
{config, []}
|
|
end
|
|
|
|
# Process commands
|
|
|
|
defp process_command({:cookie, h}, _config) do
|
|
if Node.alive?() do
|
|
wrapper(fn -> Node.set_cookie(String.to_atom(h)) end)
|
|
else
|
|
{:error, "--cookie : Cannot set cookie if the node is not alive (set --name or --sname)"}
|
|
end
|
|
end
|
|
|
|
defp process_command({:eval, expr}, _config) when is_binary(expr) do
|
|
wrapper(fn -> Code.eval_string(expr, []) end)
|
|
end
|
|
|
|
defp process_command({:rpc_eval, node, expr}, _config) when is_binary(expr) do
|
|
case :rpc.call(String.to_atom(node), __MODULE__, :rpc_eval, [expr]) do
|
|
:ok -> :ok
|
|
{:badrpc, {:EXIT, exit}} -> Process.exit(self(), exit)
|
|
{:badrpc, reason} -> {:error, "--rpc-eval : RPC failed with reason #{inspect(reason)}"}
|
|
{kind, error, stack} -> :erlang.raise(kind, error, stack)
|
|
end
|
|
end
|
|
|
|
defp process_command({:app, app}, _config) when is_binary(app) do
|
|
case Application.ensure_all_started(String.to_atom(app)) do
|
|
{:error, {app, reason}} ->
|
|
msg = "--app : Could not start application #{app}: " <> Application.format_error(reason)
|
|
{:error, msg}
|
|
|
|
{:ok, _} ->
|
|
:ok
|
|
end
|
|
end
|
|
|
|
defp process_command({:script, file}, _config) when is_binary(file) do
|
|
if exec = find_elixir_executable(file) do
|
|
wrapper(fn -> Code.require_file(exec) end)
|
|
else
|
|
{:error, "-S : Could not find executable #{file}"}
|
|
end
|
|
end
|
|
|
|
defp process_command({:file, file}, _config) when is_binary(file) do
|
|
if File.regular?(file) do
|
|
wrapper(fn -> Code.require_file(file) end)
|
|
else
|
|
{:error, "No file named #{file}"}
|
|
end
|
|
end
|
|
|
|
defp process_command({:require, pattern}, _config) when is_binary(pattern) do
|
|
files = filter_patterns(pattern)
|
|
|
|
if files != [] do
|
|
wrapper(fn -> Enum.map(files, &Code.require_file(&1)) end)
|
|
else
|
|
{:error, "-r : No files matched pattern #{pattern}"}
|
|
end
|
|
end
|
|
|
|
defp process_command({:parallel_require, pattern}, _config) when is_binary(pattern) do
|
|
files = filter_patterns(pattern)
|
|
|
|
if files != [] do
|
|
wrapper(fn ->
|
|
case Kernel.ParallelCompiler.require(files) do
|
|
{:ok, _, _} -> :ok
|
|
{:error, _, _} -> exit({:shutdown, 1})
|
|
end
|
|
end)
|
|
else
|
|
{:error, "-pr : No files matched pattern #{pattern}"}
|
|
end
|
|
end
|
|
|
|
defp process_command({:compile, patterns}, config) do
|
|
# If ensuring the dir returns an error no files will be found.
|
|
_ = :filelib.ensure_dir(:filename.join(config.output, "."))
|
|
|
|
case filter_multiple_patterns(patterns) do
|
|
{:ok, []} ->
|
|
{:error, "No files matched provided patterns"}
|
|
|
|
{:ok, files} ->
|
|
wrapper(fn ->
|
|
Code.compiler_options(config.compiler_options)
|
|
|
|
verbose_opts =
|
|
if config.verbose_compile do
|
|
[each_long_compilation: &IO.puts("Compiling #{&1} (it's taking more than 15s)")]
|
|
else
|
|
[]
|
|
end
|
|
|
|
profile_opts =
|
|
if config.profile do
|
|
[profile: config.profile]
|
|
else
|
|
[]
|
|
end
|
|
|
|
opts = verbose_opts ++ profile_opts
|
|
|
|
case Kernel.ParallelCompiler.compile_to_path(files, config.output, opts) do
|
|
{:ok, _, _} -> :ok
|
|
{:error, _, _} -> exit({:shutdown, 1})
|
|
end
|
|
end)
|
|
|
|
{:missing, missing} ->
|
|
{:error, "No files matched pattern(s) #{Enum.join(missing, ",")}"}
|
|
end
|
|
end
|
|
|
|
defp filter_patterns(pattern) do
|
|
pattern
|
|
|> Path.wildcard()
|
|
|> :lists.usort()
|
|
|> Enum.filter(&File.regular?/1)
|
|
end
|
|
|
|
defp filter_multiple_patterns(patterns) do
|
|
{files, missing} =
|
|
Enum.reduce(patterns, {[], []}, fn pattern, {files, missing} ->
|
|
case filter_patterns(pattern) do
|
|
[] -> {files, [pattern | missing]}
|
|
match -> {match ++ files, missing}
|
|
end
|
|
end)
|
|
|
|
case missing do
|
|
[] -> {:ok, :lists.usort(files)}
|
|
_ -> {:missing, :lists.usort(missing)}
|
|
end
|
|
end
|
|
|
|
defp wrapper(fun) do
|
|
_ = fun.()
|
|
:ok
|
|
end
|
|
|
|
defp find_elixir_executable(file) do
|
|
if exec = System.find_executable(file) do
|
|
# If we are on Windows, the executable is going to be
|
|
# a .bat file that must be in the same directory as
|
|
# the actual Elixir executable.
|
|
case :os.type() do
|
|
{:win32, _} ->
|
|
base = Path.rootname(exec)
|
|
if File.regular?(base), do: base, else: exec
|
|
|
|
_ ->
|
|
exec
|
|
end
|
|
end
|
|
end
|
|
end
|