{"_id":"@codeforcer/i18n-iso-countries-extended","_rev":"1-00b86192298d0983ebda1606398e4d1f","name":"@codeforcer/i18n-iso-countries-extended","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@codeforcer/i18n-iso-countries-extended","version":"1.0.0","description":"i18n for ISO 3166-1 country codes, extended with new languages","typings":"index.d.ts","keywords":["i18n","iso","3166","iso 3166","iso 3166-1","alpha","alpha-2","alpha-3","numeric","country","countries","ar","az","be","bg","bs","ca","cs","da","de","el","en","es","et","fa","fi","fr","he","hr","hu","hy","id","it","ja","ka","kk","ko","ky","lt","lv","mk","mn","nb","nl","nn","pl","pt","ro","ru","sk","sl","sr","sv","tg","tk","tr","uk","uz","zh"],"author":{"name":"Nathan Worsley","email":"nathancworsley@gmail.com"},"contributors":[{"name":"Michael Wittig","email":"post@michaelwittig.info"},{"name":"Bedis ElAcheche","email":"d4rk-5c0rp@ubuntu.com"},{"name":"Johann Behr","email":"behr@oak-labs.com"}],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/michaelwittig/node-i18n-iso-countries.git"},"dependencies":{},"devDependencies":{"assert-plus":"1.0.0","mocha":"5.2.0","jshint":"2.9.6","madge":"2.2.0","istanbul":"0.4.5"},"main":"entry-node","browser":"index","engines":{"node":">= 4"},"scripts":{"test":"make test"},"bugs":{"url":"https://github.com/michaelwittig/node-i18n-iso-countries/issues"},"gitHead":"a84d3d4b370ebe38dd0192341f9ca17b0d37c000","homepage":"https://github.com/michaelwittig/node-i18n-iso-countries#readme","_id":"@codeforcer/i18n-iso-countries-extended@1.0.0","_nodeVersion":"12.11.1","_npmVersion":"6.11.3","dist":{"integrity":"sha512-5Wh9GkI6Wh14OFE2Xz5uVUpB5yi9+2wnbMUmKwF+lLHmu4z55B8Az3R5IC+QppFodlOb8nN6TxzS5VQBcTZNEg==","shasum":"3be57defb0f155a03e0a5ee4f522cc50abe2d1bf","tarball":"https://registry.npmjs.org/@codeforcer/i18n-iso-countries-extended/-/i18n-iso-countries-extended-1.0.0.tgz","fileCount":61,"unpackedSize":387951,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJd6PxkCRA9TVsSAnZWagAA8xgP/jHkF3ck/esHPQKiE6QE\nwX/is/HIHfa9dXC7+6lOE4p7M3B8BNX0VVVkZN8gQ768A03yrZZb8tbXfkq6\no3ReNxJ7eIVj91cRbatzJ2KNlHEHCUpnkB9cY+tPnRRAYHZ7IV2nx6zS3Zme\nk4mKMmUVAf32PvFy7MO60HQYDlvxudWxZ/CyytkYw/D+RXnjj28RLsJVUE5z\n/FI7J/dp3mRzTMa05DM43KqkoqA1DvKBI5UPP6UJjC4qT5ocv4OkPvnXD6zk\npcCpi8NMKiH1l29EMyLnXDAdJUYFsVyCiZTCHku59S0TQYjP59crpB8tbzeC\n4cmCt3gRVXOIzMSBIYvfW5DolP8nW6pYQsFmywg/OfcAzq446JM6ZrT+5kzG\nu+WTDeBiNqsqS/t9zdHBmwHWMWOXiR8YrDE5f102TZJxP+ij5X0M6dK72o3J\nKRp54M3FYOiuCjv6f7LhUx7/4J33829YbBecT+S7U5/qMJke7q2b46v5R2U1\nMrT5MvAfgNrwYsNA8M86xFNCXB8s8HQYZHS981dx/FCmqCfYxPXCC54HLkF/\nByF9SDQT1E6btDtgUeFKnFU4DozVjZSFgGUNxncIOF01AWxKwfIOc7zCVH3N\nxIBd2QRLiBOV5oPVMPuscb2oFgiIxxQ1xbojJazgHN7egxUpnGZ17fL9t/Vd\nf1nZ\r\n=FTe1\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIFqubtKtAae1o9MpMtHejYSfdDWcLl6xAABNS/657K8hAiEA1ChmqApBQVkDh21ATBx9/2SlY/3TwWXLkW1W1u+5SjY="}]},"maintainers":[{"name":"codeforcer","email":"nathancworsley@gmail.com"}],"_npmUser":{"name":"codeforcer","email":"nathancworsley@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/i18n-iso-countries-extended_1.0.0_1575550051963_0.304954215116614"},"_hasShrinkwrap":false}},"time":{"created":"2019-12-05T12:47:31.925Z","1.0.0":"2019-12-05T12:47:32.112Z","modified":"2022-04-05T00:02:27.878Z"},"maintainers":[{"name":"codeforcer","email":"nathancworsley@gmail.com"}],"description":"i18n for ISO 3166-1 country codes, extended with new languages","homepage":"https://github.com/michaelwittig/node-i18n-iso-countries#readme","keywords":["i18n","iso","3166","iso 3166","iso 3166-1","alpha","alpha-2","alpha-3","numeric","country","countries","ar","az","be","bg","bs","ca","cs","da","de","el","en","es","et","fa","fi","fr","he","hr","hu","hy","id","it","ja","ka","kk","ko","ky","lt","lv","mk","mn","nb","nl","nn","pl","pt","ro","ru","sk","sl","sr","sv","tg","tk","tr","uk","uz","zh"],"repository":{"type":"git","url":"git+https://github.com/michaelwittig/node-i18n-iso-countries.git"},"contributors":[{"name":"Michael Wittig","email":"post@michaelwittig.info"},{"name":"Bedis ElAcheche","email":"d4rk-5c0rp@ubuntu.com"},{"name":"Johann Behr","email":"behr@oak-labs.com"}],"author":{"name":"Nathan Worsley","email":"nathancworsley@gmail.com"},"bugs":{"url":"https://github.com/michaelwittig/node-i18n-iso-countries/issues"},"license":"MIT","readme":"[![Build Status](https://secure.travis-ci.org/michaelwittig/node-i18n-iso-countries.png)](http://travis-ci.org/michaelwittig/node-i18n-iso-countries)\n[![NPM version](https://badge.fury.io/js/i18n-iso-countries.png)](http://badge.fury.io/js/i18n-iso-countries)\n\n# i18n-iso-countries\n\ni18n for ISO 3166-1 country codes. We support Alpha-2, Alpha-3 and Numeric codes from <http://en.wikipedia.org/wiki/ISO_3166-1#Officially_assigned_code_elements>\n\n## Installing\n\nInstall it using npm: `npm install i18n-iso-countries`\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n```\n\nIf you use `i18n-iso-countries` with Node.js your are done. If you use the package in a browser environment you also have to register the languages you want to use to minimize file size.\n\n```javascript\n// Support french & english languages.\ncountries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\ncountries.registerLocale(require(\"i18n-iso-countries/langs/fr.json\"));\n```\n\n## Code to Country\n\n### Get the name of a country by it's ISO 3166-1 Alpha-2, Alpha-3 or Numeric code\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n// in a browser environment: countries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\nconsole.log(\"US (Alpha-2) => \" + countries.getName(\"US\", \"en\")); // United States of America\nconsole.log(\"US (Alpha-2) => \" + countries.getName(\"US\", \"de\")); // Vereinigte Staaten von Amerika\nconsole.log(\"USA (Alpha-3) => \" + countries.getName(\"USA\", \"en\")); // United States of America\nconsole.log(\"USA (Numeric) => \" + countries.getName(\"840\", \"en\")); // United States of America\n```\n\n### Get all names by their ISO 3166-1 Alpha-2 code\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n// in a browser environment: countries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\nconsole.log(countries.getNames(\"en\")); // { 'AF': 'Afghanistan', 'AL': 'Albania', [...], 'ZM': 'Zambia', 'ZW': 'Zimbabwe' }\n```\n\n### Supported languages (ISO 639-1)\n\n-   `ar`: Arabic\n-   `az`: Azerbaijani\n-   `be`: Belorussian\n-   `bg`: Bulgarian\n-   `bs`: Bosnian\n-   `ca`: Catalan\n-   `cs`: Czech\n-   `da`: Danish\n-   `de`: German\n-   `en`: English\n-   `es`: Spanish\n-   `et`: Estonian\n-   `fa`: Persian\n-   `fi`: Finnish\n-   `fr`: French\n-   `el`: Greek\n-   `he`: Hebrew\n-   `hr`: Croatian\n-   `hu`: Hungarian\n-   `hy`: Armenian\n-   `it`: Italian\n-   `id`: Indonesian\n-   `ja`: Japanese\n-   `ka`: Georgian\n-   `kk`: Kazakh\n-   `ko`: Korean\n-   `ky`: Kyrgyz\n-   `lt`: Lithuanian\n-   `lv`: Latvian\n-   `mk`: Macedonian\n-   `mn`: Mongolian\n-   `nb`: Norwegian Bokmål\n-   `nl`: Dutch\n-   `nn`: Norwegian Nynorsk\n-   `pl`: Polish\n-   `pt`: Portuguese\n-   `ro`: Romanian\n-   `ru`: Russian\n-   `sk`: Slovak\n-   `sl`: Slovene\n-   `sr`: Serbian\n-   `sv`: Swedish\n-   `tr`: Turkish\n-   `uk`: Ukrainian\n-   `uz`: Uzbek\n-   `zh`: Chinese\n\n[List of ISO 639-1 codes](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)\n\n### Country to Code\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n// in a browser environment: countries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\nconsole.log(\"United States of America => \" + countries.getAlpha2Code('United States of America', 'en'));\n// United States of America => US\n\nconsole.log(\"United States of America => \" + countries.getAlpha3Code('United States of America', 'en'));\n// United States of America => USA\n```\n\n## Codes\n\n### Convert Alpha-3 to Alpha-2 code\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n// in a browser environment: countries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\nconsole.log(\"USA (Alpha-3) => \" + countries.alpha3ToAlpha2(\"USA\") + \" (Alpha-2)\");\n// USA (Alpha-3) => US (Alpha-2)\n```\n\n### Convert Numeric to Alpha-2 code\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n// in a browser environment: countries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\nconsole.log(\"840 (Numeric) => \" + countries.numericToAlpha2(\"840\") + \" (Alpha-2)\");\n// 840 (Numeric) => US (Alpha-2)\n```\n\n### Convert Alpha-2 to Alpha-3 code\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n// in a browser environment: countries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\nconsole.log(\"DE (Alpha-2) => \" + countries.alpha2ToAlpha3(\"DE\") + \" (Alpha-3)\");\n// DE (Alpha-2) => DEU (Alpha-3)\n```\n\n### Convert Numeric to Alpha-3 code\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n// in a browser environment: countries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\nconsole.log(\"840 (Numeric) => \" + countries.numericToAlpha3(\"840\") + \" (Alpha-3)\");\n// 840 (Numeric) => USA (Alpha-3)\n```\n\n### Convert Alpha-3 to Numeric code\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n// in a browser environment: countries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\nconsole.log(countries.alpha3ToNumeric(\"SWE\"));\n// 752\n```\n\n### Convert Alpha-2 to Numeric code\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n// in a browser environment: countries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\nconsole.log(countries.alpha2ToNumeric(\"SE\"));\n// 752\n```\n\n### Get all Alpha-2 codes\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n// in a browser environment: countries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\nconsole.log(countries.getAlpha2Codes());\n// { 'AF': 'AFG', 'AX': 'ALA', [...], 'ZM': 'ZMB', 'ZW': 'ZWE' }\n```\n\n### Get all Alpha-3 codes\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n// in a browser environment: countries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\nconsole.log(countries.getAlpha3Codes());\n// { 'AFG': 'AF', 'ALA': 'AX', [...], 'ZMB': 'ZM', 'ZWE': 'ZW' }\n```\n\n### Get all Numeric codes\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n// in a browser environment: countries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\nconsole.log(countries.getNumericCodes());\n// { '004': 'AF', '008': 'AL', [...], '887': 'YE', '894': 'ZM' }\n```\n\n### Validate country code\n\n```javascript\nvar countries = require(\"i18n-iso-countries\");\n// in a browser environment: countries.registerLocale(require(\"i18n-iso-countries/langs/en.json\"));\nconsole.log(countries.isValid(\"US\"), countries.isValid(\"USA\"), countries.isValid(\"XX\")));\n// true, true, false\n```\n\n## Contribution\n\nTo add a language:\n\n-   add a json file under langs/\n-   add the language to the `data` object in enty-node.js at the top\n-   add language to section **Supported languages** in README.md\n-   add language to keywords in package.json\n-   run `npm install && make test` to make sure that tests are passing\n-   open a PR on GitHub\n\nYou can check codes here: https://www.iso.org/obp/ui/#home\n","readmeFilename":"README.md"}