EarthCountriesInfo 3.0.0

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;
using HumanLanguages;

// Get information for a specific country (e.g., INDIA)
if (Countries.CountryPropertiesDictionary.TryGetValue(CountryIsoCode.IN, out CountryProperties infoAboutIndia))
{
	Console.WriteLine($"Country Name (English): {infoAboutIndia.CountryNames[LanguageId.en]}");
	Console.WriteLine($"Country Phone Code: +{infoAboutIndia.CountryPhoneCode}");

	if (infoAboutIndia.ValidLengthsAndFormat != null)
	{
		foreach (var (length, format) in infoAboutIndia.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! 🌎🚀📚