iso-639 0.2.6 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0263cfd7186c66c99ef204cae8d806be734572e4
-  data.tar.gz: 1a63d2d476333d43a3c33bd370bbfcb602a97eec
+  metadata.gz: e04d56e8d3bcac20d583427975e5dc725d709bf0
+  data.tar.gz: ea2dbf57ea549df0407e4910d35ece88ab2241db
 SHA512:
-  metadata.gz: 654bb7a95891255fbdff11d2bb3c18972010f7f7db152868c562400c53df56f91f66529e744157bec811abcfcb1ab835658fc657cfd7927b47d2b6f0bd1ed976
-  data.tar.gz: 026f9abed71f92bfdaf89a73a4f930e26f755d5f29b07553b55dd732a6de71298fc68f3b22cef910a88095ef7eac7fa6225659292c09e22d089fce692d8a5e39
+  metadata.gz: d9660ca78c6c1c1370c4ddcd1c082e57e264c6ab069c7081140926cd98471e4b9b0e44081937bb8bd60b3233042790fb8036808d8b6fbaf3368659d41f2e1327
+  data.tar.gz: c41187fec4236013908099b83cee65f1b5ca78423e4d1d92c994c14a512f0af6c644e1ba9fd414f3e72115e8c9361e13a83ffeb80da820f1e9e40fb31937546f

data/.document

@@ -1,4 +1,4 @@
-README.markdown
+README.md
 lib/**/*.rb
 bin/*
 features/**/*.feature

data/Gemfile

@@ -6,6 +6,7 @@ source "http://rubygems.org"
 # Add dependencies to develop your gem here.
 # Include everything needed to run rake, tests, features, etc.
 group :development, :test do
+  gem "allocation_stats"
   gem "minitest"
   gem "mocha"
   gem "rake"

data/Gemfile.lock

@@ -1,18 +1,19 @@
 GEM
   remote: http://rubygems.org/
   specs:
-    ast (2.2.0)
+    allocation_stats (0.1.5)
+    ast (2.3.0)
     json (1.8.3)
     metaclass (0.0.4)
-    minitest (5.8.4)
+    minitest (5.9.0)
     mocha (1.1.0)
       metaclass (~> 0.0.1)
-    parser (2.3.1.0)
+    parser (2.3.1.2)
       ast (~> 2.2)
     power_assert (0.3.0)
     powerpack (0.1.1)
     rainbow (2.1.0)
-    rake (11.1.2)
+    rake (11.2.2)
     rdoc (4.2.2)
       json (~> 1.4)
     rubocop (0.40.0)
