country-to-iso/README.md

Convert inconsistent country names and codes into ISO 3166-1 alpha-2.

# 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.

[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/nojacko)

## Usage

```bash
npm i country-to-iso
```

```node
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](https://www.npmjs.com/package/countryjs) and [country-list](https://www.npmjs.com/package/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. |

## Contributing

### Adding a New Country or Variant

Always run the following. It'll update everything from `countryjs` and `country-list` packages. It might include what you're looking for.

```zsh
npm update --save-dev countryjs country-list
npm run seed
npm run generate
npm test
```

#### Add a New Country

* Add the ISO 3166-1 alpha-2 code to `data/iso-alpha-2.json`
* Add the ISO 3166-1 alpha-3 code to `data/iso-alpha-3.json`
* Create a file for your new country `data/country/<COUNTRY_CODE>.json` following the format of the other countries.
* Add some tests
* Run the following:

```zsh
npm run generate
npm run test
```

#### Add a New Variant

* Manually it to the `names` array in the correct `data/country/*.json` file
* Add some tests
* Run the following:

```zsh
npm run generate
npm test
```

## Support

<a href="https://www.buymeacoffee.com/nojacko" target="_blank">
  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png"
    alt="Buy Me A Coffee"
    style="height: 60px !important;width: 217px !important;"
  />
</a>

## Other Projects

**✈️ [Travel Focused](https://travelfocused.com)** An app to access weather forecasts, convert currencies, save favorite locations, and enjoy essential travel information offline. Download on the [App Store](https://apps.apple.com/us/app/travel-focused/id6756546003) and [Google Play](https://play.google.com/store/apps/details?id=com.travelfocused.app).

**🏎️ [Race Calendar](https://racecalendar.io)** All upcoming races, sprints, qualifying and practice sessions for [Formula 1 Calendar](https://racecalendar.io/f1), [Formula 2 Calendar](https://racecalendar.io/f2), [Formula 3 Calendar](https://racecalendar.io/f3), [Formula E Calendar](https://racecalendar.io/formula-e) and [F1 Academy Calendar](https://racecalendar.io/f1-academy).

**⚡️ [Agile Octopus Price Tracker](https://agile-octopus.datafury.io)** Quickly see the live, upcoming and average electricity prices for Octopus Energy's Agile Octopus tariff.

**🔥 [datafury.io](https://datafury.io)** The landing page for my projects.

**🌐 [node-country-to-iso](https://github.com/nojacko/node-country-to-iso)** Convert country names to ISO codes.

**🌐 [Geo Data](https://geo.datafury.io)** Searchable GeoNames data.