Current section

Files

Jump to
credo lib credo cli command explain.ex
Raw

lib/credo/cli/command/explain.ex

defmodule Credo.CLI.Command.Explain do
use Credo.CLI.Command
@shortdoc "Show code object and explain why it is/might be an issue"
alias Credo.Check.Runner
alias Credo.Config
alias Credo.CLI.Output.Explain
alias Credo.CLI.Output.UI
alias Credo.CLI.Output
alias Credo.Sources
# TODO: explain used config options
@doc false
def run(%Config{help: true}), do: print_help()
def run(%Config{args: []}), do: print_help()
def run(config) do
config
|> load_and_validate_source_files()
|> Runner.prepare_config
|> run_checks()
|> print_results_and_summary()
|> determine_success()
end
defp load_and_validate_source_files(config) do
{time_load, {valid_source_files, invalid_source_files}} =
:timer.tc fn ->
config
|> Sources.find
|> Enum.partition(&(&1.valid?))
end
Output.complain_about_invalid_source_files(invalid_source_files)
config
|> Config.put_source_files(valid_source_files)
|> Config.put_assign("credo.time.source_files", time_load)
end
defp run_checks(%Config{source_files: source_files} = config) do
{time_run, {source_files, config}} =
:timer.tc fn ->
Runner.run(source_files, config)
end
config
|> Config.put_source_files(source_files)
|> Config.put_assign("credo.time.run_checks", time_run)
end
defp print_results_and_summary(%Config{args: [file | _]} = config) do
file
|> String.split(":")
|> print_result(config.source_files, config)
config
end
defp determine_success(_) do
:ok
end
defp output_mod(_) do
Explain
end
defp print_result([filename], source_files, config) do
print_result([filename, nil, nil], source_files, config)
end
defp print_result([filename, line_no], source_files, config) do
print_result([filename, line_no, nil], source_files, config)
end
defp print_result([filename, line_no, column], source_files, config) do
source_files
|> Enum.find(&(&1.filename == filename))
|> print_result(config, line_no, column)
end
def print_result(source_file, config, line_no, column) do
output = output_mod(config)
output.print_before_info([source_file], config)
output.print_after_info(source_file, config, line_no, column)
end
defp print_help do
usage = ["Usage: ", :olive, "mix credo explain path_line_no_column [options]"]
description =
"""
Explain the given issue.
"""
example = ["Example: ", :olive, :faint, "$ mix credo explain lib/foo/bar.ex:13:6"]
options =
"""
General options:
-v, --version Show version
-h, --help Show this help
"""
UI.puts(usage)
UI.puts(description)
UI.puts(example)
UI.puts(options)
:ok
end
end