algolia 2.3.4 → 3.0.0.alpha.2

data/lib/algolia/models/recommend/recommendations_request.rb

@@ -0,0 +1,98 @@
+# Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
+
+require 'date'
+require 'time'
+
+module Algolia
+  module Recommend
+    module RecommendationsRequest
+      class << self
+        # List of class defined in oneOf (OpenAPI v3)
+        def openapi_one_of
+          [
+            :RecommendationsQuery,
+            :RecommendedForYouQuery,
+            :TrendingFacetsQuery,
+            :TrendingItemsQuery
+          ]
+        end
+
+        # Builds the object
+        # @param [Mixed] Data to be matched against the list of oneOf items
+        # @return [Object] Returns the model or the data itself
+        def build(data)
+          # Go through the list of oneOf items and attempt to identify the appropriate one.
+          # Note:
+          # - We do not attempt to check whether exactly one item matches.
+          # - No advanced validation of types in some cases (e.g. "x: { type: string }" will happily match { x: 123 })
+          #   due to the way the deserialization is made in the base_object template (it just casts without verifying).
+          # - TODO: scalar values are de facto behaving as if they were nullable.
+          # - TODO: logging when debugging is set.
+          openapi_one_of.each do |klass|
+            next if klass == :AnyType # "nullable: true"
+
+            typed_data = find_and_cast_into_type(klass, data)
+            return typed_data if typed_data
+          rescue # rescue all errors so we keep iterating even if the current item lookup raises
+          end
+
+          openapi_one_of.include?(:AnyType) ? data : nil
+        end
+
+        private
+
+        SchemaMismatchError = Class.new(StandardError)
+
+        # NOTE: 'File' is missing here because in the regular case we get the data _after_ a call to JSON.parse.
+        def find_and_cast_into_type(klass, data)
+          return if data.nil?
+
+          case klass.to_s
+          when 'Boolean'
+            return data if data.instance_of?(TrueClass) || data.instance_of?(FalseClass)
+          when 'Float'
+            return data if data.instance_of?(Float)
+          when 'Integer'
+            return data if data.instance_of?(Integer)
+          when 'Time'
+            return Time.parse(data)
+          when 'Date'
+            return Date.parse(data)
+          when 'String'
+            return data if data.instance_of?(String)
+          when 'Object' # "type: object"
+            return data if data.instance_of?(Hash)
+          when /\AArray<(?<sub_type>.+)>\z/ # "type: array"
+            if data.instance_of?(Array)
+              sub_type = Regexp.last_match[:sub_type]
+              return data.map { |item| find_and_cast_into_type(sub_type, item) }
+            end
+          when /\AHash<String, (?<sub_type>.+)>\z/ # "type: object" with "additionalProperties: { ... }"
+            if data.instance_of?(Hash) && data.keys.all? { |k| k.instance_of?(Symbol) || k.instance_of?(String) }
+              sub_type = Regexp.last_match[:sub_type]
+              return data.each_with_object({}) { |(k, v), hsh| hsh[k] = find_and_cast_into_type(sub_type, v) }
+            end
+          else # model
+            const = Algolia.const_get(klass)
+            if const
+              if const.respond_to?(:openapi_one_of) # nested oneOf model
+                model = const.build(data)
+              else
+                # raise if data contains keys that are not known to the model
+                raise unless (data.keys - const.acceptable_attributes).empty?
+
+                model = const.build_from_hash(data)
+              end
+
+              return model if model
+            end
+          end
+
+          raise # if no match by now, raise
+        rescue
+          raise SchemaMismatchError, "#{data} doesn't match the #{klass} type"
+        end
+      end
+    end
+  end
+end

data/lib/algolia/models/recommend/recommendations_results.rb

