runeterra_cards 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 275e8ca4e8362b65da7022dc3042e9fbe3b0970f52443e652476757be52125f1
-  data.tar.gz: ab803e005acf47f9499aad38aaad76d0e1c59c275dc4457bc8735208f08baace
+  metadata.gz: a7a06c2e4f2c76ba4038979ac6215010fb95b763da60717bc18faec557d41dcb
+  data.tar.gz: 1583f4620c7ccc60f3f2d18ed5646f2c9e2d38691cd191340dc70db9de9012ec
 SHA512:
-  metadata.gz: f406aad97cd4b6b57b356f08ff665661d3edecd608467b0a04b2c76d434927bc406cd01fec7f02aa171701f0a0f89fd2e322de7cbc871d18cb58993c9ae4d9e3
-  data.tar.gz: 96023313de8c2868fbf551185224a9441a13e30ddb297f9766b69b07481f4d21c1a56b78052ec09ba3a5aa22878c39f1c94ef196a235838b5cc447bb08255d96
+  metadata.gz: 571ad2f19f35022cdc41f9b0195b7a87b70e6f6cb7f75438e16a6e7e891355c1615debf359dd59c0717abe7cb7125adfde5e8a54b076dcecf45389364df6827b
+  data.tar.gz: b5414fa7da1d020f6ec6eec394e66fa1735f264a60e850be18e8f5dba303959e5f517a3bbb6d0edbb1734867d619b432c7cbeb5a6bebc461c33946d7634fc692

data/lib/runeterra_cards/card_and_count.rb

@@ -23,7 +23,7 @@ module RuneterraCards
         @code = code
       else
         padded_set = format('%<i>02d', i: set)
-        faction = FACTION_IDENTIFIERS_FROM_INT.fetch(faction_number)
+        faction = FACTION_IDENTIFIERS_FROM_INT.fetch(faction_number) { |key| raise UnrecognizedFactionError, key }
         padded_card_number = format('%<i>03d', i: card_number)
         @code = "#{padded_set}#{faction}#{padded_card_number}"
       end

data/lib/runeterra_cards/errors.rb

@@ -29,9 +29,31 @@ module RuneterraCards
   # issue relating to this. If none exists, then file one!
   # @see SUPPORTED_VERSION
   class UnrecognizedVersionError < DeckCodeParseError
+    # @return [Fixnum] the version number encountered in the deck code
+    attr_accessor :version
+
     def initialize(expected, got)
       super("Unrecognized deck code version number: #{got}, was expecting: #{expected}. \
 Possibly an invalid deck code, possibly you need to update the deck code library version.")
+      @version = got
+    end
+  end
+
+  # This exception is raised if the deck code contains an unexpected faction number. (see the table at
+  # {https://github.com/RiotGames/LoRDeckCodes} for what 'faction number' means.) This most likely means that
+  # Legends of Runeterra has a new faction and you need to update to a newer version of this library to handle it.
+  #
+  # Check that the {#faction_number} causing issues is listed in {https://github.com/RiotGames/LoRDeckCodes
+  # the table on Github}. If it isn't then something else has gone wrong. If it is, and updating this library doesn't
+  # fix the issue, then the library needs updating - {https://github.com/zofrex/runeterra_cards/issues file an issue}.
+  class UnrecognizedFactionError < DeckCodeParseError
+    # @return [Fixnum] the faction number that was unrecognized
+    attr_reader :faction_number
+
+    def initialize(faction_number)
+      super("Unrecognized faction number '#{faction_number}'."\
+        ' Possibly you need to update this library to a newer version')
+      @faction_number = faction_number
     end
   end
 

data/lib/runeterra_cards/factions.rb

@@ -1,11 +1,20 @@
 # frozen_string_literal: true
 
 module RuneterraCards
-  # An array of the two-letter Faction identifiers, indexed by their integer identifiers
+  # An map from integer faction identifiers to their two-letter identifiers
   # @example
   #   FACTION_IDENTIFIERS_FROM_INT[2] #=> "IO"
-  # @return [Array<String>]
-  FACTION_IDENTIFIERS_FROM_INT = %w[DE FR IO NX PZ SI BW].freeze
+  # @return [Hash<Fixnum,String>]
+  FACTION_IDENTIFIERS_FROM_INT = {
+    0 => 'DE',
+    1 => 'FR',
+    2 => 'IO',
+    3 => 'NX',
+    4 => 'PZ',
+    5 => 'SI',
+    6 => 'BW',
+    9 => 'MT',
+  }.freeze
 
   # A map from two-letter Faction identifiers to their integer identifiers
   # @example
@@ -19,5 +28,6 @@ module RuneterraCards
     'PZ' => 4,
     'SI' => 5,
     'BW' => 6,
+    'MT' => 9,
   }.freeze
 end

data/lib/runeterra_cards/version.rb

@@ -2,5 +2,5 @@
 
 module RuneterraCards
   # The version of this library
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: runeterra_cards
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - zofrex
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-08-28 00:00:00.000000000 Z
+date: 2020-08-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base32