kinopoisk_dev_api 1.4.0

data/lib/kinopoisk_dev_api/client.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  class Client
+    attr_reader :api_key, :url
+
+    API_VERSION = "v1.4"
+
+    def initialize(api_key, url: "https://api.kinopoisk.dev")
+      @api_key = api_key
+      @url = url
+    end
+
+    def connection
+      @connection ||= Faraday.new(url: url, headers: { "X-API-KEY" => api_key }) do |faraday|
+        faraday.adapter KinopoiskDevApi.configuration.adapter
+        faraday.options.timeout = KinopoiskDevApi.configuration.connection_timeout
+        faraday.options.open_timeout = KinopoiskDevApi.configuration.connection_open_timeout
+        faraday.options.params_encoder = Faraday::FlatParamsEncoder
+      end
+    end
+
+    def method_missing(method_name, *args, &block)
+      return super unless ENDPOINTS.key?(method_name)
+
+      endpoint = ENDPOINTS[method_name]
+
+      result = call(endpoint, *args)
+
+      endpoint_type(endpoint).call(result)
+    end
+
+    def respond_to_missing?(*args)
+      method_name = args[0]
+
+      ENDPOINTS.key?(method_name) || super
+    end
+
+    def call(endpoint, raw_params = {})
+      params = build_params(raw_params)
+      path = build_path(endpoint, params)
+      response = connection.get(path, params)
+      raise Exceptions::ResponseError.new(response: response) unless response.status == 200
+
+      JSON.parse(response.body)
+    end
+
+    private
+
+    def endpoint_type(endpoint)
+      response_type = endpoint[:response_type]
+      return response_type unless response_type.is_a?(String)
+
+      version = (endpoint[:version] || API_VERSION).tr(".", "_").upcase
+      KinopoiskDevApi.const_get(response_type.sub("<VERSION>", version))
+    end
+
+    def build_params(raw_params)
+      params = raw_params.dup
+
+      params.transform_keys! do |key|
+        words = key.to_s.split("_")
+        words.drop(1).map(&:capitalize!)
+        words.join
+      end
+
+      params.transform_values! { |value| transform_value(value) }
+
+      params
+    end
+
+    def build_path(endpoint, params)
+      version = endpoint[:version] || API_VERSION
+      path = (+"/").concat(version, endpoint[:path])
+
+      path.gsub(/:(\w+)/) do |path_param|
+        params.key?(::Regexp.last_match(1)) ? params.delete(::Regexp.last_match(1)) : path_param
+      end
+    end
+
+    def transform_value(raw_value) # rubocop:disable Metrics/CyclomaticComplexity, Metrics/MethodLength
+      case raw_value
+      when Array
+        raw_value.map { |e| transform_value(e) }
+      when String
+        raw_value
+      when Date, Time, DateTime
+        raw_value.strftime("%d.%m.%Y")
+      when TrueClass, FalseClass
+        raw_value ? "true" : "false"
+      when Range
+        transform_value([raw_value.begin, raw_value.end]).join("-")
+      else
+        raw_value.to_s
+      end
+    end
+  end
+end

data/lib/kinopoisk_dev_api/configuration.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  class Configuration
+    attr_accessor :adapter, :connection_open_timeout, :connection_timeout
+
+    def initialize
+      @adapter = Faraday.default_adapter
+      @connection_open_timeout = 20
+      @connection_timeout = 20
+    end
+  end
+end

