restcountry

KO | EN

gitlite — search

#javascript #python #typescript #golang #android #rust #linux #macos #cli #awesome-list #pytorch #mcp #openai #ios

(★ 36)

This is a Ruby wrapper library around the API provided by REST Countries http://restcountries.eu

restcountry Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Restcountry

This is a [RubyGem](https://rubygems.org/gems/restcountry) wrapper library around the API provided by
[Restcountries](https://restcountries.eu).

## Installation

Add this line to your application's Gemfile:

```ruby
gem 'restcountry'
```

And then execute:

$ bundle

Or install it yourself as:

$ gem install restcountry

## Usage

```ruby
require 'restcountry'

# Find all countries
countries = Restcountry::Country.all

# Find a country by name
country = Restcountry::Country.find_by_name('italy')

# Access the country's attributes
country.capital
#=> Rome

country.region
#=> Europe

country.callingCodes
#=> "39"

# Find a country by capital
country = Restcountry::Country.find_by_capital('Rome')

country.name
#=> Italy

countries = Restcountry::Country.find_by_lang('it')

countries.first
#=> Holy See

```
## Attributes

name, 
capital, 
altSpellings, 
relevance, 
region, 
subregion, 
translations, 
population, 
latlng, 
demonym, 
area, 
gini, 
timezones, 
borders, 
nativeName, 
callingCodes, 
topLevelDomain, 
alpha2Code, 
alpha3Code, 
currencies, 
languages

## Credits
Many thanks to Fayder Florez for his implementation of the API.

## Contributors
<a href="https://github.com/davidesantangelo/restcountry/contributors">All Contributors</a>

## Related projects

[gocountries](https://github.com/alediaferia/gocountries).

## License
The restcountry GEM is released under the MIT License.

restcountry

restcountry Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

restcountry

restcountry Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README