@@ -0,0 +1,553 @@
+# Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
+
+require 'date'
+require 'time'
+
+module Algolia
+  module Recommend
+    class RecommendationsResults
+      # A/B test ID. This is only included in the response for indices that are part of an A/B test.
+      attr_accessor :ab_test_id
+
+      # Variant ID. This is only included in the response for indices that are part of an A/B test.
+      attr_accessor :ab_test_variant_id
+
+      # Computed geographical location.
+      attr_accessor :around_lat_lng
+
+      # Automatically-computed radius.
+      attr_accessor :automatic_radius
+
+      attr_accessor :exhaustive
+
+      # See the `facetsCount` field of the `exhaustive` object in the response.
+      attr_accessor :exhaustive_facets_count
+
+      # See the `nbHits` field of the `exhaustive` object in the response.
+      attr_accessor :exhaustive_nb_hits
+
+      # See the `typo` field of the `exhaustive` object in the response.
+      attr_accessor :exhaustive_typo
+
+      # Mapping of each facet name to the corresponding facet counts.
+      attr_accessor :facets
+
+      # Statistics for numerical facets.
+      attr_accessor :facets_stats
+
+      # Number of hits per page.
+      attr_accessor :hits_per_page
+
+      # Index name used for the query.
+      attr_accessor :index
+
+      # Index name used for the query. During A/B testing, the targeted index isn't always the index used by the query.
+      attr_accessor :index_used
+
+      # Warnings about the query.
+      attr_accessor :message
+
+      # Number of hits the search query matched.
+      attr_accessor :nb_hits
+
+      # Number of pages of results for the current query.
+      attr_accessor :nb_pages
+
+      # Number of hits selected and sorted by the relevant sort algorithm.
+      attr_accessor :nb_sorted_hits
+
+      # Page to retrieve (the first page is `0`, not `1`).
+      attr_accessor :page
+
+      # Post-[normalization](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/#what-does-normalization-mean) query string that will be searched.
+      attr_accessor :parsed_query
+
+      # Time the server took to process the request, in milliseconds.
+      attr_accessor :processing_time_ms
+
+      # Experimental. List of processing steps and their times, in milliseconds. You can use this list to investigate performance issues.
+      attr_accessor :processing_timings_ms
+
+      # Markup text indicating which parts of the original query have been removed to retrieve a non-empty result set.
+      attr_accessor :query_after_removal
+
+      attr_accessor :redirect
+
+      attr_accessor :rendering_content
+
+      # Time the server took to process the request, in milliseconds.
+      attr_accessor :server_time_ms
+
+      # Host name of the server that processed the request.
+      attr_accessor :server_used
+
+      # Lets you store custom data in your indices.
+      attr_accessor :user_data
+
+      attr_accessor :hits
+
+      # Text to search for in an index.
+      attr_accessor :query
+
+      # URL-encoded string of all search parameters.
+      attr_accessor :params
+
+      # Attribute mapping from ruby-style variable name to JSON key.
+      def self.attribute_map
+        {
+          :ab_test_id => :abTestID,
+          :ab_test_variant_id => :abTestVariantID,
+          :around_lat_lng => :aroundLatLng,
+          :automatic_radius => :automaticRadius,
+          :exhaustive => :exhaustive,
+          :exhaustive_facets_count => :exhaustiveFacetsCount,
+          :exhaustive_nb_hits => :exhaustiveNbHits,
+          :exhaustive_typo => :exhaustiveTypo,
+          :facets => :facets,
+          :facets_stats => :facets_stats,
+          :hits_per_page => :hitsPerPage,
+          :index => :index,
+          :index_used => :indexUsed,
+          :message => :message,
+          :nb_hits => :nbHits,
+          :nb_pages => :nbPages,
+          :nb_sorted_hits => :nbSortedHits,
+          :page => :page,
+          :parsed_query => :parsedQuery,
+          :processing_time_ms => :processingTimeMS,
+          :processing_timings_ms => :processingTimingsMS,
+          :query_after_removal => :queryAfterRemoval,
+          :redirect => :redirect,
+          :rendering_content => :renderingContent,
+          :server_time_ms => :serverTimeMS,
+          :server_used => :serverUsed,
+          :user_data => :userData,
+          :hits => :hits,
+          :query => :query,
+          :params => :params
+        }
+      end
+
+      # Returns all the JSON keys this model knows about
+      def self.acceptable_attributes
+        attribute_map.values
+      end
+
+      # Attribute type mapping.
+      def self.types_mapping
+        {
+          :ab_test_id => :Integer,
+          :ab_test_variant_id => :Integer,
+          :around_lat_lng => :String,
+          :automatic_radius => :String,
+          :exhaustive => :Exhaustive,
+          :exhaustive_facets_count => :Boolean,
+          :exhaustive_nb_hits => :Boolean,
+          :exhaustive_typo => :Boolean,
+          :facets => :'Hash<String, Hash<String, Integer>>',
+          :facets_stats => :'Hash<String, FacetsStats>',
+          :hits_per_page => :Integer,
+          :index => :String,
+          :index_used => :String,
+          :message => :String,
+          :nb_hits => :Integer,
+          :nb_pages => :Integer,
+          :nb_sorted_hits => :Integer,
+          :page => :Integer,
+          :parsed_query => :String,
+          :processing_time_ms => :Integer,
+          :processing_timings_ms => :Object,
+          :query_after_removal => :String,
+          :redirect => :Redirect,
+          :rendering_content => :RenderingContent,
+          :server_time_ms => :Integer,
+          :server_used => :String,
+          :user_data => :Object,
+          :hits => :'Array<RecommendationsHit>',
+          :query => :String,
+          :params => :String
+        }
+      end
+
+      # List of attributes with nullable: true
+      def self.openapi_nullable
+        Set.new([])
+      end
+
+      # List of class defined in allOf (OpenAPI v3)
+      def self.openapi_all_of
+        [
+          :BaseSearchResponse,
+          :RecommendationsHits
+        ]
+      end
+
+      # Initializes the object
+      # @param [Hash] attributes Model attributes in the form of hash
+      def initialize(attributes = {})
+        unless attributes.is_a?(Hash)
+          raise ArgumentError, "The input argument (attributes) must be a hash in `Algolia::RecommendationsResults` initialize method"
+        end
+
+        # check to see if the attribute exists and convert string to symbol for hash key
+        attributes = attributes.each_with_object({}) do |(k, v), h|
+          unless self.class.attribute_map.key?(k.to_sym)
+            raise ArgumentError,
+                  "`#{k}` is not a valid attribute in `Algolia::RecommendationsResults`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect
+          end
+
+          h[k.to_sym] = v
+        end
+
+        if attributes.key?(:ab_test_id)
+          self.ab_test_id = attributes[:ab_test_id]
+        end
+
+        if attributes.key?(:ab_test_variant_id)
+          self.ab_test_variant_id = attributes[:ab_test_variant_id]
+        end
+
+        if attributes.key?(:around_lat_lng)
+          self.around_lat_lng = attributes[:around_lat_lng]
+        end
+
+        if attributes.key?(:automatic_radius)
+          self.automatic_radius = attributes[:automatic_radius]
+        end
+
+        if attributes.key?(:exhaustive)
+          self.exhaustive = attributes[:exhaustive]
+        end
+
+        if attributes.key?(:exhaustive_facets_count)
+          self.exhaustive_facets_count = attributes[:exhaustive_facets_count]
+        end
+
+        if attributes.key?(:exhaustive_nb_hits)
+          self.exhaustive_nb_hits = attributes[:exhaustive_nb_hits]
+        end
+
+        if attributes.key?(:exhaustive_typo)
+          self.exhaustive_typo = attributes[:exhaustive_typo]
+        end
+
+        if attributes.key?(:facets)
+          if (value = attributes[:facets]).is_a?(Hash)
+            self.facets = value
+          end
+        end
+
+        if attributes.key?(:facets_stats)
+          if (value = attributes[:facets_stats]).is_a?(Hash)
+            self.facets_stats = value
+          end
+        end
+
+        if attributes.key?(:hits_per_page)
+          self.hits_per_page = attributes[:hits_per_page]
+        else
+          self.hits_per_page = nil
+        end
+
+        if attributes.key?(:index)
+          self.index = attributes[:index]
+        end
+
+        if attributes.key?(:index_used)
+          self.index_used = attributes[:index_used]
+        end
+
+        if attributes.key?(:message)
+          self.message = attributes[:message]
+        end
+
+        if attributes.key?(:nb_hits)
+          self.nb_hits = attributes[:nb_hits]
+        else
+          self.nb_hits = nil
+        end
+
+        if attributes.key?(:nb_pages)
+          self.nb_pages = attributes[:nb_pages]
+        else
+          self.nb_pages = nil
+        end
+
+        if attributes.key?(:nb_sorted_hits)
+          self.nb_sorted_hits = attributes[:nb_sorted_hits]
+        end
+
+        if attributes.key?(:page)
+          self.page = attributes[:page]
+        else
+          self.page = nil
+        end
+
+        if attributes.key?(:parsed_query)
+          self.parsed_query = attributes[:parsed_query]
+        end
+
+        if attributes.key?(:processing_time_ms)
+          self.processing_time_ms = attributes[:processing_time_ms]
+        else
+          self.processing_time_ms = nil
+        end
+
+        if attributes.key?(:processing_timings_ms)
+          self.processing_timings_ms = attributes[:processing_timings_ms]
+        end
+
+        if attributes.key?(:query_after_removal)
+          self.query_after_removal = attributes[:query_after_removal]
+        end
+
+        if attributes.key?(:redirect)
+          self.redirect = attributes[:redirect]
+        end
+
+        if attributes.key?(:rendering_content)
+          self.rendering_content = attributes[:rendering_content]
+        end
+
+        if attributes.key?(:server_time_ms)
+          self.server_time_ms = attributes[:server_time_ms]
+        end
+
+        if attributes.key?(:server_used)
+          self.server_used = attributes[:server_used]
+        end
+
+        if attributes.key?(:user_data)
+          self.user_data = attributes[:user_data]
+        end
+
+        if attributes.key?(:hits)
+          if (value = attributes[:hits]).is_a?(Array)
+            self.hits = value
+          end
+        else
+          self.hits = nil
+        end
+
+        if attributes.key?(:query)
+          self.query = attributes[:query]
+        end
+
+        if attributes.key?(:params)
+          self.params = attributes[:params]
+        end
+      end
+
+      # Custom attribute writer method with validation
+      # @param [Object] ab_test_variant_id Value to be assigned
+      def ab_test_variant_id=(ab_test_variant_id)
+        if ab_test_variant_id.nil?
+          raise ArgumentError, 'ab_test_variant_id cannot be nil'
+        end
+
+        if ab_test_variant_id < 1
+          raise ArgumentError, 'invalid value for "ab_test_variant_id", must be greater than or equal to 1.'
+        end
+
+        @ab_test_variant_id = ab_test_variant_id
+      end
+
+      # Custom attribute writer method with validation
+      # @param [Object] around_lat_lng Value to be assigned
+      def around_lat_lng=(around_lat_lng)
+        if around_lat_lng.nil?
+          raise ArgumentError, 'around_lat_lng cannot be nil'
+        end
+
+        pattern = /^(-?\d+(\.\d+)?),\s*(-?\d+(\.\d+)?)$/
+        if around_lat_lng !~ pattern
+          raise ArgumentError, "invalid value for \"around_lat_lng\", must conform to the pattern #{pattern}."
+        end
+
+        @around_lat_lng = around_lat_lng
+      end
+
+      # Custom attribute writer method with validation
+      # @param [Object] hits_per_page Value to be assigned
+      def hits_per_page=(hits_per_page)
+        if hits_per_page.nil?
+          raise ArgumentError, 'hits_per_page cannot be nil'
+        end
+
+        if hits_per_page > 1000
+          raise ArgumentError, 'invalid value for "hits_per_page", must be smaller than or equal to 1000.'
+        end
+
+        if hits_per_page < 1
+          raise ArgumentError, 'invalid value for "hits_per_page", must be greater than or equal to 1.'
+        end
+
+        @hits_per_page = hits_per_page
+      end
+
+      # Checks equality by comparing each attribute.
+      # @param [Object] Object to be compared
+      def ==(other)
+        return true if equal?(other)
+
+        self.class == other.class &&
+          ab_test_id == other.ab_test_id &&
+          ab_test_variant_id == other.ab_test_variant_id &&
+          around_lat_lng == other.around_lat_lng &&
+          automatic_radius == other.automatic_radius &&
+          exhaustive == other.exhaustive &&
+          exhaustive_facets_count == other.exhaustive_facets_count &&
+          exhaustive_nb_hits == other.exhaustive_nb_hits &&
+          exhaustive_typo == other.exhaustive_typo &&
+          facets == other.facets &&
+          facets_stats == other.facets_stats &&
+          hits_per_page == other.hits_per_page &&
+          index == other.index &&
+          index_used == other.index_used &&
+          message == other.message &&
+          nb_hits == other.nb_hits &&
+          nb_pages == other.nb_pages &&
+          nb_sorted_hits == other.nb_sorted_hits &&
+          page == other.page &&
+          parsed_query == other.parsed_query &&
+          processing_time_ms == other.processing_time_ms &&
+          processing_timings_ms == other.processing_timings_ms &&
+          query_after_removal == other.query_after_removal &&
+          redirect == other.redirect &&
+          rendering_content == other.rendering_content &&
+          server_time_ms == other.server_time_ms &&
+          server_used == other.server_used &&
+          user_data == other.user_data &&
+          hits == other.hits &&
+          query == other.query &&
+          params == other.params
+      end
+
+      # @see the `==` method
+      # @param [Object] Object to be compared
+      def eql?(other)
+        self == other
+      end
+
+      # Calculates hash code according to all attributes.
+      # @return [Integer] Hash code
+      def hash
+        [ab_test_id, ab_test_variant_id, around_lat_lng, automatic_radius, exhaustive, exhaustive_facets_count, exhaustive_nb_hits, exhaustive_typo, facets, facets_stats,
+         hits_per_page, index, index_used, message, nb_hits, nb_pages, nb_sorted_hits, page, parsed_query, processing_time_ms, processing_timings_ms, query_after_removal, redirect, rendering_content, server_time_ms, server_used, user_data, hits, query, params].hash
+      end
+
+      # Builds the object from hash
+      # @param [Hash] attributes Model attributes in the form of hash
+      # @return [Object] Returns the model itself
+      def self.build_from_hash(attributes)
+        return nil unless attributes.is_a?(Hash)
+
+        attributes = attributes.transform_keys(&:to_sym)
+        transformed_hash = {}
+        types_mapping.each_pair do |key, type|
+          if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+            transformed_hash[key.to_s] = nil
+          elsif type =~ /\AArray<(.*)>/i
+            # check to ensure the input is an array given that the attribute
+            # is documented as an array but the input is not
+            if attributes[attribute_map[key]].is_a?(Array)
+              transformed_hash[key.to_s] = attributes[attribute_map[key]].map { |v| _deserialize(::Regexp.last_match(1), v) }
+            end
+          elsif !attributes[attribute_map[key]].nil?
+            transformed_hash[key.to_s] = _deserialize(type, attributes[attribute_map[key]])
+          end
+        end
+        new(transformed_hash)
+      end
+
+      # Deserializes the data based on type
+      # @param string type Data type
+      # @param string value Value to be deserialized
+      # @return [Object] Deserialized data
+      def self._deserialize(type, value)
+        case type.to_sym
+        when :Time
+          Time.parse(value)
+        when :Date
+          Date.parse(value)
+        when :String
+          value.to_s
+        when :Integer
+          value.to_i
+        when :Float
+          value.to_f
+        when :Boolean
+          if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+            true
+          else
+            false
+          end
+        when :Object
+          # generic object (usually a Hash), return directly
+          value
+        when /\AArray<(?<inner_type>.+)>\z/
+          inner_type = Regexp.last_match[:inner_type]
+          value.map { |v| _deserialize(inner_type, v) }
+        when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
+          k_type = Regexp.last_match[:k_type]
+          v_type = Regexp.last_match[:v_type]
+          {}.tap do |hash|
+            value.each do |k, v|
+              hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+            end
+          end
+        else # model
+          # models (e.g. Pet) or oneOf
+          klass = Algolia::Recommend.const_get(type)
+          klass.respond_to?(:openapi_any_of) || klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
+        end
+      end
+
+      # Returns the string representation of the object
+      # @return [String] String presentation of the object
+      def to_s
+        to_hash.to_s
+      end
+
+      # to_body is an alias to to_hash (backward compatibility)
+      # @return [Hash] Returns the object in the form of hash
+      def to_body
+        to_hash
+      end
+
+      # Returns the object in the form of hash
+      # @return [Hash] Returns the object in the form of hash
+      def to_hash
+        hash = {}
+        self.class.attribute_map.each_pair do |attr, param|
+          value = send(attr)
+          if value.nil?
+            is_nullable = self.class.openapi_nullable.include?(attr)
+            next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+          end
+
+          hash[param] = _to_hash(value)
+        end
+        hash
+      end
+
+      # Outputs non-array value in the form of hash
+      # For object, use to_hash. Otherwise, just return the value
+      # @param [Object] value Any valid value
+      # @return [Hash] Returns the value in the form of hash
+      def _to_hash(value)
+        if value.is_a?(Array)
+          value.compact.map { |v| _to_hash(v) }
+        elsif value.is_a?(Hash)
+          {}.tap do |hash|
+            value.each { |k, v| hash[k] = _to_hash(v) }
+          end
+        elsif value.respond_to? :to_hash
+          value.to_hash
+        else
+          value
+        end
+      end
+    end
+  end
+end

data/lib/algolia/models/recommend/recommended_for_you_model.rb

@@ -0,0 +1,32 @@
+# Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
+
+require 'date'
+require 'time'
+
+module Algolia
+  module Recommend
+    class RecommendedForYouModel
+      RECOMMENDED_FOR_YOU = "recommended-for-you".freeze
+
+      def self.all_vars
+        @all_vars ||= [RECOMMENDED_FOR_YOU].freeze
+      end
+
+      # Builds the enum from string
+      # @param [String] The enum value in the form of the string
+      # @return [String] The enum value
+      def self.build_from_hash(value)
+        new.build_from_hash(value)
+      end
+
+      # Builds the enum from string
+      # @param [String] The enum value in the form of the string
+      # @return [String] The enum value
+      def build_from_hash(value)
+        return value if RecommendedForYouModel.all_vars.include?(value)
+
+        raise "Invalid ENUM value #{value} for class #RecommendedForYouModel"
+      end
+    end
+  end
+end