Country to ISO 3166-1 alpha-2/alpha-3
Convert inconsistent country names and codes into ISO 3166-1 alpha-2 or ISO 3166-1 alpha-3.
The aim is support English only but some native languages are included.
Usage
import { countryToAlpha2, countryToAlpha3 } from "country-to-iso";
// const { countryToAlpha2, countryToAlpha3 } = require("country-to-iso");
// countryToAlpha2
countryToAlpha2("US"); // returns "US"
countryToAlpha2("USA"); // returns "US"
countryToAlpha2("U S A"); // returns "US"
countryToAlpha2("U.S.A"); // returns "US"
countryToAlpha2("US of A"); // returns "US"
countryToAlpha2("US and A"); // returns "US"
countryToAlpha2("United States"); // returns "US"
countryToAlpha2("United States of America"); // returns "US"
countryToAlpha2("America"); // returns "US"
// countryToAlpha3
countryToAlpha3("US"); // returns "USA"
// etc...Commands
| Script | Description |
|---|---|
npm run build |
Builds project to lib/. |
npm run seed |
Takes data from the libraries countryjs and country-list and updates data/iso-alpha-*.json and data/country/*.json files. |
npm run generate |
Takes seeded data, makes variants of names, checks for clashes (there's no mechanism to handle clashes as it's not come up) and dumps the data to data/names.json. |
npm test |
Runs tests. |
Adding New Country Name Variants
Update Seed Libraries
npm update --save-dev countryjs country-list
npm run seed
npm run generate
npm test
Manually Add Variants
Manually it manually to the correct data/country/*.json file and run:
npm run generate
npm test