data/lib/kinopoisk_dev_api/endpoints.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  ENDPOINTS = {
+    movie_by_id: {
+      path: "/movie/:id",
+      response_type: "Types::MovieDto<VERSION>"
+    }.freeze,
+    movie: {
+      path: "/movie",
+      response_type: "Types::MovieDocsResponseDto<VERSION>"
+    }.freeze,
+    movie_search: {
+      path: "/movie/search",
+      response_type: "Types::SearchMovieResponseDto<VERSION>"
+    }.freeze,
+    movie_random: {
+      path: "/movie/random",
+      response_type: "Types::MovieDto<VERSION>"
+    }.freeze,
+    movie_awards: {
+      path: "/movie/awards",
+      response_type: Types::MovieAwardDocsResponseDto
+    }.freeze,
+    movie_possible_values_by_field: {
+      path: "/movie/possible-values-by-field",
+      response_type: Types::Array.of(Types::PossibleValueDto),
+      version: "v1"
+    }.freeze,
+    season: {
+      path: "/season",
+      response_type: "Types::SeasonDocsResponseDto<VERSION>"
+    }.freeze,
+    review: {
+      path: "/review",
+      response_type: "Types::ReviewDocsResponseDto<VERSION>"
+    }.freeze,
+    person_by_id: {
+      path: "/person/:id",
+      response_type: Types::Person
+    }.freeze,
+    person: {
+      path: "/person",
+      response_type: "Types::PersonDocsResponseDto<VERSION>"
+    }.freeze,
+    person_search: {
+      path: "/person/search",
+      response_type: "Types::SearchPersonResponseDto<VERSION>"
+    }.freeze,
+    person_awards: {
+      path: "/person/awards",
+      response_type: Types::PersonAwardDocsResponseDto
+    }.freeze,
+    studio: {
+      path: "/studio",
+      response_type: "Types::StudioDocsResponseDto<VERSION>"
+    }.freeze,
+    keyword: {
+      path: "/keyword",
+      response_type: "Types::KeywordDocsResponseDto<VERSION>"
+    }.freeze,
+    image: {
+      path: "/image",
+      response_type: "Types::ImageDocsResponseDto<VERSION>"
+    }.freeze,
+    list: {
+      path: "/list",
+      response_type: "Types::ListDocsResponseDto<VERSION>"
+    }.freeze,
+    list_by_slug: {
+      path: "/list/:slug",
+      response_type: Types::List
+    }.freeze
+  }.freeze
+end

data/lib/kinopoisk_dev_api/exceptions/base.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Exceptions
+    class Base < StandardError; end
+  end
+end

data/lib/kinopoisk_dev_api/exceptions/response_error.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Exceptions
+    class ResponseError < Base
+      attr_reader :response
+
+      def initialize(response:)
+        @response = response
+
+        super("Kinopoisk.dev API has returned the error. (#{data.map { |k, v| %(#{k}: #{v.inspect}) }.join(", ")})")
+      end
+
+      def error_code
+        data[:statusCode] || data["statusCode"]
+      end
+
+      def error_type
+        data[:error] || data["error"]
+      end
+
+      def error_message
+        data[:message] || data["message"]
+      end
+
+      def data
+        @data ||= begin
+          JSON.parse(response.body)
+        rescue JSON::ParserError
+          { error_code: response.status, uri: response.env.url.to_s }
+        end
+      end
+    end
+  end
+end

data/lib/kinopoisk_dev_api/inflector.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  class Inflector < Zeitwerk::GemInflector
+    def camelize(basename, abspath)
+      case basename
+      when "endpoints"
+        "ENDPOINTS"
+      when /(.*)_(v\d+(?:_\d+)*)/
+        super(::Regexp.last_match(1), abspath) + ::Regexp.last_match(2).upcase
+      else
+        super
+      end
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/audience.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class Audience < Base
+      attribute? :count, Types::Float | Types::Integer.optional
+      attribute? :country, Types::Coercible::String.optional
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/base.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class Base < Dry::Struct
+      include Compactable
+      include PatternMatching
+
+      transform_keys(&:to_sym)
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/birth_place.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class BirthPlace < Base
+      attribute? :value, Types::Coercible::String
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/compactable.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    module Compactable
+      def to_compact_hash
+        attributes.dup.compact.to_h do |key, value|
+          value = value.to_compact_hash if value.respond_to?(:to_compact_hash)
+
+          [key, value]
+        end
+      end
+
+      def to_json(*args)
+        to_compact_hash.select { |_, v| v }.to_json(*args)
+      end
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/currency_value.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class CurrencyValue < Base
+      attribute? :value, Types::Float | Types::Integer.optional
+      attribute? :currency, Types::Coercible::String.optional
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/death_place.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class DeathPlace < Base
+      attribute? :value, Types::Coercible::String
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/episode_v1_4.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    ## Just for classes consistency
+    # rubocop:disable Naming/ClassAndModuleCamelCase
+    class EpisodeV1_4 < Base
+      attribute? :number, Types::Float | Types::Integer
+      attribute? :name, Types::Coercible::String
+      attribute? :enName, Types::Coercible::String
+      attribute? :date, Types::Coercible::String
+      attribute? :description, Types::Coercible::String
+      attribute? :still, ShortImage
+      attribute? :airDate, Types::Coercible::String
+      attribute? :enDescription, Types::Coercible::String
+      alias en_name enName
+      alias air_date airDate
+      alias en_description enDescription
+    end
+    # rubocop:enable Naming/ClassAndModuleCamelCase
+  end
+end

