base on An offline crossplatform .NET library for getting Global Country , iso3166 Short-code and Region Data <!-- logo --> <img src="./Assets/CountryData.Net.Logo.Small.png" alt="Logo" width="250" height="200"/> A cross-platform library designed to provide seamless access to global country data for .NET applications without making any http calls. Our aim is to simplify the process of integrating standardised global data into your applications, making it an ideal tool for developers who require international data. ### Project Status | | | |-|-| | nuget downloads | [](https://www.nuget.org/packages/CountryData.Standard) | | builds |  | |code coverage|[](https://codecov.io/github/frankodoom/CountryData.Net) |code quality |[](https://sonarcloud.io/summary/new_code?id=frankodoom_CountryData.Net) ### Features - 🌍 Get global country data [CountryName, CountryPhone, Region, CountryFlag, PhoneCode ] - 🏳️‍🌈 Get country data by ISO 3166 country code - 🚩 Get country flag by ISO 3166 country code - 🗺️ Get country region by ISO 3166 country code - ☎️ Get country phone code by ISO 3166 country code ### Install Library ##### Package Manager ```cSharp PM> Install-Package CountryData.Standard -Version 1.5.0 ``` ##### .NET CLI ```cSharp > dotnet add package CountryData.Standard --version 1.5.0 ``` ### Usage CountryData.Standard is a robust, production-grade package designed for a wide range of .NET applications. Whether you're developing a .NET Core Web API, a console application, a .NET MAUI or Xamarin app, a Blazor project, or a mobile app, this library is built to seamlessly integrate with your project. To get started quickly, check out our [Sample Code](./sample/README.md). This section provides practical examples of how to use the library in various types of projects. For more detailed instructions and comprehensive information about the library, please refer to our [Documentation](./docs/README.md). This resource offers in-depth guidance on how to effectively use the CountryData.Standard library in your projects. ### Methods and Descriptions The CountryData.Standard library provides a set of methods that allow you to retrieve country data, flags, regions, and phone codes. The following table lists the available methods and their descriptions. | Method | Description | |--------|-------------| | [`GetCountryData()`](./docs/README.md) | Returns all country data including region, short code, and country name. | | [`GetCountryByCode(string shortCode)`](./docs/README.md) | Returns a single country's data by its short code. | | [`GetCountryEmojiFlag(string shortCode)`](./docs/README.md) | Gets the flag of the country, represented as an emoji, by the country's short code. | | [`GetRegionByCountryCode(string shortCode)`](./docs/README.md) | Selects and returns a list of regions for a particular country identified by its short code. | | [`GetCountries()`](./docs/README.md) | Gets the list of all country names. | | [`GetPhoneCodeByCountryShortCode(string shortCode)`](./docs/README.md) | Returns a single country's phone code by its short code. | | [`GetCountryByPhoneCode(string phoneCode)`](./docs/README.md) | Returns country data for the country associated with the specified phone code. | | [`GetCurrencyCodesByCountryCode(string shortCode)`](./docs/README.md) | Returns a list of currency codes for a specific country identified by its short code. | | [`GetCountryByCurrencyCode(string currencyCode)`](./docs/README.md) | Returns a list of countries that use the specified currency code. | | [`GetCountryCode(string countryName)`](./docs/README.md) | Returns the country code for a specific country name. | ### Initialize the Country data object ```cSharp //loads all Country Data via the constructor (You can initialize this once as a singleton) var helper = new CountryHelper(); ``` ### Get list of Countries ```cSharp var countries = helper.GetCountries(); foreach (var country in countries) Console.WriteLine(country); ``` ### Get list of Regions in a Country by Country Code ```cSharp var regions = helper.GetRegionByCountryCode("GH"); foreach (var region in regions) Console.WriteLine(region.Name); ``` ### Using lambda for custom querries #### `GetCountryData()` returns an `IEnumerable<Country>` which can be querried with Lambda for a more flexible usage. ```cSharp //example1 var data = helper.GetCountryData(); //get list of countries by their Names var countries = data.Select(c => c.CountryName).ToList(); foreach (var country in countries) Console.WriteLine(country); //example 2 data.Where(x => x.CountryShortCode == "US") .Select(r=>r.Regions).FirstOrDefault() .ToList(); ``` ### Get Country Data by Country Code This example demonstrates how to retrieve a country with a specific phone code using the `GetCountryByPhoneCode` method. In this case, we're fetching the country with the phone code "+233". ```csharp var CountryName = helper.GetCountryByPhoneCode("+233"); Console.WriteLine(CountryName); ``` ### ISO-3166-1 country codes For a list of supported ISO-3166-1 country codes, PhoneCode, Flags, ISO and , Unicode please refer to the [Country Details](./CountryData/CountryDetails.md) file. ### Contributing Contributions are welcome! We value your input and want to make contributing to this project as easy and transparent as possible. Please see our [Contributing Guide](CONTRIBUTING.md) for more details. ### Code of Conduct We are committed to fostering a welcoming and respectful community for everyone. Our `Code of Conduct` outlines the standards of behavior expected from contributors and maintainers. This document helps ensure that the community around our project is inclusive and collaborative. Please refer to our [code of conduct](CODE_OF_CONDUCT.md) for more information. ### Comming Soon * Support for ISO 3166 Country A3 Codes * Country ShortCode Enums ### License This project is licensed under the terms of the [LICENSE](LICENSE). ", Assign "at most 3 tags" to the expected json: {"id":"12102","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"