CountryLookup
View SourceA lightweight Elixir library for identifying countries by their telephone dialing codes. Given a phone number or area code, or country name, country_lookup returns the matching country name and its flag as an inline image/base64.
Usage
iex> CountryLookup.lookup_by_code("55")
%{
name: "Brazil",
flag_image: "iVBORw0KGgoAAAANSUhEUgAAA..."
}
iex> CountryLookup.search_by_name("Domini")
[
%{
name: "Dominica",
flag_image: "iVBORw0KGgoAAAAN...",
dial_codes: ["1767"]
},
%{
name: "Dominican Republic",
flag_image: "iVBORw0KGgoAAAANSUhEU...",
dial_codes: ["1809", "1829", "1849"]
}
]
✨ Features
🔍 Fast lookup using prefix matching (longest match wins)
📞 Supports country calling codes, including national variants (e.g. 1809, 55), also search by country name.
🏳️ Flag images embedded as Base64-encoded PNGs.
🔌 Designed for easy integration with Phoenix LiveView or CLI apps
📁 (Optional) Keep update with latest data from Wikipedia (Python):
conda create -n country_lookup_env python=3.10
conda activate country_lookup_env
conda install requests beautifulsoup4 pillow cairosvg
cd python_skrap;
# scrape data from Wikipedia
python skrap.py
Installation
If available in Hex, the package can be installed
by adding country_lookup
to your list of dependencies in mix.exs
:
def deps do
[
{:country_lookup, "~> 0.0.2"}
]
end
And configure your application.ex
:
@impl true
def start(_type, _args) do
children = [
...
CountryLookup
]
Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/country_lookup.