zombie_battleground-api 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11df9750d399535b01b26d87d68a25297f330f51dd0e347d31d1c0dbda43a032
-  data.tar.gz: 0c293f96164be6fe65eb072e56d7ff23d616d8e7f4d421a3e182cec36319ddaa
+  metadata.gz: 0eed5214567ac570ecbdfcbeedc8269cd6ccb7b4b9a1478f319ef27a2e67ba8e
+  data.tar.gz: 92782a7faa90816774764b2d70f078d0f9e3c2a1d30f1c29253030935900d130
 SHA512:
-  metadata.gz: 727b93807b5a4ff030c2cb9877a38390a1c6dccb2b4a0a322348502fb9284fbaf593f1f3ee64e59ad7fd203d70ca41843c1e8f6974e9f49bc6ba67fdf153b663
-  data.tar.gz: 0f50bf8ea5c3af8523941303405486d23851c7e4b0f72c4d346a4f8d5f72afb199e78aacf63ff492597dfa88a5fc3edc2f1eab115ef9c07748a1305f55def3c2
+  metadata.gz: 4b397cee1af935eb4f24084c325bd96cca10ffbeee7916611446057c88497d52c6d35c8a39648ec5292da05e6eea65c74d1414a9b86dbefe177db43656e13d27
+  data.tar.gz: '09ee97e39b13d6dd8e52811d9083c619e6e70a78b00514eb2d2b5c940d85b54bb2971d97f260d51e47fe27ac9f4bca193cb839d8220a5caa08b9cb8a009585f1'

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    zombie_battleground-api (0.4.1)
+    zombie_battleground-api (0.5.0)
       activerecord
       faraday
       json

data/README.md

@@ -26,7 +26,7 @@ Or install it yourself as:
 
 ## Usage
 
