llaxta 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e9bbf0a82b338dcce0967b82a162b6fdbf6991436771641c1a67e108995c0879
+  data.tar.gz: d6799b66953da5df87e6e3af83e27cd8bf77ec01222e3d6c309c25bfef240c53
+SHA512:
+  metadata.gz: 814808049396b86c29212f8fa07d4e13c0c11527b5d8613a581872f2cbe8f4ada21c178a72211383c40c827dec4e93a4d7c6533399b7690409b85f27e6381bcc
+  data.tar.gz: '03429b9e5957abdbeead30e176fdbf69d29388129b439e1653f5623a87ebfc43f0083f0ba8f0dd9415ae816d07c1061875b3f5b34c86da0352198e0908f56004'

data/.gitignore

@@ -0,0 +1,22 @@
+.DS_Store
+.idea
+.ruby-version
+.tool-versions
+gemfiles/*.lock
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper --color

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+# 0.0.1 (June 8, 2021)
+
+- Initial commit

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/README.md

@@ -0,0 +1,20 @@
+Get the name of any of the 249 countries listed in English US, Spanish, Brazilian Portuguese and/or Simplified Chinese.
+
+### Usage
+
+There's an only public method called `t` which receives the country Alpha2 code and the locale corresponding to the language in which the country name is going to be shown.
+
+```ruby
+LLaxta.t("CH", "en_us") # => "Switzerland"
+LLaxta.t("CH", "es")    # => "Suiza"
+LLaxta.t("CH", "pt_br") # => "Suíça"
+LLaxta.t("CH", "zh_cn") # => "瑞士"
+```
+
+For convenience, and because there's only 4 supported locales, you can use the short version of the languages English (`us`), Portuguese (`br`) and Chinese (`cn`):
+
+```ruby
+LLaxta.t("CH", "us") # => "Switzerland"
+LLaxta.t("CH", "br") # => "Suíça"
+LLaxta.t("CH", "cn") # => "瑞士"
+```

data/lib/llaxta.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require "yaml"
+require "llaxta/exceptions"
+
+class Llaxta
+  VERSION = Gem::Version.new("0.0.1")
+
+  class << self
+    def t(alpha2, locale)
+      raise Exceptions::AlphaMissing unless alpha2
+
+      dictionary(locale)[alpha2]
+    end
+
+    private
+
+    def dictionary(locale)
+      @@locales ||= {}
+      @@locales[locale] ||= new(locale).send(:load_dict)
+    end
+  end
+
+  private
+
+  attr_reader :locale
+
+  SUPPORTED_LOCALES = {
+    "en_us" => "en_us",
+    "us" => "en_us",
+    "es" => "es",
+    "pt_br" => "pt_br",
+    "br" => "pt_br",
+    "zh_cn" => "zh_cn",
+    "cn" => "zh_cn",
+  }.freeze
+  private_constant :SUPPORTED_LOCALES
+
+  def initialize(locale)
+    raise Exceptions::LocaleMissing unless locale
+
+    @locale = SUPPORTED_LOCALES[locale]
+  end
+
+  def load_dict
+    YAML.load_file(locale_path)
+  rescue Errno::ENOENT
+    raise Exceptions::LocaleNotFound.new(locale)
+  end
+
+  def locale_path
+    File.expand_path("../llaxta/locales/#{locale}.yml", __FILE__)
+  end
+end

data/lib/llaxta/exceptions.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Exceptions
+  class AlphaMissing < StandardError
+    def initialize
+      super("Alpha can not be blank!")
+    end
+  end
+
+  class LocaleMissing < StandardError
+    def initialize
+      super("Locale can not be blank!")
+    end
+  end
+
+  class LocaleNotFound < StandardError
+    def initialize(locale)
+      super("Locale \"#{locale}\" was not found!")
+    end
+  end
+end

data/llaxta.gemspec

@@ -0,0 +1,29 @@
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "llaxta"
+
+Gem::Specification.new do |spec|
+  spec.name = "llaxta"
+  spec.required_ruby_version = ">= 2.2.0"
+  spec.homepage = "https://github.com/kucho/llaxta"
+  spec.version = Llaxta::VERSION
+  spec.platform = Gem::Platform::RUBY
+  spec.summary = "Translate ISO 3166-1 codes to Country names given a locale"
+  spec.description = "Translate ISO 3166-1 codes to Country names given a locale"
+  spec.authors = ["Victor Rodriguez", "Sebastian Palma"]
+  spec.email = "victor.rodriguez.guriz@gmail.com"
+  spec.license = "MIT"
+
+  spec.files = `git ls-files`.split($/)
+  spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+  spec.metadata = {
+    "source_code_uri" => "https://github.com/kucho/llaxta",
+    "changelog_uri" => "https://github.com/kucho/llaxta/blob/master/CHANGELOG.md"
+  }
+
+  spec.add_development_dependency("bundler", "~> 2.2")
+  spec.add_development_dependency("standard", "~> 1.0")
+  spec.add_development_dependency("rspec", "~> 3.10")
+  spec.add_development_dependency("pry", "~> 0.14.1")
+end

data/spec/llaxta_spec.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+RSpec.describe Llaxta do
+  describe ".t" do
+    context "when locale is valid" do
+      context "with locale en_us" do
+        it "returns the country name given the iso_code and locale" do
+          expect(Llaxta.t("CH", "en_us")).to eq("Switzerland")
+        end
+      end
+
+      context "with locale es" do
+        it "returns the country name given the iso_code and locale" do
+          expect(Llaxta.t("CH", "es")).to eq("Suiza")
+        end
+      end
+
+      context "with locale pt_br" do
+        it "returns the country name given the iso_code and locale" do
+          expect(Llaxta.t("CH", "pt_br")).to eq("Suíça")
+        end
+      end
+
+      context "with locale pt_br" do
+        it "returns the country name given the iso_code and locale" do
+          expect(Llaxta.t("CH", "zh_cn")).to eq("瑞士")
+        end
+      end
+    end
+
+    context "using a short-version locale" do
+      context "with locale us" do
+        it { expect(Llaxta.t("CH", "us")).to eq("Switzerland") }
+      end
+
+      context "with locale br" do
+        it { expect(Llaxta.t("CH", "br")).to eq("Suíça") }
+      end
+
+      context "with locale cn" do
+        it { expect(Llaxta.t("CH", "cn")).to eq("瑞士") }
+      end
+    end
+  end
+
+  describe "exceptions" do
+    context "when locale is NOT valid" do
+      it "raises" do
+        expect { Llaxta.t("PE", "2GFA") }.to raise_exception Exceptions::LocaleNotFound
+      end
+    end
+
+    context "when alpha is nil" do
+      it "raises" do
+        expect { Llaxta.t(nil, "br") }.to raise_exception Exceptions::AlphaMissing
+      end
+    end
+
+    context "when locale is nil" do
+      it "raises" do
+        expect { Llaxta.t("PE", nil) }.to raise_exception Exceptions::LocaleMissing
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "rspec"
+require "llaxta"
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |c|
+    c.syntax = :expect # disables `should`
+  end
+end

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification
+name: llaxta
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Victor Rodriguez
+- Sebastian Palma
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-06-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.1
+description: Translate ISO 3166-1 codes to Country names given a locale
+email: victor.rodriguez.guriz@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- CHANGELOG.md
+- Gemfile
+- README.md
+- lib/llaxta.rb
+- lib/llaxta/exceptions.rb
+- llaxta.gemspec
+- spec/llaxta_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/kucho/llaxta
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/kucho/llaxta
+  changelog_uri: https://github.com/kucho/llaxta/blob/master/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.15
+signing_key:
+specification_version: 4
+summary: Translate ISO 3166-1 codes to Country names given a locale
+test_files:
+- spec/llaxta_spec.rb
+- spec/spec_helper.rb