🌍 country_meta #

A Dart-only package providing metadata for countries with ISO codes, localized names, currencies, phone codes, and flag image utilities (SVG, WebP, JPEG).

📦 Features #

• ✅ ISO Alpha-2, Alpha-3, and Numeric codes
• 📞 Phone codes
• 💱 Currencies and symbols
• 🌐 Localized country names: English, Russian, Arabic
• 🔎 Country lookup by code or locale
• 🏁 Flag URL builder with SVG / WebP / JPEG support
• 🧪 Unit tests for model serialization, equality, and indexing

🇺🇳 Flag icons provided by flagpedia.net

📁 Project Structure #

lib/
├── country_meta.dart
└── src/
    ├── model/
    │   └── country_meta.dart
    ├── data/
    │   └── country_repository.dart
    ├── res/
    │   ├── data/
    │   │   └── countries_raw_data.dart
    │   └── names/
    │       ├── country_names_en.dart
    │       ├── country_names_ru.dart
    │       ├── country_names_ar.dart
    ├── localization/
    │   ├── localized_name.dart
    │   └── country_name.dart
    └── flags/
        ├── flag_format.dart
        ├── flag_width.dart
        ├── flag_height.dart
        ├── flag_url_builder.dart
        └── country_flag.dart

🚀 Usage #

🔍 Country Lookup #

final country = CountryRepository.byAlpha2('US');
print(country?.currency); // USD
print(country?.phoneCode); // 1

🌐 Localized Name #

final name = country?.localizedName('ru_RU');
print(name); // Соединенные Штаты

🏁 Flag URL #

// Default SVG
final svg = country?.flagUrl();

// JPEG with height
final jpeg = country?.flagUrl(
  format: FlagImageFormat.jpeg,
  height: FlagHeight.h160,
);

// WebP with width
final webp = country?.flagUrl(
  format: FlagImageFormat.webp,
  width: FlagWidth.w320,
);

🧪 Testing #

Run all tests:

dart test

Includes tests for:

• ✅ CountryMeta model parsing, serialization, equality
• 📦 Country repository lookup
• 🌐 Localized name fallback logic
• 🏁 Flag URL generation and format fallback

📄 License #

MIT