Countries.Standard 3.0.0

Countries

A zero-dependency .NET library with strongly-typed, compile-time access to every country in the world.

No JSON files to embed, no HTTP calls, no configuration. Every nation ships as a static property directly on the Country struct — intellisense-complete, AOT-friendly, and always available offline.

✨ Features

• 247 countries and territories — full UN/ISO dataset baked into the assembly
• Strongly-typed codes — CountryCode (ISO 3166-1 alpha-2) and CountryCodeISO3 (alpha-3) enums, no magic strings
• Rich metadata per country — common name, official name, capital, TLD, currencies, calling codes, borders, area, landlocked flag, region and sub-region
• Continent collections — Country.Europe, Country.Africa, Country.Asia, Country.Americas, Country.Oceania
• Fast O(1) lookup by ISO2 or ISO3 code via dictionary
• Fuzzy search — find a country from a misspelled or partial name using Levenshtein distance
• Value semantics — Country is a struct; equality, GetHashCode and ToString work out of the box, usable as dictionary key
• netstandard2.0 target — compatible with .NET Framework 4.6.1+, .NET Core, .NET 5+, Unity, Xamarin

📦 Installation

dotnet add package Countries

🚀 Quick start

using Countries;

// Direct property access — zero allocation, compile-time safe
Country italy = Country.Italy;
Console.WriteLine(italy.Capital);      // Rome
Console.WriteLine(italy.CountryCode);  // IT
Console.WriteLine(italy.ISO3);         // ITA
Console.WriteLine(italy.Region);       // Europe
Console.WriteLine(italy.Area);         // 301336

// Lookup by ISO2 code
Country de = Country.FromCode(CountryCode.DE);

// Lookup by ISO3 code
Country deu = Country.FromCode(CountryCodeISO3.DEU);

// Parse a string (ISO2 or ISO3, case-insensitive)
Country us = Country.Parse("US");
Country usa = Country.Parse("usa");

// Fuzzy search — tolerates typos
Country fr = Country.Fuzzy("Frace");   // → France
Country jp = Country.Fuzzy("Jaapn");   // → Japan

🌍 Continent collections

// All countries in a continent
foreach (var c in Country.Europe)
    Console.WriteLine($"{c.CommonName} ({c.Capital})");

// LINQ works naturally
var landlocked = Country.Africa.Where(c => c.Landlocked);
var largest    = Country.Americas.MaxBy(c => c.Area);
var euros      = Country.Europe.Where(c => c.Currencies.Contains("EUR"));

Available collections:

🔎 Country properties

🧭 Fuzzy search

Country.Fuzzy(string) normalises the input (strips accents, diacritics, punctuation) and finds the closest match using Levenshtein distance. Results with distance > 3 return Country.Unknown.

Country.Fuzzy("Germny")    // → Germany
Country.Fuzzy("BRASIL")    // → Brazil
Country.Fuzzy("Österreich")// → Austria
Country.Fuzzy("zzzzzzzzz") // → Unknown

⚖️ Value semantics

Country a = Country.FromCode(CountryCode.JP);
Country b = Country.Parse("JPN");

bool same = a == b;           // true — equality by CountryCode
int hash  = a.GetHashCode();  // stable, based on CountryCode
string s  = a.ToString();     // "Japan"

// Usable as dictionary key
var capitals = new Dictionary<Country, string>
{
    [Country.Italy]  = "Rome",
    [Country.France] = "Paris",
};

🧪 Tests

The solution includes a full NUnit test suite (Countries.Tests) with 70 tests covering collections, continent filters, lookup, parse, fuzzy search and equality.

dotnet test

📄 License

MIT — see LICENSE.txt.