RESTCountriesSharp 1.0.0

RESTCountries Sharp

A .NET client wrapper for https://restcountries.com written in .NET Standard 2.0

Installation

Install the package via NuGet.

Usage

You can either create a new instance of RESTCountriesService or if you are using Dependency Injection there is also an interface called IRESTCountriesService which you can register in your container.

The service provides the following methods:

/// <summary>
///     Get all countries.
/// </summary>
Task<IEnumerable<Country>> GetAllCountriesAsync();

/// <summary>
///     Search by country name.
/// </summary>
Task<IEnumerable<Country>> GetCountriesByNameAsync(string name);

/// <summary>
///     Search by country's full name. 
///     It can be the common or official value
/// </summary>
Task<Country> GetCountryByFullNameAsync(string fullName);

/// <summary>
///     Search by cca2, ccn3, cca3 or cioc country code.
/// </summary>
Task<Country> GetCountryByCodeAsync(string code);

/// <summary>
///     Search by cca2, ccn3, cca3 or cioc country code.
/// </summary>
Task<IEnumerable<Country>> GetCountriesByCodesAsync(IEnumerable<string> codes);

/// <summary>
///     Search by currency code or name.
/// </summary>
Task<IEnumerable<Country>> GetCountriesByCurrencyAsync(string currency);

/// <summary>
///     Search by language code or name.
/// </summary>
Task<IEnumerable<Country>> GetCountriesByLanguageAsync(string language);

/// <summary>
///     Search by capital city
/// </summary>
Task<IEnumerable<Country>> GetCountriesByCapitalAsync(string capital);

/// <summary>
///     Search by region.
/// </summary>
Task<IEnumerable<Country>> GetCountriesByRegionAsync(string region);

/// <summary>
///     Search by subregions.
/// </summary>
Task<IEnumerable<Country>> GetCountriesBySubregionAsync(string subregion);

Sample

Here is a screenshot of the Console Application using the NuGet package to get the european countries and display them in a table on the console.