# countries/countries

All sorts of useful information about every country packaged as convenient little country objects. It includes data from ISO 3166 (countries and states/subdivisions ), ISO 4217 (currency), and E.164 (phone numbers).

Repository: https://github.com/countries/countries
Canonical: https://ross.abutalabs.com/products/countries-countries
Language: Ruby
License: MIT
License Family: permissive
Topics: ruby, iso3166, countries
Last push: 2026-06-27T14:51:45+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 89, release rhythm 52, longevity 100
- inputs: {"age_days": 6102, "days_push": 67, "days_rel": 243, "gap_med": 44.5, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2359, forks 682 (observed 2026-08-28T04:06:40.784205+00:00)

## What it is
A Ruby gem providing country objects with data from ISO 3166 (countries and subdivisions), ISO 4217 (currencies), and E.164 (phone numbers). It offers attribute-based finder methods to look up countries by name, code, region, and other attributes.

## Use cases
- get country names and codes for a dropdown in a rails app
- look up a country's currency by ISO code
- find countries by region or translated name
- validate and map phone number country codes
- get states and subdivisions for a country
- populate country data in a form

## When to avoid
- you need country data in a non-Ruby language (use the YAML/JSON data repos instead)
- you need geolocation or IP-to-country resolution
- you need frequently changing geopolitical data beyond ISO standards

## Facets
- artifact type: library
- maturity: active
- function: sdk, data-science, internationalization
- domain: developer-tools, apis
- platform: ruby, cross-platform
- tags: iso3166, iso4217, e164, country-data, currency, phone-numbers, subdivisions, gem, localization

## Member repositories
- countries/countries (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:40.784205+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:36:13.329815+00:00, confidence not recorded.
  - readme: https://github.com/countries/countries (fetched 2026-08-28T04:06:40.784205+00:00, sha 84762a4c1a01)
- Data as of 2026-08-30T08:39:29.467469+00:00.