{"id":19190073,"url":"https://github.com/apainintheneck/atlasq","last_synced_at":"2026-06-15T02:33:16.535Z","repository":{"id":207891845,"uuid":"719876773","full_name":"apainintheneck/atlasq","owner":"apainintheneck","description":"country info at the command line","archived":false,"fork":false,"pushed_at":"2026-05-10T07:12:49.000Z","size":1128,"stargazers_count":2,"open_issues_count":7,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-02T23:06:45.190Z","etag":null,"topics":["countries","country","currencies","currency","gem","region","regions","ruby"],"latest_commit_sha":null,"homepage":"https://rubygems.org/gems/atlasq","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apainintheneck.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-11-17T04:51:34.000Z","updated_at":"2025-06-08T18:10:41.000Z","dependencies_parsed_at":"2023-11-18T09:26:55.296Z","dependency_job_id":"c9ebae22-3b5b-4104-ac89-f7a57de3cb9a","html_url":"https://github.com/apainintheneck/atlasq","commit_stats":null,"previous_names":["apainintheneck/atlasq"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/apainintheneck/atlasq","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apainintheneck%2Fatlasq","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apainintheneck%2Fatlasq/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apainintheneck%2Fatlasq/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apainintheneck%2Fatlasq/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apainintheneck","download_url":"https://codeload.github.com/apainintheneck/atlasq/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apainintheneck%2Fatlasq/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34345577,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["countries","country","currencies","currency","gem","region","regions","ruby"],"created_at":"2024-11-09T11:32:52.240Z","updated_at":"2026-06-15T02:33:16.530Z","avatar_url":"https://github.com/apainintheneck.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Atlasq\n[![Gem Version](https://badge.fury.io/rb/atlasq.svg)](https://badge.fury.io/rb/atlasq)\n\nQuery for country info at the command line.\n\n```console\n$ atlasq \natlasq -- a utility to query country info\n\nusage:\n  atlasq query...\n  atlasq [command] query...\n  atlasq -h/--help\n  atlasq -v/--version\n\ncommands:\n  -c/--country : find countries\n  -r/--region  : find countries by region\n  -m/--money   : find countries by currency\n\n```\n\nInstall the gem from RubyGems with `gem install atlasq`.\n\nNote: This gem is only tested on Linux and macOS.\n\n## Documentation\n\n```console\n$ atlasq --help\nNAME\n  atlasq -- a utility to query country info\n\nSYNOPSIS:\n  atlasq [query ...]\n  atlasq [option]\n  atlasq [option] [query ...]\n\nDESCRIPTIONS\n  Atlas Query aims to be the the simplest way to query for country\n  info at the command line. It includes logic to not only find\n  countries by name but also by region and currency.\n\n  To do this we take advantage of a myriad of different ISO standards:\n    - ISO3166 : Alpha and numeric codes for countries and subdivisions\n    - ISO4217 : Alpha and numeric codes for currencies\n    - ISO639  : Alpha and numeric codes for languages\n\nOPTIONS\n  [none]\n    : Search for countries by the following criteria\n      1. country  (like --country)\n      2. region   (like --region)\n      3. currency (like --money)\n\n  -c/--country\n    : Display all countries\n  -c/--country [query ...]\n    : Search for countries by the following criteria\n      1. alpha2 (ISO3166 standard 2 letter code)\n      2. alpha3 (ISO3166 standard 3 letter code)\n      3. number (ISO3166 standard 3 digit code)\n      4. name   (common, localized, unofficial)\n      5. partial match on name\n\n  -r/--region\n    : Display all countries by subregion\n  -r/--region  [query ...]\n    : Search for countries by the following criteria\n      1. region\n      2. subregion\n      3. world region (4 letter code)\n      4. continent\n\n  -m/--money\n    : Display all countries by currency\n  -m/--money   [query ...]\n    : Search for countries by the following criteria\n      1. code   (ISO4127 standard 3 letter code)\n      2. name   (ISO4127 standard name)\n      3. symbol\n      4. partial match on name\n\n  -l/--language\n    : Display all countries by language\n  -l/--language   [query ...]\n    : Search for countries by the following criteria\n      1. alpha2 (ISO639 standard 2 letter code)\n      2. alpha3 (ISO639 standard 3 letter code)\n      3. partial match on name in English or French\n\n  -h/--help\n    : Display this page\n\n  -v/--version\n    : Display the version (1.0.2)\n\n  -d/--debug\n    : Display debug output\n\n```\n\n## Examples\n\n### Countries\n\n```console\n$ atlasq --country 418\n*\n* Country: The Lao People's Democratic Republic\n* * * * * * * * * * * * * * * * * * * * * * * * *\n(🇱🇦 | 418 | LA | LAO | Lao People's Democratic Republic)\n | Languages: Lao\n  | Nationality: Laotian\n   | Region: South-Eastern Asia\n    | Continent: Asia\n     | Currency: ₭ Lao Kip\n      |________________________________________\n\n```\n\n```console\n$ atlasq --country AM\n*\n* Country: The Republic of Armenia\n* * * * * * * * * * * * * * * * * * *\n(🇦🇲 | 051 | AM | ARM | Armenia)\n | Languages: Armenian / Russian\n  | Nationality: Armenian\n   | Region: Western Asia\n    | Continent: Asia\n     | Currency: դր. Armenian Dram\n      |________________________________________\n\n```\n\n```console\n$ atlasq --country honduras\n*\n* Country: The Republic of Honduras\n* * * * * * * * * * * * * * * * * * *\n(🇭🇳 | 340 | HN | HND | Honduras)\n | Languages: Spanish; Castilian\n  | Nationality: Honduran\n   | Region: Central America\n    | Continent: North America\n     | Currency: L Honduran Lempira\n      |________________________________________\n\n```\n\n### Regions\n\n```console\n$ atlasq --region melanesia\n*\n* Region: Melanesia\n* * * * * * * * * * *\n(🇫🇯 | 242 | FJ | FJI | Fiji)\n(🇳🇨 | 540 | NC | NCL | New Caledonia)\n(🇵🇬 | 598 | PG | PNG | Papua New Guinea)\n(🇸🇧 | 090 | SB | SLB | Solomon Islands)\n(🇻🇺 | 548 | VU | VUT | Vanuatu)\n\n```\n\n```console\n$ atlasq --region antarctica\n*\n* Region: Antarctica\n* * * * * * * * * * * *\n(🇦🇶 | 010 | AQ | ATA | Antarctica)\n(🇧🇻 | 074 | BV | BVT | Bouvet Island)\n(🇬🇸 | 239 | GS | SGS | South Georgia and the South Sandwich Islands)\n(🇭🇲 | 334 | HM | HMD | Heard Island and McDonald Islands)\n\n```\n\n### Currencies\n\n```console\n$ atlasq --money ANG\n*\n* Currency: [ANG] ƒ Netherlands Antillean Gulden\n* * * * * * * * * * * * * * * * * * * * * * * * * *\n(🇨🇼 | 531 | CW | CUW | Curaçao)\n(🇸🇽 | 534 | SX | SXM | Sint Maarten (Dutch part))\n\n```\n\n```console\n$ atlasq --money \\฿\n*\n* Currencies (Partial Match)\n* * * * * * * * * * * * * * * *\n- [THB] ฿ Thai Baht\n    (🇹🇭 | 764 | TH | THA | Thailand)\n\n```\n\n```console\n$ atlasq --money Surinamese\\ Dollar\n*\n* Currency: [SRD] $ Surinamese Dollar\n* * * * * * * * * * * * * * * * * * * *\n(🇸🇷 | 740 | SR | SUR | Suriname)\n\n```\n\n### Languages\n\n```console\n$ atlasq --language ch\n*\n* Language: (cha/ch) Chamorro\n* * * * * * * * * * * * * * * *\n(🇬🇺 | 316 | GU | GUM | Guam)\n(🇲🇵 | 580 | MP | MNP | Northern Mariana Islands)\n\n```\n\n```console\n$ atlasq --language greek\n*\n* Languages (Partial Match)\n* * * * * * * * * * * * * * *\n- (grc/**) Greek, Ancient (to 1453)\n- (gre/el) Greek, Modern (1453-)\n    (🇨🇾 | 196 | CY | CYP | Cyprus)\n    (🇬🇷 | 300 | GR | GRC | Greece)\n\n```\n\n## Data\n\nCountry data is sourced from the [countries](https://github.com/countries/countries) gem which provides country and region information and implements the ISO3166 standard country codes and names.\n\nCurrency data is sourced from the [money](https://github.com/RubyMoney/money) gem which provides information about currency names and symbols.\n\nLanguage data is sourced from the [ISO-639](https://github.com/xwmx/iso-639) gem which implements the ISO369 standard for language codes and names.\n\n## Development\n\nAfter checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. Use either `rake standard` to lint the code.\n\nYou can also run `bin/console` for an interactive prompt that will allow you to experiment.\n\nTo install this gem onto your local machine, run `bundle exec rake install`.\n\nThis file gets generated with the `rake readme:generate` command to make sure the example output is always up-to-date. We even check for this on CI with the `rake readme:outdated` command.\n\nMore information about cached files can be found in `cache/README.md`.\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/apainintheneck/atlasq.\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapainintheneck%2Fatlasq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapainintheneck%2Fatlasq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapainintheneck%2Fatlasq/lists"}