Current section

Files

Jump to
credo lib credo check params.ex
Raw

lib/credo/check/params.ex

defmodule Credo.Check.Params do
@moduledoc """
This module provides functions for handling parameters ("params") given to
checks through `.credo.exs` (i.e. the `Credo.ConfigFile`).
"""
@doc """
Returns the given `field`'s `params` value.
Example:
defmodule SamepleCheck do
def param_defaults do
[foo: "bar"]
end
end
iex> Credo.Check.Params.get([], :foo, SamepleCheck)
"bar"
iex> Credo.Check.Params.get([foo: "baz"], :foo, SamepleCheck)
"baz"
"""
def get(params, field, check_mod)
# this one is deprecated
def get(params, field, keywords) when is_list(keywords) do
case params[field] do
nil ->
keywords[field]
val ->
val
end
end
def get(params, field, check_mod) do
case params[field] do
nil ->
check_mod.param_defaults()[field]
val ->
val
end
end
@doc false
def get(params, check_mod) when is_atom(check_mod) do
Enum.reduce(
param_names(params, check_mod),
%{},
fn param_name, map ->
Map.put(map, param_name, get(params, param_name, check_mod))
end
)
end
@doc false
def param_names(params, check_mod) do
all_known_params =
List.wrap(check_mod.explanations()[:params]) ++
List.wrap(check_mod.param_defaults()) ++
List.wrap(params)
all_known_params
|> Keyword.keys()
|> Enum.uniq()
end
@doc false
def get_rerun_files_that_changed(params) do
List.wrap(params[:__rerun_files_that_changed__])
end
@doc false
def put_rerun_files_that_changed(params, files_that_changed) do
Keyword.put(params, :__rerun_files_that_changed__, files_that_changed)
end
@doc false
def builtin_param_names do
[
:category,
:__category__,
:exit_status,
:__exit_status__,
:files,
:__files__,
:priority,
:__priority__,
:tags,
:__tags__
]
end
@doc false
def category(params, check_mod) do
params[:__category__] || params[:category] || check_mod.category()
end
@doc false
def exit_status(params, check_mod) do
params[:__exit_status__] || params[:exit_status] || check_mod.exit_status()
end
@doc false
def files_excluded(params, check_mod) do
files = get(params, :__files__, check_mod) || get(params, :files, check_mod)
List.wrap(files[:excluded])
end
@doc false
def files_included(params, check_mod, known_files) do
files = get(params, :__files__, check_mod) || get(params, :files, check_mod)
case files[:included] do
nil -> known_files
included -> included
end
end
@doc false
def priority(params, check_mod) do
params[:__priority__] || params[:priority] || check_mod.base_priority()
end
@doc false
def tags(params, check_mod) do
params[:__tags__] || params[:tags] || check_mod.tags()
end
end