EarthCountriesInfo 1.0.3

EarthCountriesInfo

EarthCountriesInfo is an open-source C# class library that provides comprehensive information about countries on planet Earth. Whether you're building educational tools, geographic applications, or simply curious about global diversity, EarthCountriesInfo has you covered!

Features

• Country Names: Retrieve country names in multiple languages.
• Country Phone Codes: Access phone codes for each country.
• Valid Lengths and Formats: Obtain valid phone number lengths and formats (if available).

Installation

To include EarthCountriesInfo in your project, install the NuGet package:

dotnet add package EarthCountriesInfo

Usage

Country Properties

The CountryProperties class provides essential information for each country:

public sealed record CountryProperties(
    Dictionary<LanguageId, string> CountryNames,
    string CountryPhoneCode,
    Dictionary<int, string>? ValidLengthsAndFormat
);

• CountryNames: A dictionary containing country names in various languages.
• CountryPhoneCode: The international phone code for the country.
• ValidLengthsAndFormat (optional): Valid phone number lengths and formats (if available).

Example Usage

using EarthCountriesInfo;

// Get information for a specific country (e.g., United States)
var usaProperties = CountryInfo.GetCountryProperties("USA");

Console.WriteLine($"Country Name (English): {usaProperties.CountryNames[LanguageId.English]}");
Console.WriteLine($"Country Phone Code: +{usaProperties.CountryPhoneCode}");

if (usaProperties.ValidLengthsAndFormat != null)
{
    foreach (var (length, format) in usaProperties.ValidLengthsAndFormat)
    {
        Console.WriteLine($"Valid Length: {length}, Format: {format}");
    }
}

Contributing

We welcome contributions! If you find a bug, have an idea for improvement, or want to add support for additional countries, please submit an issue or a pull request on GitHub.

GitHub Repository

Visit our GitHub repository for the latest updates, documentation, and community contributions: EarthCountriesInfo GitHub Repository

License

This project is licensed under the GNU GENERAL PUBLIC LICENSE.

Happy coding! 🌎🚀📚