Whatlangex

Whatlang NIF bindings for Elixir.

Requirements

• Elixir 1.15 or more
• Erlang OTP 24 or more

Note: This project is developed and tested with Elixir 1.18.4 and Erlang OTP 28. Please open an issue if backward compatibilities with the minimum versions listed above are not respected.

Installation

The package can be installed by adding whatlangex to your list of dependencies in mix.exs:

def deps do
  [
    {:whatlangex, "~> 0.4.0"}
  ]
end

How to use

Basic language detection

To detect the language of a sentence:

iex> Whatlangex.detect("¿Cómo te llamas?")
%Whatlangex.Detection{
  lang: "spa",
  script: "Latin",
  confidence: 0.6848222396112233
}

Language detection with filtering

You can limit which languages to check using an allowlist or denylist:

# Only check for specific languages
iex> Whatlangex.detect("Hello world", allowlist: ["eng", "fra", "spa"])
%Whatlangex.Detection{lang: "eng", script: "Latin", confidence: ...}

# Exclude specific languages from detection
iex> Whatlangex.detect("Bonjour le monde", denylist: ["eng", "deu"])
%Whatlangex.Detection{lang: "fra", script: "Latin", confidence: ...}

Note: allowlist and denylist are mutually exclusive. If both are provided, allowlist takes precedence and denylist is ignored.

Language code conversion

To get the full language name from language code:

iex> Whatlangex.code_to_eng_name("spa")
"Spanish"

iex> Whatlangex.code_to_name("spa")
"Español"