Skip to content

🌐 Lists of various ISO standards (ISO 3166-1 for countries and ISO 639-2 for languages) with translations for Crystal

License

Notifications You must be signed in to change notification settings

mamantoha/iso_codes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ISO Codes

Crystal CI GitHub release License

This project provides lists of various ISO standards (ISO 3166-1 for countries and ISO 639-2 for languages) with translations for Crystal programming language.

ISO 3166-1

This lists the 2-letter country code and "short" country name. The official ISO 3166-1 maintenance agency is ISO.

http://www.iso.org/iso/country_codes

ISO 639-2

This lists the 2-letter and 3-letter language codes and language names. The official ISO 639-2 maintenance agency is the Library of Congress.

http://www.loc.gov/standards/iso639-2/

Translations

  • 249 Country codes (ISO 3166-1 - 2 letter) in 161 Languages
  • 487 Language codes (ISO_639-2 - 2 letter) in 98 Languages

Installation

  1. Add the dependency to your shard.yml:

    dependencies:
      iso_codes:
        github: mamantoha/iso_codes
  2. Run shards install

Usage

require "iso_codes"

country = ISOCodes.countries.find_by_alpha_2("UA")
# => #<ISOCodes::Country:0x7f4bd307e5a0 @alpha_2="UA", @alpha_3="UKR", @name="Ukraine", @numeric="804", @official_name=nil, @flag="🇺🇦", @common_name=nil>

country.translation("pt")
# => Ucrânia

language = ISOCodes.languages.find_by_name("Ukrainian")
# => #<ISOCodes::Language:0x7f7c5b9eae80 @alpha_2="uk", @alpha_3="ukr", @name="Ukrainian", @common_name=nil, @bibliographic=nil>

language.translation("fr")
# => Ukrainien

Development

Update data from https://salsa.debian.org/iso-codes-team/iso-codes.git to make changes available to users:

make update_data

Contributing

  1. Fork it (https://github.com/mamantoha/iso_codes/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

About

🌐 Lists of various ISO standards (ISO 3166-1 for countries and ISO 639-2 for languages) with translations for Crystal

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published