blizzard_api 0.3.9 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5d910aea832e66b20ed9e420baebbcefebe57081193f4854c550219a1f387dc
-  data.tar.gz: 965b558298098d263f75cc8e1089ac0a2c1168de22c5cab05bbd2a4bf0a30846
+  metadata.gz: 79f0c2964787e385ec480a01f0286a455a5869b7d6d3e9d8f4f46b9ac0bd98b6
+  data.tar.gz: c79b59fb2862b32e325240159a8d7dc08199c4f6f9fb3c060df4d73016de414d
 SHA512:
-  metadata.gz: 0bf1e876ad1ad3021265b25bec50a6c3f92ab4decaf9ae8e5d94294443684c7fa2b31e57477c1a95c35e7484c76020b1811c82a49e36205fac5705fa7ff93f3c
-  data.tar.gz: c0a6e645caa3d90ff9db00e4724c244f1a3c99bef0284fca8e98d6224a8dffedd13d5660a7a70a94e37b7644a5c572b6cc329886e18522f84ef29d3a9dab306d
+  metadata.gz: a425ba4f7b554a3381f7fb588650ff4525320da241c5f10c21e472bd8ef982659929bce064eb19c107b0b7ccabd1702d215fbbb256024e2be2a0cad7913110d0
+  data.tar.gz: b8d2b32b759989fd5f7d2a129b9cb2e6c5b23d06e1ea5bbaa9159a7c65bc1d771fbfd3fb782260950553d2c0feaaeca748567e0db4337357c9e9ac0135b7f8de

data/.rubocop.yml

@@ -1,6 +1,6 @@
 inherit_from: .rubocop_todo.yml
 
-Metrics/LineLength:
+Layout/LineLength:
   Max: 140
 
 Metrics/ModuleLength:
@@ -12,6 +12,7 @@ Metrics/AbcSize:
 
 AllCops:
   TargetRubyVersion: 2.5
+  NewCops: enable
   Exclude:
     - 'vendor/**/*'
     - 'bin/**/*'

data/CHANGELOG.md

@@ -1,5 +1,70 @@
 Please view this file on the master branch, otherwise it may be outdated
 
+**Version 0.5.0**
+
+This version brings a lot of internal changes to the way the gem works. While
+there no breaking change is expected use it carefully.
+
+## New features:
+
+### Extended mode
+
+When creating a request you can now specify **mode** as the last argument. Available modes:
+* **regular**: No changes, should work as it always did.
+* **extended**: All requests now return an array with two objects, the actual HTTPResponse object and the usual Hash.
+
+```ruby
+api_client = BlizzardApi::Wow::Item.new 'us', :extended
+response, item_data = api_client.get 35_000
+
+puts response.code # 200
+puts item_data[:name][:en_US] # Brutal Gladiator's Dragonhide Legguards
+```
+
+This is intended to expose the response code and headers.
+
+**Important**: Extended mode completely disables the cache.
+
+### Custom headers
+
+You an now pass custom headers in the **options** hash.
+
+There is also a new shorthand for the `If-Modified-Since` header.
+
+```ruby
+# If-Modified-Since shorhand
+auction_data = BlizzardApi::Wow.auction.get 1146, since: DateTime.parse('2099-01-01Z')
+
+# Using custom headers
+auction_data = BlizzardApi::Wow.auction.get 1146, headers: { 'If-Modified-Since' => 'Sun, 27 Sep 2020 02:17:03 GMT' }
+```
+
+**Important**
+* Headers are not part of the cache key, use the option `ignore_cache: true` when needed.
+* The `since` shorthand will always disable the cache.
+
+**Version 0.4.2**
+
+Added new retail and classic search endpoints described here: https://us.forums.blizzard.com/en/blizzard/t/world-of-warcraft-api-patch-notes-20200708/10310
+
+**Version 0.4.1**
+
+Added new retail and classic endpoints described here: https://us.forums.blizzard.com/en/blizzard/t/world-of-warcraft-api-patch-notes-20200609/8902
+
+**Version 0.4.0**
+
+Added support to searchable endpoints
+
+https://develop.battle.net/documentation/world-of-warcraft/guides/search
+
+**Version 0.3.11**
+
+Fixed D3 item URL.
+
+**Version 0.3.10**
+
+Really fixed D3 profile URLs this time.
+
 **Version 0.3.9**
 
 Fix D3 profile URLs.

data/Gemfile.lock

@@ -1,39 +1,48 @@
 PATH
   remote: .
   specs:
