@spec issue_to_ragex_issue(MetaCredo.Issue.t(), String.t()) :: map()

Converts a MetaCredo.Issue to Ragex's business logic issue format.

@spec issue_to_smell(MetaCredo.Issue.t()) :: map()

Converts a MetaCredo.Issue to Ragex's smell format.

@spec issue_to_vulnerability(MetaCredo.Issue.t(), String.t(), atom()) :: map()

Converts a MetaCredo.Issue to Ragex's security vulnerability format.

@spec parse_file(String.t()) :: {:ok, MetaCredo.SourceFile.t()} | {:error, term()}

Parses a file into a MetaCredo.SourceFile.

Returns {:ok, source_file} or {:error, reason}.

@spec parse_source_file(String.t(), String.t(), atom()) ::
  {:ok, MetaCredo.SourceFile.t()} | {:error, term()}

Builds a MetaCredo.SourceFile from already-read content.

@spec run_checks(MetaCredo.SourceFile.t(), [{module(), keyword()}]) :: [
  MetaCredo.Issue.t()
]

Runs a list of MetaCredo check modules on a source file.

checks is a list of {module, params} tuples, matching MetaCredo's convention. Returns a flat list of MetaCredo.Issue structs.