-See the [API documentation](https://www.rubydoc.info/gems/zombie_battleground-api/0.4.1).
+See the [API documentation](https://www.rubydoc.info/gems/zombie_battleground-api/0.5.0).
 Every API call returns a response object that contains a complete modeled Ruby object of the response.
 
 Use the singleton class `ZombieBattleground::Api`. The singleton has additional extentions, the client implements the public API as is.

data/lib/zombie_battleground/api/client.rb

@@ -59,9 +59,10 @@ module ZombieBattleground
       # @param hero_id [Integer] Optionally filter on Deck hero_id
       # @param primary_skill_id [Integer] Optionally filter on Deck primary_skill_id
       # @param secondary_skill_id [Integer] Optionally filter on Deck secondary_skill_id
-      # @param version [String] Optionally filter on Deck version
+      # @param version [string] optionally filter on deck version
       # @param page [Integer] Used for pagination of query results
       # @param limit [Integer] Used for pagination of query results. Max 100
+      # @param remove_invalid [Boolean] Remove invalid decks from response. Default: true
       #
       # @return [ZombieBattleground::Api::Responses::GetDecksResponse]
       #
@@ -73,12 +74,15 @@ module ZombieBattleground
       #
       # @api public
       def decks_request(**args)
+        remove_invalid = args[:remove_invalid].nil? ? true : args.delete(:remove_invalid)
+
         request = ZombieBattleground::Api::Requests::GetDecksRequest.new
         args.each { |key, val| request.send("#{key}=", val) }
         raise ZombieBattleground::Api::Errors::InvalidInput, request.errors.messages unless request.valid?
 
         response = connection(uri: request.uri, params: request.params).get
         decks = ZombieBattleground::Api::Responses::GetDecksResponse.new(response)
+        decks.remove_invalid = remove_invalid
         raise ZombieBattleground::Api::Errors::InvalidResponse.new(response, decks) unless decks.valid?
 
         decks
@@ -121,6 +125,7 @@ module ZombieBattleground
       # @param winner_id [String] Optionally filter on Match winner_id
       # @param page [Integer] Used for pagination of query results
       # @param limit [Integer] Used for pagination of query results. Max 100
+      # @param remove_invalid [Boolean] Remove invalid decks from response. Default: true
       #
       # @return [ZombieBattleground::Api::Responses::GetMatchesResponse]
       #
@@ -132,12 +137,15 @@ module ZombieBattleground
       #
       # @api public
       def matches_request(**args)
+        remove_invalid = args[:remove_invalid].nil? ? true : args.delete(:remove_invalid)
+
         request = ZombieBattleground::Api::Requests::GetMatchesRequest.new
         args.each { |key, val| request.send("#{key}=", val) }
         raise ZombieBattleground::Api::Errors::InvalidInput, request.errors.messages unless request.valid?
 
         response = connection(uri: request.uri, params: request.params).get
         matches = ZombieBattleground::Api::Responses::GetMatchesResponse.new(response)
+        matches.remove_invalid = remove_invalid
         raise ZombieBattleground::Api::Errors::InvalidResponse.new(response, matches) unless matches.valid?
 
         matches
@@ -186,6 +194,7 @@ module ZombieBattleground
       # @param cost [Integer] Optionally filter on Card cost
       # @param page [Integer] Used for pagination of query results
       # @param limit [Integer] Used for pagination of query results. Max 100
+      # @param remove_invalid [Boolean] Remove invalid decks from response. Default: true
       #
       # @return [ZombieBattleground::Api::Responses::GetCardsResponse]
       #
@@ -197,12 +206,15 @@ module ZombieBattleground
       #
       # @api public
       def cards_request(**args)
+        remove_invalid = args[:remove_invalid].nil? ? true : args.delete(:remove_invalid)
+
         request = ZombieBattleground::Api::Requests::GetCardsRequest.new
         args.each { |key, val| request.send("#{key}=", val) }
         raise ZombieBattleground::Api::Errors::InvalidInput, request.errors.messages unless request.valid?
 
         response = connection(uri: request.uri, params: request.params).get
         cards = ZombieBattleground::Api::Responses::GetCardsResponse.new(response)
+        cards.remove_invalid = remove_invalid
         raise ZombieBattleground::Api::Errors::InvalidResponse.new(response, cards) unless cards.valid?
 
         cards

data/lib/zombie_battleground/api/constants.rb

@@ -7,5 +7,9 @@ module ZombieBattleground
     ##
     # Max items per page
     PAGE_MAX = 100
+
+    ##
+    # Required amount of cards in deck
+    DECK_REQUIRED_CARDS_COUNT = 30
   end
 end

data/lib/zombie_battleground/api/extensions/cards.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'yaml'
+
 require 'zombie_battleground/api/constants'
 
 module ZombieBattleground
@@ -34,7 +36,7 @@ module ZombieBattleground
         # @api public
         def all_cards(**args)
           args.delete(:limit) # query as many as possible
-          return enum_for(:all_cards) unless block_given?
+          return enum_for(:all_cards, args) unless block_given?
 
           page = 1
 
@@ -60,7 +62,7 @@ module ZombieBattleground
         #
         # @api public
         def card_kinds
-          all_cards.map(&:kind).uniq
+          load_cards_data['kinds']
         end
 
         ##
@@ -74,7 +76,7 @@ module ZombieBattleground
         #
         # @api public
         def card_ranks
-          all_cards.map(&:rank).uniq
+          load_cards_data['ranks']
         end
 
         ##
@@ -88,7 +90,21 @@ module ZombieBattleground
         #
         # @api public
         def card_sets
-          all_cards.map(&:set).uniq
+          load_cards_data['sets']
+        end
+
+        ##
+        # Fetches all card factions
+        #
+        # @return [Array<String>]
+        #
+        # @example
+        #   factions = ZombieBattleground::Api.card_factions
+        #   # => [String]
+        #
+        # @api public
+        def card_factions
+          load_cards_data['factions']
         end
 
         ##
@@ -102,7 +118,7 @@ module ZombieBattleground
         #
         # @api public
         def card_types
-          all_cards.map(&:type).uniq
+          load_cards_data['types']
         end
 
         ##
@@ -116,7 +132,7 @@ module ZombieBattleground
         #
         # @api public
         def card_rarities
-          all_cards.map(&:rarity).uniq
+          load_cards_data['rarities']
         end
 
         ##
@@ -127,11 +143,11 @@ module ZombieBattleground
         # @return [Array<ZombieBattleground::Api::Models::Card>]
         #
         # @example
-        #   cards = ZombieBattleground::Api.cards_by_kind(kind: "SPELL")
+        #   cards = ZombieBattleground::Api.cards_by_kind("SPELL")
         #   # => [ZombieBattleground::Api::Models::Card]
         #
         # @api public
-        def cards_by_kind(kind:)
+        def cards_by_kind(kind)
           all_cards(kind: kind).to_a
         end
 
@@ -143,11 +159,11 @@ module ZombieBattleground
         # @return [Array<ZombieBattleground::Api::Models::Card>]
         #
         # @example
-        #   cards = ZombieBattleground::Api.cards_by_rank(rank: "COMMANDER")
+        #   cards = ZombieBattleground::Api.cards_by_rank("COMMANDER")
         #   # => [ZombieBattleground::Api::Models::Card]
         #
         # @api public
-        def cards_by_rank(rank:)
+        def cards_by_rank(rank)
           all_cards(rank: rank).to_a
         end
 
@@ -159,14 +175,30 @@ module ZombieBattleground
         # @return [Array<ZombieBattleground::Api::Models::Card>]
         #
         # @example
-        #   cards = ZombieBattleground::Api.cards_by_set(set: "WATER")
+        #   cards = ZombieBattleground::Api.cards_by_set("WATER")
         #   # => [ZombieBattleground::Api::Models::Card]
         #
         # @api public
-        def cards_by_set(set:)
+        def cards_by_set(set)
           all_cards(set: set).to_a
         end
 
+        ##
+        # Fetches all cards with selected faction
+        #
+        # @param faction [String]
+        #
+        # @return [Array<ZombieBattleground::Api::Models::Card>]
+        #
+        # @example
+        #   cards = ZombieBattleground::Api.cards_by_faction("WATER")
+        #   # => [ZombieBattleground::Api::Models::Card]
+        #
+        # @api public
+        def cards_by_faction(faction)
+          all_cards(set: faction).to_a
+        end
+
         ##
         # Fetches all cards with selected type
         #
@@ -175,11 +207,11 @@ module ZombieBattleground
         # @return [Array<ZombieBattleground::Api::Models::Card>]
         #
         # @example
-        #   cards = ZombieBattleground::Api.cards_by_type(type: "WALKER")
+        #   cards = ZombieBattleground::Api.cards_by_type("WALKER")
         #   # => [ZombieBattleground::Api::Models::Card]
         #
         # @api public
-        def cards_by_type(type:)
+        def cards_by_type(type)
           all_cards(type: type).to_a
         end
 
@@ -191,13 +223,25 @@ module ZombieBattleground
         # @return [Array<ZombieBattleground::Api::Models::Card>]
         #
         # @example
-        #   cards = ZombieBattleground::Api.cards_by_rarity(rarity: "")
+        #   cards = ZombieBattleground::Api.cards_by_rarity("")
         #   # => [ZombieBattleground::Api::Models::Card]
         #
         # @api public
-        def cards_by_rarity(rarity:)
+        def cards_by_rarity(rarity)
           all_cards(rarity: rarity).to_a
         end
+
+        private
+
+        ##
+        # Loads the helper data for cards
+        #
+        # @return [Hash]
+        #
+        # @api private
+        def load_cards_data
+          @load_cards_data ||= YAML.safe_load(File.read(File.join(__dir__, 'cards.yml')))
+        end
       end
     end
   end

data/lib/zombie_battleground/api/extensions/cards.yml

@@ -0,0 +1,49 @@
+---
+
+# API doesn't provide an endpoint for enumerating card metadata
+
+# https://zombiebattleground.io/index.php/Type
+types:
+  - 'WALKER' # standard
+  - 'FERAL'  # haste
+  - 'HEAVY'  # taunt
+
+# Didn't find docs for these yet, duplicating what API is serving now
+kinds:
+  - 'CREATURE'
+  - 'SPELL'
+
+# https://zombiebattleground.io/index.php/Rank
+# implies rarity for creature cards
+ranks:
+  - 'MINION'
+  - 'OFFICER'
+  - 'GENERAL'
+  - 'COMMANDER'
+
+# Didn't find docs for these yet, duplicating what API is serving now
+sets:
+  - 'AIR'
+  - 'EARTH'
+  - 'FIRE'
+  - 'LIFE'
+  - 'TOXIC'
+  - 'WATER'
+  - 'ITEM'
+  - 'OTHERS'
+
+# https://zombiebattleground.io/index.php/Faction
+# factions are a subset of sets
+factions:
+  - 'AIR'
+  - 'EARTH'
+  - 'FIRE'
+  - 'LIFE'
+  - 'TOXIC'
+  - 'WATER'
+
+# https://zombiebattleground.io/index.php/File:Card_description.png
+# https://zombiebattleground.io/index.php/Rarity
+# This one is strange, API returns empty strings right now
+rarities:
+  - ''

data/lib/zombie_battleground/api/models/deck.rb

@@ -2,6 +2,7 @@
 
 require 'active_record'
 
+require 'zombie_battleground/api/constants'
 require 'zombie_battleground/api/validation_helper'
 require 'zombie_battleground/api/models/simple_card'
 
@@ -245,7 +246,23 @@ module ZombieBattleground
                     card.errors.size.zero?
 
             errors.add(:cards, 'cards must be an array of SimpleCard')
+            break
           end
+
+          cards_has_required_count
+        end
+
+        ##
+        # Validator for correct number of cards in deck
+        #
+        # @return [void]
+        #
+        # @api private
+        def cards_has_required_count
+          return if errors.messages.size.zero? &&
+                    cards.sum(&:amount) == DECK_REQUIRED_CARDS_COUNT
+
+          errors.add(:cards, 'cards must add up to 30')
         end
       end
     end

data/lib/zombie_battleground/api/responses/get_cards_response.rb

@@ -65,6 +65,18 @@ module ZombieBattleground
         # @api public
         attr_reader :cards
 
+        ##
+        # @!attribute [a] remove_invalid
+        # flag to remove objects in response that are invalid during validation
+        #
+        # @return [Boolean]
+        #
+        # @example
+        #   response.remove_invalid = true
+        #
+        # @api public
+        attr_accessor :remove_invalid
+
         validate :total_is_a_non_negative_integer
         validate :page_is_a_non_negative_integer
         validate :limit_is_a_non_negative_integer
@@ -110,6 +122,20 @@ module ZombieBattleground
             return
           end
 
+          if remove_invalid
+            remove_invalid_cards
+          else
+            cards_contains_valid_cards
+          end
+        end
+
+        ##
+        # Validator for cards in cards
+        #
+        # @return [void]
+        #
+        # @api private
+        def cards_contains_valid_cards
           @cards.each do |card|
             next if card.is_a?(ZombieBattleground::Api::Models::Card) &&
                     card.valid? &&
@@ -118,6 +144,20 @@ module ZombieBattleground
             errors.add(:cards, 'cards must be an array of Card')
           end
         end
+
+        ##
+        # Removes invalid vards from card
+        #
+        # @return [void]
+        #
+        # @api private
+        def remove_invalid_cards
+          @cards.select! do |card|
+            card.is_a?(ZombieBattleground::Api::Models::Card) &&
+              card.valid? &&
+              card.errors.size.zero?
+          end
+        end
       end
     end
   end

data/lib/zombie_battleground/api/responses/get_decks_response.rb

@@ -65,6 +65,18 @@ module ZombieBattleground
         # @api public
         attr_reader :decks
 
+        ##
+        # @!attribute [a] remove_invalid
+        # flag to remove objects in response that are invalid during validation
+        #
+        # @return [Boolean]
+        #
+        # @example
+        #   response.remove_invalid = true
+        #
+        # @api public
+        attr_accessor :remove_invalid
+
         validate :total_is_a_non_negative_integer
         validate :page_is_a_non_negative_integer
         validate :limit_is_a_non_negative_integer
@@ -110,6 +122,20 @@ module ZombieBattleground
             return
           end
 
+          if remove_invalid
+            remove_invalid_decks
+          else
+            decks_contains_valid_decks
+          end
+        end
+
+        ##
+        # Validator for decks in decks
+        #
+        # @return [void]
+        #
+        # @api private
+        def decks_contains_valid_decks
           @decks.each do |deck|
             next if deck.is_a?(ZombieBattleground::Api::Models::Deck) &&
                     deck.valid? &&
@@ -118,6 +144,20 @@ module ZombieBattleground
             errors.add(:decks, 'decks must be an array of Deck')
           end
         end
+
+        ##
+        # Removes invalid vards from deck
+        #
+        # @return [void]
+        #
+        # @api private
+        def remove_invalid_decks
+          @decks.select! do |deck|
+            deck.is_a?(ZombieBattleground::Api::Models::Deck) &&
+              deck.valid? &&
+              deck.errors.size.zero?
+          end
+        end
       end
     end
   end

data/lib/zombie_battleground/api/responses/get_matches_response.rb

@@ -65,6 +65,18 @@ module ZombieBattleground
         # @api public
         attr_reader :matches
 
+        ##
+        # @!attribute [a] remove_invalid
+        # flag to remove objects in response that are invalid during validation
+        #
+        # @return [Boolean]
+        #
+        # @example
+        #   response.remove_invalid = true
+        #
+        # @api public
+        attr_accessor :remove_invalid
+
         validate :total_is_a_non_negative_integer
         validate :page_is_a_non_negative_integer
         validate :limit_is_a_non_negative_integer
@@ -110,6 +122,20 @@ module ZombieBattleground
             return
           end
 
+          if remove_invalid
+            remove_invalid_matches
+          else
+            matches_contains_valid_matches
+          end
+        end
+
+        ##
+        # Validator for matches in matches
+        #
+        # @return [void]
+        #
+        # @api private
+        def matches_contains_valid_matches
           @matches.each do |match|
             next if match.is_a?(ZombieBattleground::Api::Models::Match) &&
                     match.valid? &&
@@ -118,6 +144,20 @@ module ZombieBattleground
             errors.add(:matches, 'matches must be an array of Match')
           end
         end
+
+        ##
+        # Removes invalid vards from match
+        #
+        # @return [void]
+        #
+        # @api private
+        def remove_invalid_matches
+          @matches.select! do |match|
+            match.is_a?(ZombieBattleground::Api::Models::Match) &&
+              match.valid? &&
+              match.errors.size.zero?
+          end
+        end
       end
     end
   end

data/lib/zombie_battleground/api/version.rb

@@ -6,6 +6,6 @@ module ZombieBattleground
   class Api
     ##
     # Verion of the Gem
-    VERSION = '0.4.1'
+    VERSION = '0.5.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zombie_battleground-api
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
 - John Shields
@@ -247,6 +247,7 @@ files:
 - lib/zombie_battleground/api/errors.rb
 - lib/zombie_battleground/api/extensions.rb
 - lib/zombie_battleground/api/extensions/cards.rb
+- lib/zombie_battleground/api/extensions/cards.yml
 - lib/zombie_battleground/api/models/card.rb
 - lib/zombie_battleground/api/models/deck.rb
 - lib/zombie_battleground/api/models/match.rb