@@ -21,15 +22,16 @@ GEM
       rainbow (>= 1.99.1, < 3.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (~> 1.0, >= 1.0.1)
-    ruby-progressbar (1.8.0)
-    test-unit (3.1.8)
+    ruby-progressbar (1.8.1)
+    test-unit (3.2.0)
       power_assert
-    unicode-display_width (1.0.5)
+    unicode-display_width (1.1.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
+  allocation_stats
   minitest
   mocha
   rake

data/{README.markdown → README.md}

@@ -4,7 +4,9 @@ A Ruby gem that provides the ISO 639-2 and ISO 639-1 data sets along with some c
 
 To install:
 
-    gem install iso-639
+```bash
+gem install iso-639
+```
 
 The [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) specification uses a two-letter code to identify a language and is often the recommended way to identify languages in computer applications. The ISO 639-1 specification covers most developed and widely used languages.
 
@@ -12,42 +14,50 @@ The [ISO 639-2](http://www.loc.gov/standards/iso639-2/) ([Wikipedia](http://en.w
 
 ## Usage
 
-    require 'iso-639'
+```ruby
+require 'iso-639'
+```
 
 To find a language entry:
 
-    # by alpha-2 or alpha-3 code
-    ISO_639.find_by_code("en")
-    # or
-    ISO_639.find("en")
-    # by English name
-    ISO_639.find_by_english_name("Russian")
-    # by French name
-    ISO_639.find_by_french_name("français")
+```ruby
+# by alpha-2 or alpha-3 code
+ISO_639.find_by_code("en")
+# or
+ISO_639.find("en")
+# by English name
+ISO_639.find_by_english_name("Russian")
+# by French name
+ISO_639.find_by_french_name("français")
+```
 
 The `ISO_639.search` class method searches across all fields and will
 match names in cases where a record has multiple names. This method
 always returns an array of 0 or more results. For example:
 
-    ISO_639.search("spanish")
-    # => [["spa", "", "es", "Spanish; Castilian", "espagnol; castillan"]]
+```ruby
+ISO_639.search("spanish")
+# => [["spa", "", "es", "Spanish; Castilian", "espagnol; castillan"]]
+```
 
 Entries are arrays with convenience methods for accessing fields:
 
-    @entry = ISO_639.find("slo")
-    # => ["slo", "slk", "sk", "Slovak", "slovaque"]
-    @entry.alpha3_bibliographic
-    # => "slo"
-    @entry.alpha3 # shortcut for #alpha3_bibliographic
-    # => "slo"
-    @entry.alpha3_terminologic
-    # => "slk"
-    @entry.alpha2
-    # => "sk"
-    @entry.english_name
-    # => "Slovak"
-    @entry.french_name
-    # => "slovaque"
+```ruby
+@entry = ISO_639.find("slo")
+# => ["slo", "slk", "sk", "Slovak", "slovaque"]
+@entry.alpha3_bibliographic
+# => "slo"
+@entry.alpha3 # shortcut for #alpha3_bibliographic
+# => "slo"
+@entry.alpha3_terminologic
+# => "slk"
+@entry.alpha2
+# => "sk"
+@entry.english_name
+# => "Slovak"
+@entry.french_name
+# => "slovaque"
+```
 
 The full data set is available through the `ISO_639::ISO_639_1` and `ISO_639::ISO_639_2` constants.
 

data/iso-639.gemspec

@@ -5,23 +5,23 @@
 
 Gem::Specification.new do |s|
   s.name = "iso-639"
-  s.version = "0.2.6"
+  s.version = "0.2.7"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["William Melody"]
-  s.date = "2016-05-09"
+  s.date = "2016-06-22"
   s.description = "ISO 639-1 and ISO 639-2 language code entries and convenience methods"
   s.email = "hi@williammelody.com"
   s.extra_rdoc_files = [
     "LICENSE",
-    "README.markdown"
+    "README.md"
   ]
   s.files = [
     ".document",
     "Gemfile",
     "Gemfile.lock",
     "LICENSE",
-    "README.markdown",
+    "README.md",
     "Rakefile",
     "iso-639.gemspec",
     "lib/iso-639.rb",

data/lib/iso-639.rb

@@ -1,7 +1,20 @@
 # encoding: UTF-8
+# frozen_string_literal: true
 # http://www.loc.gov/standards/iso639-2/ascii_8bits.html
 
 class ISO_639 < Array
+  # Redefine `[]` to freeze all strings and arrays.
+  #
+  # Ruby 2.3+ uses the `frozen_string_literal` magic comment to freeze all
+  # strings, while previous versions require the `#map` approach.
+  def self.[](*args)
+    if args[0].frozen?
+      super(*args).freeze
+    else
+      super(*args.map(&:freeze)).freeze
+    end
+  end
+
   # The ISO 639-2 dataset as an array of entries. Each entry is an array with
   # the following format:
   # * [0]: an alpha-3 (bibliographic) code
@@ -495,7 +508,7 @@ class ISO_639 < Array
     self["zun", "", "", "Zuni", "zuni"],
     self["zxx", "", "", "No linguistic content; Not applicable", "pas de contenu linguistique; non applicable"],
     self["zza", "", "", "Zaza; Dimili; Dimli; Kirdki; Kirmanjki; Zazaki", "zaza; dimili; dimli; kirdki; kirmanjki; zazaki"]
-  ]
+  ].freeze
 
   # An inverted index generated from the ISO_639_2 data. Used for searching
   # all words and codes in all fields.
@@ -517,7 +530,7 @@ class ISO_639 < Array
       end
     end
     return index
-  end.call
+  end.call.freeze
 
   # The ISO 639-1 dataset as an array of entries. Each entry is an array with
   # the following format:
@@ -528,7 +541,7 @@ class ISO_639 < Array
   # * [4]: a French name
   ISO_639_1 = ISO_639_2.collect do |entry|
     entry unless entry[2].empty?
-  end.compact
+  end.compact.freeze
 
   class << self
     # Returns the entry array for an alpha-2 or alpha-3 code

data/test/test_iso_639.rb

@@ -90,4 +90,40 @@ describe ISO_639 do
       ISO_639.search("yupik, langues")
     )
   end
+
+  it "should error when attempting to change immutable ISO_639_2" do
+    assert_raises RuntimeError do
+      ISO_639::ISO_639_2 << ["test", "array"]
+    end
+
+    assert_raises RuntimeError do
+      ISO_639::ISO_639_2[0] = []
+    end
+
+    assert_raises RuntimeError do
+      ISO_639::ISO_639_2[0][1] = ""
+    end
+
+    assert_raises RuntimeError do
+      ISO_639::ISO_639_2[0][1].upcase!
+    end
+  end
+
+  it "should error when attempting to change immutable ISO_639_1" do
+    assert_raises RuntimeError do
+      ISO_639::ISO_639_1 << ["test", "array"]
+    end
+
+    assert_raises RuntimeError do
+      ISO_639::ISO_639_1[0] = []
+    end
+
+    assert_raises RuntimeError do
+      ISO_639::ISO_639_1[0][1] = ""
+    end
+
+    assert_raises RuntimeError do
+      ISO_639::ISO_639_1[0][1].upcase!
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iso-639
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.7
 platform: ruby
 authors:
 - William Melody
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-09 00:00:00.000000000 Z
+date: 2016-06-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -86,13 +86,13 @@ executables: []
 extensions: []
 extra_rdoc_files:
 - LICENSE
-- README.markdown
+- README.md
 files:
 - ".document"
 - Gemfile
 - Gemfile.lock
 - LICENSE
-- README.markdown
+- README.md
 - Rakefile
 - iso-639.gemspec
 - lib/iso-639.rb