-    blizzard_api (0.3.9)
+    blizzard_api (0.5.0)
       redis (~> 4.1, >= 4.1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    ast (2.4.0)
-    jaro_winkler (1.5.3)
-    minitest (5.11.3)
-    parallel (1.17.0)
-    parser (2.6.3.0)
-      ast (~> 2.4.0)
+    ast (2.4.1)
+    dotenv (2.7.6)
+    minitest (5.14.2)
+    parallel (1.19.2)
+    parser (2.7.1.5)
+      ast (~> 2.4.1)
     rainbow (3.0.0)
     rake (13.0.1)
-    redis (4.1.3)
-    rubocop (0.74.0)
-      jaro_winkler (~> 1.5.1)
+    redis (4.2.2)
+    regexp_parser (1.8.0)
+    rexml (3.2.4)
+    rubocop (0.92.0)
       parallel (~> 1.10)
-      parser (>= 2.6)
+      parser (>= 2.7.1.5)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.7)
+      rexml
+      rubocop-ast (>= 0.5.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (0.6.0)
+      parser (>= 2.7.1.5)
     ruby-progressbar (1.10.1)
-    unicode-display_width (1.6.0)
+    unicode-display_width (1.7.0)
+    yard (0.9.25)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
   blizzard_api!
+  dotenv
   minitest (~> 5.0)
   rake (~> 13.0)
   rubocop (~> 0.61)
+  yard
 
 BUNDLED WITH
-   2.1.2
+   2.1.4

data/README.md

@@ -73,6 +73,46 @@ Most **data** endpoints will have always 3 methods available `index`, `get` and
 * `get` is used to get all information about a entry of the index returned data. It receives an id or slug as the first parameter, that depends on the endpoint.
 * `complete` is a complete information of all items listed in index. **This may perform various calls to the blizzard api** only use if you really need all information.
 
+### 3.1 Searchable endpoints
+
+Some endpoints support search filters. To perform a search you can use the following formats:
+
+
+To use the **or** operator you may pass an array of values as argument to `where` or `where_not` methods.
+```ruby
+realm = BlizzardApi::Wow.realm
+realm_data = realm.search(1, 100) do |options|
+  options.where 'name.en_US', %w[Azralon Nemesis]
+end
+```
+ 
+To use the **and** operator you may call `where` or `where_not` multiple times methods.
+```ruby
+realm = BlizzardApi::Wow.realm
+realm_data = realm.search(1, 100) do |options|
+  options.where 'name.en_US', 'Azralon'
+  options.where 'id', 3209
+end
+```
+
+To use the **range** operator you may pass a hash to `where` or `where_not`.
+```ruby
+realm = BlizzardApi::Wow.realm
+realm_data = realm.search(1, 100) do |options|
+  options.where 'id', min: 3209, max: 4000, mode: :exclusive
+end
+```
+*Note*: If you don't pass the `mode` key as `:exclusive` it will be `:inclusive` by default.
+
+To **sort** fields you may call the `order_by` method multiple times:
+```ruby
+realm = BlizzardApi::Wow.realm
+realm_data = realm.search(1, 100) do |options|
+  options.where 'id', min: 3209, max: 4000, mode: :exclusive
+  options.order_by 'id', :desc
+end
+```
+
 ## 4. Available endpoints
 
 **Hint**: All methods support an additional optional hash parameter that allows you to override the following configurations for a single call:
@@ -105,6 +145,7 @@ Most **data** endpoints will have always 3 methods available `index`, `get` and
   - types
   - type :id
   - display_media :id
+  - search
 * Blizzard::Wow::Guild
   - rewards
   - perks
@@ -171,6 +212,7 @@ Most **data** endpoints will have always 3 methods available `index`, `get` and
   - get :id
   - complete
   - status :realms
+  - search
 * Blizzard::Wow::Region
   - index
   - get :id
@@ -191,10 +233,12 @@ Most **data** endpoints will have always 3 methods available `index`, `get` and
   - class :id
   - subclass :class_id, :subclass_id
   - media :id
+  - search
 * Blizzard::Wow::AzeriteEssence
   - index
   - get :id
   - media :id
+  - search
 * Blizzard::Wow::ReputationTier
   - index
   - get :id
@@ -222,6 +266,7 @@ Most **data** endpoints will have always 3 methods available `index`, `get` and
   - get :id
 * Blizzard::Wow::Spell
   - get :id
+  - search
 * Blizzard::Wow::Zone
   - index
   - get :id

data/blizzard_api.gemspec

@@ -34,7 +34,9 @@ Gem::Specification.new do |spec|
 
   spec.add_runtime_dependency 'redis', '~> 4.1', '>= 4.1.0'
 
+  spec.add_development_dependency 'dotenv'
   spec.add_development_dependency 'minitest', '~> 5.0'
   spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rubocop', '~> 0.61'
+  spec.add_development_dependency 'yard'
 end

data/lib/blizzard_api/diablo/community/item.rb

@@ -13,13 +13,12 @@ module BlizzardApi
       ##
       # Return information about an item
       #
-      # @param item_slug [String] Item slug
-      # @param item_id [Integer] Item id
+      # @param item_slug_and_id [String] Item slug
       # @!macro request_options
       #
       # @!macro response
-      def get(item_slug, item_id, options = {})
-        api_request "#{base_url(:community)}/data/item/#{item_slug}-#{item_id}", { ttl: CACHE_TRIMESTER }.merge(options)
+      def get(item_slug_and_id, options = {})
+        api_request "#{base_url(:community)}/data/item/#{item_slug_and_id}", { ttl: CACHE_TRIMESTER }.merge(options)
       end
     end
   end

data/lib/blizzard_api/diablo/community/profile.rb

@@ -22,7 +22,7 @@ module BlizzardApi
       # @see https://develop.battle.net/documentation/guides/using-oauth/authorization-code-flow
       def index(battletag, oauth_token, options = {})
         opts = { access_token: oauth_token, ttl: CACHE_TRIMESTER }.merge(options)
-        api_request "#{base_url(:community)}/profile/#{parse_battle_tag(battletag)}", opts
+        api_request "#{base_url(:community)}/profile/#{parse_battle_tag(battletag)}/", opts
       end
 
       ##

data/lib/blizzard_api/diablo/game_data/generic_data_endpoint.rb

@@ -4,8 +4,8 @@ module BlizzardApi
   module Diablo
     # Generic endpoint to support most data requests with minor configurations
     class GenericDataEndpoint < Diablo::Request
-      def initialize(region = nil)
-        super region
+      def initialize(region = nil, mode = :regular)
+        super region, mode
         endpoint_setup
         @ttl ||= CACHE_DAY
       end

data/lib/blizzard_api/diablo/request.rb

@@ -6,8 +6,8 @@ module BlizzardApi
     class Request < BlizzardApi::Request
       ##
       # @!macro regions
-      def initialize(region = nil)
-        super region
+      def initialize(region = nil, mode = :regular)
+        super region, mode
         @game = 'd3'
       end
     end

data/lib/blizzard_api/hearthstone/game_data/generic_data_endpoint.rb

@@ -4,8 +4,8 @@ module BlizzardApi
   module Hearthstone
     # Generic endpoint to support most data requests with minor configurations
     class GenericDataEndpoint < Hearthstone::Request
-      def initialize(region = nil)
-        super region
+      def initialize(region = nil, mode = :regular)
+        super region, mode
         endpoint_setup
         @ttl ||= CACHE_DAY
       end

data/lib/blizzard_api/hearthstone/request.rb

@@ -6,8 +6,8 @@ module BlizzardApi
     class Request < BlizzardApi::Request
       ##
       # @!macro regions
-      def initialize(region = nil)
-        super region
+      def initialize(region = nil, mode = :regular)
+        super region, mode
         @game = 'hearthstone'
       end
     end

data/lib/blizzard_api/request.rb

@@ -8,6 +8,7 @@
 #   @option options [String] :access_token Overrides the access_token for a single call
 #   @option options [Boolean] :ignore_cache If set to true the request will not use the cache
 #   @option options [Integer] :ttl Override the default time (in seconds) a request should be cached
+#   @option options [DateTime] :since Adds the If-modified-since headers. Will always ignore cache when set.
 
 ##
 # @!macro [new] regions
@@ -31,18 +32,12 @@ module BlizzardApi
   ##
   # Simplifies the requests to Blizzard APIS
   class Request
-    # One minute cache
-    CACHE_MINUTE = 60
     # One hour cache
-    CACHE_HOUR = 60 * CACHE_MINUTE
+    CACHE_HOUR = 3600
     # One day cache
     CACHE_DAY = 24 * CACHE_HOUR
-    # One week cache
-    CACHE_WEEK = CACHE_DAY * 7
-    # One (commercial) month cache
-    CACHE_MONTH = CACHE_DAY * 30
     # Three (commercial) months cache
-    CACHE_TRIMESTER = CACHE_MONTH * 3
+    CACHE_TRIMESTER = CACHE_DAY * 90
 
     # Common endpoints
     BASE_URLS = {
@@ -50,7 +45,8 @@ module BlizzardApi
       community: 'https://%s.api.blizzard.com/%s',
       profile: 'https://%s.api.blizzard.com/profile/%s',
       media: 'https://%s.api.blizzard.com/data/%s/media',
-      user_profile: 'https://%s.api.blizzard.com/profile/user/%s'
+      user_profile: 'https://%s.api.blizzard.com/profile/user/%s',
+      search: 'https://%s.api.blizzard.com/data/%s/search'
     }.freeze
 
     ##
@@ -58,13 +54,20 @@ module BlizzardApi
     #   @return [String] Api region
     attr_accessor :region
 
+    ##
+    # @!attribute mode
+    #   @return [:regular, :extended]
+    attr_accessor :mode
+
     ##
     # @!macro regions
-    def initialize(region = nil)
+    def initialize(region = nil, mode = :regular)
       self.region = region || BlizzardApi.region
       @redis = Redis.new(host: BlizzardApi.redis_host, port: BlizzardApi.redis_port) if BlizzardApi.use_cache
       # Use the shared access_token, or create one if it doesn't exists. This avoids unnecessary calls to create tokens.
       @access_token = BlizzardApi.access_token || create_access_token
+      # Mode
+      @mode = mode
     end
 
     require 'net/http'
@@ -87,7 +90,7 @@ module BlizzardApi
     def endpoint_namespace(options)
       case options[:namespace]
       when :dynamic
-        "dynamic-#{region}"
+        options.include?(:classic) ? "dynamic-classic-#{region}" : "dynamic-#{region}"
       when :static
         options.include?(:classic) ? "static-classic-#{region}" : "static-#{region}"
       when :profile
@@ -97,10 +100,6 @@ module BlizzardApi
       end
     end
 
-    def string_to_slug(string)
-      CGI.escape(string.downcase.tr(' ', '-'))
-    end
-
     def create_access_token
       uri = URI.parse("https://#{BlizzardApi.region}.battle.net/oauth/token")
 
@@ -120,26 +119,24 @@ module BlizzardApi
       # Creates the whole url for request
       parsed_url = URI.parse(url)
 
-      data = options[:ignore_cache] ? nil : find_in_cache(parsed_url.to_s)
+      data = using_cache?(options) ? find_in_cache(parsed_url.to_s) : nil
+
       # If data was found that means cache is enabled and valid
-      return format_response data if data
+      return JSON.parse(data, symbolize_names: true) if data
 
-      # Override access_token
-      @access_token = options[:access_token] if options.include? :access_token
+      response = consume_api parsed_url, options
 
-      response = consume_api parsed_url
+      save_in_cache parsed_url.to_s, response.body, options[:ttl] || CACHE_DAY if using_cache? options
 
-      unless options[:ignore_cache]
-        ttl = options[:ttl] || CACHE_DAY
-        save_in_cache parsed_url.to_s, response.body, ttl
-      end
+      response_data = response.code.to_i.eql?(304) ? nil : JSON.parse(response.body, symbolize_names: true)
+      return [response, response_data] if mode.eql? :extended
 
-      format_response response.body
+      response_data
     end
 
     def api_request(uri, query_string = {})
       # List of request options
-      options_key = %i[ignore_cache ttl format access_token namespace classic]
+      options_key = %i[ignore_cache ttl format access_token namespace classic headers since]
 
       # Separates request options from api fields and options. Any user-defined option will be treated as api field.
       options = query_string.select { |k, _v| query_string.delete(k) || true if options_key.include? k }
@@ -158,35 +155,46 @@ module BlizzardApi
 
     private
 
-    def consume_api(url)
+    ##
+    # @param options [Hash] Request options
+    def using_cache?(options)
+      return false if mode.eql?(:extended) || options.key?(:since)
+
+      !options.fetch(:ignore_cache, false)
+    end
+
+    def consume_api(url, options = {})
       # Creates a HTTP connection and request to ensure thread safety
       http = Net::HTTP.new(url.host, url.port)
       http.use_ssl = true
       request = Net::HTTP::Get.new(url)
 
-      # Blizzard API documentation states the preferred way to send the access_token is using Bearer token on header
-      request['Authorization'] = "Bearer #{@access_token}"
+      add_headers request, options
 
       # Executes the request
       http.request(request).tap do |response|
-        raise BlizzardApi::ApiException.new 'Request failed', response.code.to_i unless response.code.to_i == 200
+        if mode.eql?(:regular) && ![200, 304].include?(response.code.to_i)
+          raise BlizzardApi::ApiException.new 'Request failed', response.code.to_i
+        end
       end
     end
 
-    def save_in_cache(resource_url, data, ttl)
-      return nil unless BlizzardApi.use_cache
+    def add_headers(request, options)
+      # Blizzard API documentation states the preferred way to send the access_token is using Bearer token on header
+      request['Authorization'] = "Bearer #{options.fetch(:access_token, @access_token)}"
+      # Format If-modified-since option
+      request['If-Modified-Since'] = options[:since].httpdate if options.key? :since
+      options[:headers]&.each { |header, content| request[header] = content }
+    end
 
-      @redis.setex resource_url, ttl, data
+    def save_in_cache(resource_url, data, ttl)
+      @redis.setex resource_url, ttl, data if BlizzardApi.use_cache
     end
 
     def find_in_cache(resource_url)
       return false unless BlizzardApi.use_cache
 
-      @redis.get resource_url if @redis.exists resource_url
-    end
-
-    def format_response(data)
-      JSON.parse(data, symbolize_names: true)
+      @redis.get resource_url if @redis.exists? resource_url
     end
   end
 end

data/lib/blizzard_api/starcraft/request.rb

@@ -15,8 +15,8 @@ module BlizzardApi
 
       ##
       # @!macro regions
-      def initialize(region = nil)
-        super region
+      def initialize(region = nil, mode = :regular)
+        super region, mode
         @game = 'sc2'
       end
 

data/lib/blizzard_api/version.rb

@@ -2,5 +2,5 @@
 
 module BlizzardApi
   # Gem version
-  VERSION = '0.3.9'
+  VERSION = '0.5.0'
 end

data/lib/blizzard_api/wow.rb

@@ -5,6 +5,9 @@ module BlizzardApi
   module Wow
     require_relative 'wow/request'
     require_relative 'wow/game_data/generic_data_endpoint'
+    require_relative 'wow/search/search_composer'
+    require_relative 'wow/search/search_request'
+    require_relative 'wow/slug'
 
     # WoW data api
     require_relative 'wow/game_data/achievement'
@@ -15,6 +18,7 @@ module BlizzardApi
     require_relative 'wow/game_data/guild_crest'
     require_relative 'wow/game_data/item'
     require_relative 'wow/game_data/journal'
+    require_relative 'wow/game_data/media'
     require_relative 'wow/game_data/mount'
     require_relative 'wow/game_data/mythic_keystone_affix'
     require_relative 'wow/game_data/mythic_keystone'
@@ -93,6 +97,13 @@ module BlizzardApi
       BlizzardApi::Wow::Journal.new(region)
     end
 
+    ##
+    # @param region [String] API Region
+    # @return {Media}
+    def self.media(region = BlizzardApi.region)
+      BlizzardApi::Wow::Media.new(region)
+    end
+
     ##
     # @param region [String] API Region
     # @return {Mount}

data/lib/blizzard_api/wow/game_data/azerite_essence.rb

@@ -10,6 +10,8 @@ module BlizzardApi
     # You can get an instance of this class using the default region as follows:
     #   api_instance = BlizzardApi::Wow.azerite_essence
     class AzeriteEssence < Wow::GenericDataEndpoint
+      include BlizzardApi::Wow::Searchable
+
       ##
       # Fetch media for one of the azerite essences listed by the {#index} using its *id*
       #

data/lib/blizzard_api/wow/game_data/connected_realm.rb

@@ -10,6 +10,8 @@ module BlizzardApi
     # You can get an instance of this class using the default region as follows:
     #   api_instance = BlizzardApi::Wow.connected_realm
     class ConnectedRealm < Wow::GenericDataEndpoint
+      include BlizzardApi::Wow::Searchable
+
       protected
 
       def endpoint_setup

data/lib/blizzard_api/wow/game_data/creature.rb

@@ -10,6 +10,8 @@ module BlizzardApi
     # You can get an instance of this class using the default region as follows:
     #   api_instance = BlizzardApi::Wow.creature
     class Creature < Wow::GenericDataEndpoint
+      include BlizzardApi::Wow::Searchable
+
       def index
         raise BlizzardApi::ApiException, 'Creatures endpoint doesn\'t have a index method'
       end

data/lib/blizzard_api/wow/game_data/generic_data_endpoint.rb

@@ -7,8 +7,8 @@ module BlizzardApi
     class GenericDataEndpoint < Wow::Request
       ##
       # @!macro regions
-      def initialize(region = nil)
-        super region
+      def initialize(region = nil, mode = :regular)
+        super region, mode
         endpoint_setup
         @ttl ||= CACHE_DAY
       end
@@ -48,9 +48,9 @@ module BlizzardApi
 
       protected
 
-      def endpoint_uri(variant = nil)
+      def endpoint_uri(variant = nil, scope = :game_data)
         endpoint = variant ? "#{@endpoint}-#{variant}" : @endpoint
-        "#{base_url(:game_data)}/#{endpoint}"
+        "#{base_url(scope)}/#{endpoint}"
       end
 
       def endpoint_setup

data/lib/blizzard_api/wow/game_data/item.rb

@@ -10,6 +10,8 @@ module BlizzardApi
     # You can get an instance of this class using the default region as follows:
     #   api_instance = BlizzardApi::Wow.item
     class Item < Wow::GenericDataEndpoint
+      include BlizzardApi::Wow::Searchable
+
       ##
       # This method overrides the inherited default behavior to prevent high server load and fetch time
       #

data/lib/blizzard_api/wow/game_data/journal.rb

@@ -97,6 +97,21 @@ module BlizzardApi
         api_request "#{endpoint_uri('encounter')}/#{id}", default_options.merge(options)
       end
 
+      ##
+      # Fetch data base on search criteria
+      #
+      # @param page [Integer] Page o return
+      # @param page_size [Integer] Amount of items per page
+      #
+      # @!macro request_options
+      # @!macro response
+      def encounter_search(page = 1, page_size = 100, options = {})
+        search_options = SearchComposer.new(page, page_size)
+        yield search_options if block_given?
+
+        api_request "#{endpoint_uri('encounter', :search)}?#{search_options.to_search_query}", default_options.merge(options)
+      end
+
       protected
 
       def endpoint_setup

data/lib/blizzard_api/wow/game_data/media.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module BlizzardApi
+  module Wow
+    ##
+    # This class allows access to World of Warcraft mounts
+    #
+    # @see https://develop.battle.net/documentation/api-reference/world-of-warcraft-game-data-api
+    #
+    # You can get an instance of this class using the default region as follows:
+    #   api_instance = BlizzardApi::Wow.mount
+    class Media < Wow::GenericDataEndpoint
+      include BlizzardApi::Wow::Searchable
+
+      def index(_options = nil)
+        raise BlizzardApi::ApiException, 'This endpoint does not have a index method'
+      end
+
+      def get(_options = nil)
+        raise BlizzardApi::ApiException, 'This endpoint does not have a get method'
+      end
+
+      def complete(_options = nil)
+        raise BlizzardApi::ApiException, 'This endpoint does not have a complete method'
+      end
+
+      protected
+
+      def endpoint_setup
+        @endpoint = 'media'
+        @namespace = :static
+        @collection = 'medias'
+        @ttl = CACHE_TRIMESTER
+      end
+    end
+  end
+end

data/lib/blizzard_api/wow/game_data/mount.rb

@@ -10,6 +10,8 @@ module BlizzardApi
     # You can get an instance of this class using the default region as follows:
     #   api_instance = BlizzardApi::Wow.mount
     class Mount < Wow::GenericDataEndpoint
+      include BlizzardApi::Wow::Searchable
+
       protected
 
       def endpoint_setup

data/lib/blizzard_api/wow/game_data/pet.rb

@@ -10,6 +10,52 @@ module BlizzardApi
     # You can get an instance of this class using the default region as follows:
     #   api_instance = BlizzardApi::Wow.pet
     class Pet < Wow::GenericDataEndpoint
+      ##
+      # Fetch media for one of the pets listed by the {#index} using its *id*
+      #
+      # @param id [Integer] Pet id
+      #
+      # @!macro request_options
+      #
+      # @!macro response
+      def media(id, options = {})
+        api_request "#{base_url(:media)}/pet/#{id}", default_options.merge(options)
+      end
+
+      ##
+      # Fetch all pet abilities
+      #
+      # @!macro request_options
+      #
+      # @!macro response
+      def abilities(options = {})
+        api_request "#{endpoint_uri('ability')}/index", default_options.merge(options)
+      end
+
+      ##
+      # Fetch a pet ability
+      #
+      # @param id [Integer] Pet id
+      #
+      # @!macro request_options
+      #
+      # @!macro response
+      def ability(id, options = {})
+        api_request "#{endpoint_uri('ability')}/#{id}", default_options.merge(options)
+      end
+
+      ##
+      # Fetch media for one of the pet abilities listed by the {#abilities} using its *id*
+      #
+      # @param id [Integer] Pet ability id
+      #
+      # @!macro request_options
+      #
+      # @!macro response
+      def ability_media(id, options = {})
+        api_request "#{base_url(:media)}/pet-ability/#{id}", default_options.merge(options)
+      end
+
       protected
 
       def endpoint_setup

data/lib/blizzard_api/wow/game_data/realm.rb

@@ -10,6 +10,8 @@ module BlizzardApi
     # You can get an instance of this class using the default region as follows:
     #   api_instance = BlizzardApi::Wow.realm
     class Realm < Wow::GenericDataEndpoint
+      include BlizzardApi::Wow::Searchable
+
       protected
 
       def endpoint_setup

data/lib/blizzard_api/wow/game_data/spell.rb

@@ -10,6 +10,8 @@ module BlizzardApi
     # You can get an instance of this class using the default region as follows:
     #   api_instance = BlizzardApi::Wow.spell
     class Spell < Wow::GenericDataEndpoint
+      include BlizzardApi::Wow::Searchable
+
       ##
       # This method overrides the inherited default behavior to prevent high server load and fetch time
       #

data/lib/blizzard_api/wow/profile/character_profile.rb

@@ -10,6 +10,8 @@ module BlizzardApi
     # You can get an instance of this class using the default region as follows:
     #   api_instance = BlizzardApi::Wow.achievement
     class CharacterProfile < Wow::Request
+      include BlizzardApi::Wow::Slug
+
       ##
       # Return character achievements
       #
@@ -287,9 +289,11 @@ module BlizzardApi
       # @param realm [String] The character realm's slug
       # @param character [String] The character name
       # @!macro request_options
+      #   @option options [Boolean] :completed Should return completed quests
       #
       # @!macro response
-      def quests(realm, character, completed = false, options = {})
+      def quests(realm, character, options = {})
+        completed = options.delete(:completed) || false
         return character_request realm, character, options, 'quests/completed' if completed
 
         character_request realm, character, options, 'quests'

data/lib/blizzard_api/wow/profile/guild.rb

@@ -10,6 +10,8 @@ module BlizzardApi
     # You can get an instance of this class using the default region as follows:
     #   api_instance = BlizzardApi::Wow.guild
     class Guild < Wow::Request
+      include BlizzardApi::Wow::Slug
+
       ##
       # Return data about the specified guild
       #

data/lib/blizzard_api/wow/profile/profile.rb

@@ -7,8 +7,8 @@ module BlizzardApi
     class AccountProfile < Request
       ##
       # @param token [String] A token obtained using the authorization_code flow
-      def initialize(token, region = nil)
-        super region
+      def initialize(token, region = nil, mode = :regular)
+        super region, mode
         @token = token
       end
 

data/lib/blizzard_api/wow/request.rb

@@ -7,8 +7,8 @@ module BlizzardApi
     class Request < BlizzardApi::Request
       ##
       # @!macro regions
-      def initialize(region = nil)
-        super region
+      def initialize(region = nil, mode = :regular)
+        super region, mode
         @game = 'wow'
       end
     end

data/lib/blizzard_api/wow/search/search_composer.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module BlizzardApi
+  module Wow
+    ##
+    # Composer for search endpoint arguments
+    class SearchComposer
+      attr_accessor :fields, :order, :page, :page_size
+
+      def initialize(page, page_size)
+        self.page = page
+        self.page_size = page_size
+        self.fields = []
+        self.order = []
+      end
+
+      ##
+      # Add a search field
+      #
+      # The second argument takes a simple value, an array of values or a hash for range searches.
+      #
+      # @param field [String] Field name
+      # @param value [String|Integer|Hash|Array<Integer>|Array<String>]
+      # @option value [Integer] :min Range start
+      # @option value [Integer] :max Range end
+      # @option value [Integer] :mode Range mode (:inclusive|:exclusive)
+      #
+      # @return {SearchComposer}
+      def where(field, value)
+        fields.push "#{field}=#{resolve_value(value)}"
+        self
+      end
+
+      ##
+      # Add a search field
+      #
+      # The second argument takes a simple value, an array of values or a hash for range searches.
+      #
+      # @param field [String] Field name
+      # @param value [String|Integer|Hash|Array<Integer>|Array<String>]
+      # @option value [Integer] :min Range start
+      # @option value [Integer] :max Range end
+      # @option value [Integer] :mode Range mode (:inclusive|:exclusive)
+      #
+      # @return {SearchComposer}
+      def where_not(field, value)
+        fields.push "#{field}!=#{resolve_value(value)}"
+        self
+      end
+
+      ##
+      # Add a sort field
+      #
+      # @param field [String] Field name
+      # @param mode [Symbol] :asc or :desc
+      #
+      # @return {SearchComposer}
+      def order_by(field, mode = :asc)
+        raise ArgumentError, 'Invalid order mode.' unless %i[asc desc].include? mode
+
+        order.push "#{field}:#{mode}"
+        self
+      end
+
+      ##
+      # Returns a valid queryString based on the options
+      #
+      # @return {String}
+      def to_search_query
+        query_string = "_page=#{page}&_pageSize=#{page_size}"
+        query_string += "&#{fields.join('&')}" unless fields.size.zero?
+        query_string += "&orderby=#{order.join(',')}" unless order.size.zero?
+        query_string
+      end
+
+      protected
+
+      def resolve_value(value)
+        return value.join '||' if value.is_a? Array
+
+        return value.to_s unless value.is_a? Hash
+
+        resolve_hash value
+      end
+
+      def resolve_hash(value)
+        min = value.key?(:min) ? value[:min] : ''
+        max = value.key?(:max) ? value[:max] : ''
+        mode = value.key?(:mode) ? value[:mode] : :inclusive
+
+        return "[#{min},#{max}]" if mode.eql? :inclusive
+
+        "(#{min},#{max})"
+      end
+    end
+  end
+end

data/lib/blizzard_api/wow/search/search_request.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module BlizzardApi
+  module Wow
+    ##
+    # Added search support to an endpoint
+    module Searchable
+      ##
+      # Fetch data based on search criteria
+      #
+      # @param page [Integer] Page o return
+      # @param page_size [Integer] Amount of items per page
+      #
+      # @!macro request_options
+      # @!macro response
+      def search(page = 1, page_size = 100, options = {})
+        search_options = SearchComposer.new(page, page_size)
+        yield search_options if block_given?
+
+        api_request "#{endpoint_uri(nil, :search)}?#{search_options.to_search_query}", default_options.merge(options)
+      end
+    end
+  end
+end

data/lib/blizzard_api/wow/slug.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module BlizzardApi
+  module Wow
+    # Support for slugs
+    module Slug
+      def string_to_slug(string)
+        CGI.escape(string.downcase.tr(' ', '-'))
+      end
+    end
+  end
+end

metadata

@@ -1,35 +1,49 @@
 --- !ruby/object:Gem::Specification
 name: blizzard_api
 version: !ruby/object:Gem::Version
-  version: 0.3.9
+  version: 0.5.0
 platform: ruby
 authors:
 - Francis Schiavo
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-04-17 00:00:00.000000000 Z
+date: 2020-09-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redis
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 4.1.0
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
     - - ">="
       - !ruby/object:Gem::Version
         version: 4.1.0
-    - - "~>"
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '4.1'
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -72,6 +86,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.61'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: This is a simple interface to obtain data from Blizzard API
 email:
 - francis.schiavo@francisschiavo.com
@@ -132,6 +160,7 @@ files:
 - lib/blizzard_api/wow/game_data/guild_crest.rb
 - lib/blizzard_api/wow/game_data/item.rb
 - lib/blizzard_api/wow/game_data/journal.rb
+- lib/blizzard_api/wow/game_data/media.rb
 - lib/blizzard_api/wow/game_data/mount.rb
 - lib/blizzard_api/wow/game_data/mythic_keystone.rb
 - lib/blizzard_api/wow/game_data/mythic_keystone_affix.rb
@@ -157,6 +186,9 @@ files:
 - lib/blizzard_api/wow/profile/guild.rb
 - lib/blizzard_api/wow/profile/profile.rb
 - lib/blizzard_api/wow/request.rb
+- lib/blizzard_api/wow/search/search_composer.rb
+- lib/blizzard_api/wow/search/search_request.rb
+- lib/blizzard_api/wow/slug.rb
 homepage: https://gitlab.com/francisschiavo/blizzard_api
 licenses:
 - MIT
@@ -179,7 +211,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Unofficial Ruby client for Blizzard Entertainment API