data/lib/kinopoisk_dev_api/types/external_id.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class ExternalId < Base
+      attribute? :kpHD, Types::Coercible::String.optional
+      attribute? :imdb, Types::Coercible::String.optional
+      attribute? :tmdb, Types::Float | Types::Integer.optional
+      alias kp_hd kpHD
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/fact_in_movie.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class FactInMovie < Base
+      attribute? :value, Types::Coercible::String
+      attribute? :type, Types::Coercible::String.optional
+      attribute? :spoiler, Types::Bool.optional
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/fact_in_person.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class FactInPerson < Base
+      attribute? :value, Types::Coercible::String
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/fees.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class Fees < Base
+      attribute? :world, CurrencyValue
+      attribute? :russia, CurrencyValue
+      attribute? :usa, CurrencyValue
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/image.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class Image < Base
+      attribute? :movieId, Types::Float | Types::Integer
+      attribute? :type, Types::Coercible::String
+      attribute? :language, Types::Coercible::String
+      attribute? :url, Types::Coercible::String
+      attribute? :previewUrl, Types::Coercible::String
+      attribute? :height, Types::Float | Types::Integer
+      attribute? :width, Types::Float | Types::Integer
+      attribute? :updatedAt, Types::Coercible::String
+      attribute? :createdAt, Types::Coercible::String
+      alias movie_id movieId
+      alias preview_url previewUrl
+      alias updated_at updatedAt
+      alias created_at createdAt
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/image_docs_response_dto_v1_4.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    ## Just for classes consistency
+    # rubocop:disable Naming/ClassAndModuleCamelCase
+    class ImageDocsResponseDtoV1_4 < Base
+      attribute? :docs, Types::Array.of(Image)
+      attribute? :total, Types::Float | Types::Integer
+      attribute? :limit, Types::Float | Types::Integer
+      attribute? :page, Types::Float | Types::Integer
+      attribute? :pages, Types::Float | Types::Integer
+    end
+    # rubocop:enable Naming/ClassAndModuleCamelCase
+  end
+end

data/lib/kinopoisk_dev_api/types/item_name.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class ItemName < Base
+      attribute? :name, Types::Coercible::String
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/keyword.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class Keyword < Base
+      attribute? :id, Types::Float | Types::Integer
+      attribute? :title, Types::Coercible::String.optional
+      attribute? :movies, Types::Array.of(MovieFromKeyword)
+      attribute? :updatedAt, Types::Coercible::String
+      attribute? :createdAt, Types::Coercible::String
+      alias updated_at updatedAt
+      alias created_at createdAt
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/keyword_docs_response_dto_v1_4.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    ## Just for classes consistency
+    # rubocop:disable Naming/ClassAndModuleCamelCase
+    class KeywordDocsResponseDtoV1_4 < Base
+      attribute? :docs, Types::Array.of(Keyword)
+      attribute? :total, Types::Float | Types::Integer
+      attribute? :limit, Types::Float | Types::Integer
+      attribute? :page, Types::Float | Types::Integer
+      attribute? :pages, Types::Float | Types::Integer
+    end
+    # rubocop:enable Naming/ClassAndModuleCamelCase
+  end
+end

data/lib/kinopoisk_dev_api/types/linked_movie_v1_4.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    ## Just for classes consistency
+    # rubocop:disable Naming/ClassAndModuleCamelCase
+    class LinkedMovieV1_4 < Base
+      attribute? :id, Types::Float | Types::Integer
+      attribute? :name, Types::Coercible::String.optional
+      attribute? :enName, Types::Coercible::String.optional
+      attribute? :alternativeName, Types::Coercible::String.optional
+      attribute? :type, Types::Coercible::String.optional
+      attribute? :poster, ShortImage.optional
+      attribute? :rating, Rating.optional
+      attribute? :year, Types::Float | Types::Integer.optional
+      alias en_name enName
+      alias alternative_name alternativeName
+    end
+    # rubocop:enable Naming/ClassAndModuleCamelCase
+  end
+end

