countrycode

Overview

About

Maintained by Vincent Arel-BundockFirst published 2009-06-0332 releasesCRAN page ↗GitHub ↗

Standardize country names, convert them into one of 40 different coding schemes, convert between coding schemes, and assign region descriptors.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("countrycode", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("vincentarelbundock/countrycode")

Development version from vincentarelbundock/countrycode. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-countrycode

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-countrycode

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-countrycode

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

13OK

Slowest check: 2.9 min · r-oldrel-windows-x86_64

Code health

Yes

Tests · ratio 2.07

83.6%

Coverage · measured lines

100%

Documentation · exports

0

Dependencies · direct

Check history

OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMENoVignettesNopkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 50%
Documented parameters: 100%
Return-value docs: 25%
References docs: 0%

Downloads

1.3M

CRAN downloads in the past year

Rank #642 · ~3.6K/day · ~108.8K/mo

Releases R versions

Daily download trend is not available in this view yet.

24.3K30 days

100.1K90 days

1.3M1 year

Compare downloads with other packages →

Also on7.2K r2u35 autocran4.3K conda_forge276 c2d4u

Repository

GitHub ↗ vincentarelbundock/countrycode

370Stars

85Forks

2Open issues

0Open PRs

7Releases

557Commits

26Contributors

License GPL-3.0 · 557 commits · Last activity 2026-07-02 · 0% stars, 30d

Stars over time

2025-07-09 · 3512026-07-13 · 370

Repository practices

Upstream repositoryBeta

6 development-tooling and community-health practices detected across 5 families in the upstream repository

Checks run against github.com/vincentarelbundock/countrycode on 2026-07-19.

Continuous integration (2)

GitHub ActionsAppVeyor

Reproducibility and dev environment (1)

Makefile

CRAN release process (1)

cran-comments.md

Docs source (1)

README.Rmd

Show all practices

Lint, format, editor (1)

RStudio project

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

6 external dependencies (excludes base and recommended)

Depends (1)

R >= 2.10

Imports (0)

none

LinkingTo (0)

none

Suggests (6)

altdoc eurostat testthat tibble ISOcodes utf8

Enhances (0)

none

Dependency license breakdown →

Code & Tests

Code Composition

R 2,056 (85%)Rd 375 (15%)

Code characteristics

Cyclomatic complexity: 5.0 median / 24 max
Test cases: 78 / 2.07 per code line

Test coverage

Line coverage

84%

Expression

79.7%

Tests / Examples

83.6% / 69% ex

Functions

5 4 exported

Complexity

11.2 avg / 24 max

Call network

5 nodes / 2 edges

Call graph

Open call graph →

Loading call graph…

Lowest coverage

5 functions

Function	Cyclo	Coverage
get_dictionary exp	5	0%
guess_field exp	2	0%
countrycode exp	24	93%
countrycode_convert	23	96%
countryname exp	2	100%

Datasets

Bundled datasets · 4

Name	Class	Rows × Cols	Also ships in
cldr_examples	data.frame	554 × 2	–
codelist	tbl_df/tbl/data.frame	292 × 627	–
codelist_panel	tbl_df/tbl/data.frame	29,574 × 59	–
countryname_dict	data.frame	24,725 × 2	–

People & History

People (5)

Maintainer (1)

Vincent Arel-Bundock

Author, Maintainer

Authors (1)

Vincent Arel-Bundock

Author, Maintainer

Contributors (4)

Etienne Bacher

Contributor · added in 1.6.0

Nils Enevoldsen

Contributor · added in 1.1.0

Samuel Meichtry

Contributor · added in 1.4.0

CJ Yetman

Contributor · added in 1.00.0

Package Timeline

32 releases. Pick two to compare their code metrics. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
1.8.0Latest
2026-04-16 · current release · diff ↗
1.7.0
2026-02-27 · diff ↗
R
R 4.5.0 released · 2025-04-11
1.6.1
2025-03-31 · diff ↗
R
R 4.4.0 released · 2024-04-24
1.6.0
2024-03-22 · diff ↗
1.5.0
2023-05-30 · diff ↗
R
R 4.3.0 released · 2023-04-21
1.4.0
2022-05-04 · diff ↗
R
R 4.2.0 released · 2022-04-22
1.3.1
2022-02-02 · diff ↗
1.3.0
2021-07-15 · diff ↗
R
R 4.1.0 released · 2021-05-18
1.2.0
2020-05-22 · diff ↗
1.1.3
2020-05-07 · diff ↗

Show 37 earlier events

R
R 4.0.0 released · 2020-04-24
1.1.2
2020-04-22 · diff ↗
1.1.1
2020-02-08 · diff ↗
R
R 3.6.0 released · 2019-04-26
1.1.0
2018-10-27 · diff ↗
R
R 3.5.0 released · 2018-04-23
1.00.0
2018-02-11 · diff ↗
R
R 3.4.0 released · 2017-04-21
0.19
2017-02-06 · diff ↗
R
R 3.3.0 released · 2016-05-03
R
R 3.2.0 released · 2015-04-16
0.18
2014-12-29 · diff ↗
0.17
2014-07-15 · diff ↗
R
R 3.1.0 released · 2014-04-10
0.16
2013-08-20 · diff ↗
0.14
2013-05-30 · diff ↗
R
R 3.0.0 released · 2013-04-03
0.13
2013-03-22 · diff ↗
0.12
2013-03-08 · diff ↗
0.11
2013-02-12 · diff ↗
0.10
2013-01-20 · diff ↗
0.9
2012-12-27 · diff ↗
0.8
2012-06-26 · diff ↗
0.7
2012-06-04 · diff ↗
0.6
2012-04-01 · diff ↗
R
R 2.15.0 released · 2012-03-30
R
R 2.14.0 released · 2011-10-31
R
R 2.13.0 released · 2011-04-13
R
R 2.12.0 released · 2010-10-15
0.5
2010-08-14 · diff ↗
R
R 2.11.0 released · 2010-04-22
0.4
2010-03-02 · diff ↗
0.3
2009-12-13 · diff ↗
R
R 2.10.0 released · 2009-10-26
0.2
2009-06-14 · diff ↗
0.1
2009-06-03
R
R 2.9.0 released · 2009-04-17

Package metadata

First published: 2009-06-03
Total releases: 32 / 17 yrs
License: GPL-3 OSI
Minimum R: ≥ 2.10
Bundled data: 486 KB / 4 files
Download size: 520 KB
Installed size: not tracked yet
With dependencies: not tracked yet