defmodule CharsetDetect do
  @moduledoc """
  CharsetDetect is a simple wrapper around the chardetng crate.

  See the README for the detection policy and its security trade-offs.
  """

  version = Mix.Project.config()[:version]

  use RustlerPrecompiled,
    otp_app: :charset_detect,
    crate: "charset_detect",
    base_url: "https://github.com/ryochin/charset_detect/releases/download/v#{version}",
    force_build: System.get_env("RUSTLER_PRECOMPILATION_EXAMPLE_BUILD") in ["1", "true"],
    nif_versions: ["2.15", "2.16", "2.17"],
    version: version

  @doc """
  Guess the encoding of a string.

  ## Examples

      iex> File.read!("test/assets/sjis.txt") |> CharsetDetect.guess
      {:ok, "Shift_JIS"}
  """
  @spec guess(binary) :: {:ok, String.t()} | {:error, String.t()}
  def guess(body) when not is_binary(body), do: {:error, "invalid argument"}
  def guess(body), do: _guess(body)

  @doc """
  Guess the encoding of a string (exceptional).

  ## Examples

      iex> File.read!("test/assets/big5.txt") |> CharsetDetect.guess!
      "Big5"
  """
  @spec guess!(binary) :: String.t()
  def guess!(body) do
    {:ok, result} = _guess(body)

    result
  end

  # NIF function definition
  @spec _guess(binary) :: {:ok, String.t()} | {:error, String.t()}
  defp _guess(_body), do: :erlang.nif_error(:nif_not_loaded)
end