data/lib/kinopoisk_dev_api/types/list.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class List < Base
+      attribute? :category, Types::Coercible::String.optional
+      attribute? :slug, Types::Coercible::String.optional
+      attribute? :moviesCount, Types::Float | Types::Integer.optional
+      attribute? :cover, ShortImage.optional
+      attribute? :name, Types::Coercible::String
+      attribute? :updatedAt, Types::Coercible::String
+      attribute? :createdAt, Types::Coercible::String
+      alias movies_count moviesCount
+      alias updated_at updatedAt
+      alias created_at createdAt
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/list_docs_response_dto_v1_4.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    ## Just for classes consistency
+    # rubocop:disable Naming/ClassAndModuleCamelCase
+    class ListDocsResponseDtoV1_4 < Base
+      attribute? :docs, Types::Array.of(List)
+      attribute? :total, Types::Float | Types::Integer
+      attribute? :limit, Types::Float | Types::Integer
+      attribute? :page, Types::Float | Types::Integer
+      attribute? :pages, Types::Float | Types::Integer
+    end
+    # rubocop:enable Naming/ClassAndModuleCamelCase
+  end
+end

data/lib/kinopoisk_dev_api/types/logo.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class Logo < Base
+      attribute? :url, Types::Coercible::String.optional
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/meili_person_entity_v1_4.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    ## Just for classes consistency
+    # rubocop:disable Naming/ClassAndModuleCamelCase
+    class MeiliPersonEntityV1_4 < Base
+      attribute? :id, Types::Float | Types::Integer
+      attribute? :name, Types::Coercible::String.optional
+      attribute? :enName, Types::Coercible::String.optional
+      attribute? :photo, Types::Coercible::String.optional
+      attribute? :sex, Types::Coercible::String.optional
+      attribute? :growth, Types::Float | Types::Integer.optional
+      attribute? :birthday, Types::Coercible::String.optional
+      attribute? :death, Types::Coercible::String.optional
+      attribute? :age, Types::Float | Types::Integer.optional
+      attribute? :birthPlace, Types::Array.of(BirthPlace)
+      attribute? :deathPlace, Types::Array.of(DeathPlace)
+      attribute? :profession, Types::Array.of(Profession)
+      alias en_name enName
+      alias birth_place birthPlace
+      alias death_place deathPlace
+    end
+    # rubocop:enable Naming/ClassAndModuleCamelCase
+  end
+end

data/lib/kinopoisk_dev_api/types/movie.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class Movie < Base
+      attribute? :id, Types::Float | Types::Integer
+      attribute? :name, Types::Coercible::String.optional
+      attribute? :rating, Types::Float | Types::Integer.optional
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/movie_award.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class MovieAward < Base
+      attribute? :nomination, Nomination.optional
+      attribute? :winning, Types::Bool.optional
+      attribute? :updatedAt, Types::Coercible::String.optional
+      attribute? :createdAt, Types::Coercible::String.optional
+      attribute? :movieId, Types::Float | Types::Integer.optional
+      alias updated_at updatedAt
+      alias created_at createdAt
+      alias movie_id movieId
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/movie_award_docs_response_dto.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    class MovieAwardDocsResponseDto < Base
+      attribute? :docs, Types::Array.of(MovieAward)
+      attribute? :total, Types::Float | Types::Integer
+      attribute? :limit, Types::Float | Types::Integer
+      attribute? :page, Types::Float | Types::Integer
+      attribute? :pages, Types::Float | Types::Integer
+    end
+  end
+end

data/lib/kinopoisk_dev_api/types/movie_docs_response_dto_v1_4.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module KinopoiskDevApi
+  module Types
+    ## Just for classes consistency
+    # rubocop:disable Naming/ClassAndModuleCamelCase
+    class MovieDocsResponseDtoV1_4 < Base
+      attribute? :docs, Types::Array.of(MovieDtoV1_4)
+      attribute? :total, Types::Float | Types::Integer
+      attribute? :limit, Types::Float | Types::Integer
+      attribute? :page, Types::Float | Types::Integer
+      attribute? :pages, Types::Float | Types::Integer
+    end
+    # rubocop:enable Naming/ClassAndModuleCamelCase
+  end
+end