@spec detect_language(file_path()) :: {:ok, language()} | {:error, String.t()}

Detect language from file extension.

Examples

iex> Metastatic.CLI.detect_language("foo.py")
{:ok, :python}

iex> Metastatic.CLI.detect_language("foo.ex")
{:ok, :elixir}

iex> Metastatic.CLI.detect_language("foo.erl")
{:ok, :erlang}

iex> Metastatic.CLI.detect_language("foo.txt")
{:error, "Cannot detect language from extension: .txt"}

@spec fatal(String.t()) :: no_return()

Print error and exit with status code 1.

@spec format_error(String.t()) :: String.t()

Format error message for CLI output.

Prefixes with red "Error: " for terminal output.

@spec format_info(String.t()) :: String.t()

Format info message for CLI output.

Prefixes with blue info icon for terminal output.

@spec format_success(String.t()) :: String.t()

Format success message for CLI output.

Prefixes with green checkmark for terminal output.

@spec get_adapter(language()) :: {:ok, module()} | {:error, String.t()}

Get adapter for a given language.

Examples

iex> Metastatic.CLI.get_adapter(:python)
{:ok, Metastatic.Adapters.Python}

iex> Metastatic.CLI.get_adapter(:unknown)
{:error, "Unsupported language: unknown"}

@spec read_file(file_path()) :: {:ok, String.t()} | {:error, String.t()}

Read file contents.

Examples

iex> Metastatic.CLI.read_file("test.py")
{:ok, "print('hello')"}

iex> Metastatic.CLI.read_file("nonexistent.py")
{:error, "Cannot read file test.py: enoent"}

@spec write_file(file_path(), String.t()) :: :ok | {:error, String.t()}

Write file contents, creating directories if needed.

Examples

iex> Metastatic.CLI.write_file("output/test.py", "print('hello')")
:ok