kuapir 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 501deb3329ce81dbfb78ce901bb4d58f739603db255b26dc3e8cd040ea5fc18b
+  data.tar.gz: 06b1821a936ddcb7fdc0788a7d42b89f474b9a43341389d1a2386c7d629be20e
+SHA512:
+  metadata.gz: e5934b5614cde3df0fc84f97a1934b2f7a4fa993768083c1081e96466af6a5fe70671789160e91542300c993f19e24c465ed2b9274f839a3c97d74d4c3c7fbcf
+  data.tar.gz: d3bc6abed415e34b4f29217cff122600f943cc4ce5d596d3341b0ab360a77b50422a965e139b529937ae82234ead0aee1cf331915e8a352df6ef44ca2be0460e

data/Gemfile

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec
+
+group :development, :test do
+  gem "awesome_print"
+  gem "pry-byebug"
+  gem "rake", "~> 13.0.1"
+  gem "rubocop", "~> 1.11.0"
+  gem "rubocop-performance", "~> 1.10"
+end

data/Gemfile.lock

@@ -0,0 +1,77 @@
+PATH
+  remote: .
+  specs:
+    kuapir (0.1.2)
+      typhoeus (~> 1.0, >= 1.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    awesome_print (1.9.2)
+    byebug (11.1.3)
+    coderay (1.1.3)
+    diff-lcs (1.5.0)
+    ethon (0.15.0)
+      ffi (>= 1.15.0)
+    ffi (1.15.5)
+    method_source (1.0.0)
+    parallel (1.21.0)
+    parser (3.1.0.0)
+      ast (~> 2.4.1)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry-byebug (3.9.0)
+      byebug (~> 11.0)
+      pry (~> 0.13.0)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.2.0)
+    rexml (3.2.5)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.3)
+    rubocop (1.11.0)
+      parallel (~> 1.10)
+      parser (>= 3.0.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.2.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.15.1)
+      parser (>= 3.0.1.1)
+    rubocop-performance (1.13.1)
+      rubocop (>= 1.7.0, < 2.0)
+      rubocop-ast (>= 0.4.0)
+    ruby-progressbar (1.11.0)
+    typhoeus (1.4.0)
+      ethon (>= 0.9.0)
+    unicode-display_width (2.1.0)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  awesome_print
+  kuapir!
+  pry-byebug
+  rake (~> 13.0.1)
+  rspec (~> 3.6, >= 3.6.0)
+  rubocop (~> 1.11.0)
+  rubocop-performance (~> 1.10)
+
+BUNDLED WITH
+   2.2.15

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright © 2022 kuapir
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,170 @@
+# kuapir
+
+Kuapir - the Ruby gem for the Kinopoisk Unofficial API
+
+Kinopoisk Unofficial API предеставляет доступ к данным сайта https://www.kinopoisk.ru. 
+Для доступа вы должны получить токен, который будет доступен после регистрации на [https://kinopoiskapiunofficial.tech](https://kinopoiskapiunofficial.tech)
+*Ограничения:*  лимитов на общее кол-во запросов нет. Но есть на кол-во запросов в секунду. 
+Каждый пользователь имеет ограничение в *20 req/sec*. 
+*Некоторые* эндпоинты имеют свои собственные ограничения, они указаны в описании для статуса *429*.
+
+This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
+
+- API version: 2.0.1
+- Package version: 1.0.0
+- Build package: org.openapitools.codegen.languages.RubyClientCodegen
+
+## Installation
+
+### Build a gem
+
+To build the Ruby code into a gem:
+
+```shell
+gem build kuapir.gemspec
+```
+
+Then either install the gem locally:
+
+```shell
+gem install ./kuapir-1.0.0.gem
+```
+
+(for development, run `gem install --dev ./kuapir-1.0.0.gem` to install the development dependencies)
+
+or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
+
+Finally add this to the Gemfile:
+
+    gem 'kuapir', '~> 1.0.0'
+
+### Install from Git
+
+If the Ruby gem is hosted at a git repository: https://github.com/GIT_USER_ID/GIT_REPO_ID, then add the following in the Gemfile:
+
+    gem 'kuapir', :git => 'https://github.com/GIT_USER_ID/GIT_REPO_ID.git'
+
+### Include the Ruby code directly
+
+Include the Ruby code directly using `-I` as follows:
+
+```shell
+ruby -Ilib script.rb
+```
+
+## Getting Started
+
+Please follow the [installation](#installation) procedure and then run the following code:
+
+```ruby
+# Load the gem
+require 'kuapir'
+
+# Setup authorization
+Kuapir.configure do |config|
+  # Configure API key authorization: ApiKeyAuth
+  config.api_key['ApiKeyAuth'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['ApiKeyAuth'] = 'Bearer'
+  
+  # Uncomment the following line to set a proxy for requests (defaults to nil)
+  # config.proxy = 'http://my_proxy.com:1111'
+end
+
+api_instance = Kuapir::FilmsApi.new
+id = 56 # Integer | kinopoisk film id
+
+begin
+  #получить сиквелы и приквелы для фильма по kinopoisk film id
+  result = api_instance.api_v21_films_id_sequels_and_prequels_get(id)
+  p result
+rescue Kuapir::ApiError => e
+  puts "Exception when calling FilmsApi->api_v21_films_id_sequels_and_prequels_get: #{e}"
+end
+
+```
+
+## Documentation for API Endpoints
+
+All URIs are relative to *https://kinopoiskapiunofficial.tech*
+
+Class | Method | HTTP request | Description
+------------ | ------------- | ------------- | -------------
+*Kuapir::FilmsApi* | [**api_v21_films_id_sequels_and_prequels_get**](docs/FilmsApi.md#api_v21_films_id_sequels_and_prequels_get) | **GET** /api/v2.1/films/{id}/sequels_and_prequels | получить сиквелы и приквелы для фильма по kinopoisk film id
+*Kuapir::FilmsApi* | [**api_v21_films_releases_get**](docs/FilmsApi.md#api_v21_films_releases_get) | **GET** /api/v2.1/films/releases | получить список цифровых релизов
+*Kuapir::FilmsApi* | [**api_v21_films_search_by_keyword_get**](docs/FilmsApi.md#api_v21_films_search_by_keyword_get) | **GET** /api/v2.1/films/search-by-keyword | получить список фильмов по ключевым словам
+*Kuapir::FilmsApi* | [**api_v22_films_filters_get**](docs/FilmsApi.md#api_v22_films_filters_get) | **GET** /api/v2.2/films/filters | получить id стран и жанров для использования в /api/v2.2/films
+*Kuapir::FilmsApi* | [**api_v22_films_get**](docs/FilmsApi.md#api_v22_films_get) | **GET** /api/v2.2/films | получить список фильмов по различным фильтрам
+*Kuapir::FilmsApi* | [**api_v22_films_id_box_office_get**](docs/FilmsApi.md#api_v22_films_id_box_office_get) | **GET** /api/v2.2/films/{id}/box_office | получить данные о бюджете и сборах фильма по kinopoisk film id
+*Kuapir::FilmsApi* | [**api_v22_films_id_distributions_get**](docs/FilmsApi.md#api_v22_films_id_distributions_get) | **GET** /api/v2.2/films/{id}/distributions | получить данные о прокате фильма по kinopoisk film id
+*Kuapir::FilmsApi* | [**api_v22_films_id_facts_get**](docs/FilmsApi.md#api_v22_films_id_facts_get) | **GET** /api/v2.2/films/{id}/facts | получить данные о фактах и ошибках в фильме по kinopoisk film id
+*Kuapir::FilmsApi* | [**api_v22_films_id_get**](docs/FilmsApi.md#api_v22_films_id_get) | **GET** /api/v2.2/films/{id} | получить данные о фильме по kinopoisk id
+*Kuapir::FilmsApi* | [**api_v22_films_id_images_get**](docs/FilmsApi.md#api_v22_films_id_images_get) | **GET** /api/v2.2/films/{id}/images | получить изображения(кадры, постеры, фан-арты, обои и т.д.) связанные с фильмом по kinopoisk film id
+*Kuapir::FilmsApi* | [**api_v22_films_id_seasons_get**](docs/FilmsApi.md#api_v22_films_id_seasons_get) | **GET** /api/v2.2/films/{id}/seasons | получить данные о сезонах для сериала по kinopoisk film id
+*Kuapir::FilmsApi* | [**api_v22_films_id_similars_get**](docs/FilmsApi.md#api_v22_films_id_similars_get) | **GET** /api/v2.2/films/{id}/similars | получить список похожих фильмов по kinopoisk film id
+*Kuapir::FilmsApi* | [**api_v22_films_id_videos_get**](docs/FilmsApi.md#api_v22_films_id_videos_get) | **GET** /api/v2.2/films/{id}/videos | получить трейлеры,тизеры,видео для фильма по kinopoisk film id
+*Kuapir::FilmsApi* | [**api_v22_films_premieres_get**](docs/FilmsApi.md#api_v22_films_premieres_get) | **GET** /api/v2.2/films/premieres | получить список кинопремьер
+*Kuapir::FilmsApi* | [**api_v22_films_top_get**](docs/FilmsApi.md#api_v22_films_top_get) | **GET** /api/v2.2/films/top | получить список фильмов из различных топов или коллекций. Например https://www.kinopoisk.ru/top/lists/58/
+*Kuapir::PersonsApi* | [**api_v1_persons_get**](docs/PersonsApi.md#api_v1_persons_get) | **GET** /api/v1/persons | поиск актеров, режиссеров и т.д. по имени
+*Kuapir::ReviewsApi* | [**api_v1_reviews_details_get**](docs/ReviewsApi.md#api_v1_reviews_details_get) | **GET** /api/v1/reviews/details | получить полную рецензию по kinopoisk review id
+*Kuapir::ReviewsApi* | [**api_v1_reviews_get**](docs/ReviewsApi.md#api_v1_reviews_get) | **GET** /api/v1/reviews | получить рецензии зрителей
+*Kuapir::StaffApi* | [**api_v1_staff_get**](docs/StaffApi.md#api_v1_staff_get) | **GET** /api/v1/staff | получить данные об актерах, режисерах и т.д. по kinopoisk film id
+*Kuapir::StaffApi* | [**api_v1_staff_id_get**](docs/StaffApi.md#api_v1_staff_id_get) | **GET** /api/v1/staff/{id} | получить данные о конкретном человеке по kinopoisk person id
+
+
+## Documentation for Models
+
+ - [Kuapir::BoxOffice](docs/BoxOffice.md)
+ - [Kuapir::BoxOfficeResponse](docs/BoxOfficeResponse.md)
+ - [Kuapir::Company](docs/Company.md)
+ - [Kuapir::Country](docs/Country.md)
+ - [Kuapir::DigitalReleaseItem](docs/DigitalReleaseItem.md)
+ - [Kuapir::DigitalReleaseResponse](docs/DigitalReleaseResponse.md)
+ - [Kuapir::Distribution](docs/Distribution.md)
+ - [Kuapir::DistributionResponse](docs/DistributionResponse.md)
+ - [Kuapir::Episode](docs/Episode.md)
+ - [Kuapir::Fact](docs/Fact.md)
+ - [Kuapir::FactResponse](docs/FactResponse.md)
+ - [Kuapir::Film](docs/Film.md)
+ - [Kuapir::FilmSearchByFiltersResponse](docs/FilmSearchByFiltersResponse.md)
+ - [Kuapir::FilmSearchByFiltersResponseItems](docs/FilmSearchByFiltersResponseItems.md)
+ - [Kuapir::FilmSearchResponse](docs/FilmSearchResponse.md)
+ - [Kuapir::FilmSearchResponseFilms](docs/FilmSearchResponseFilms.md)
+ - [Kuapir::FilmSequelsAndPrequelsResponse](docs/FilmSequelsAndPrequelsResponse.md)
+ - [Kuapir::FilmTopResponse](docs/FilmTopResponse.md)
+ - [Kuapir::FilmTopResponseFilms](docs/FilmTopResponseFilms.md)
+ - [Kuapir::FiltersResponse](docs/FiltersResponse.md)
+ - [Kuapir::FiltersResponseCountries](docs/FiltersResponseCountries.md)
+ - [Kuapir::FiltersResponseGenres](docs/FiltersResponseGenres.md)
+ - [Kuapir::Genre](docs/Genre.md)
+ - [Kuapir::ImageResponse](docs/ImageResponse.md)
+ - [Kuapir::ImageResponseItems](docs/ImageResponseItems.md)
+ - [Kuapir::PersonByNameResponse](docs/PersonByNameResponse.md)
+ - [Kuapir::PersonByNameResponseItems](docs/PersonByNameResponseItems.md)
+ - [Kuapir::PersonResponse](docs/PersonResponse.md)
+ - [Kuapir::PersonResponseFilms](docs/PersonResponseFilms.md)
+ - [Kuapir::PersonResponseSpouses](docs/PersonResponseSpouses.md)
+ - [Kuapir::PremiereResponse](docs/PremiereResponse.md)
+ - [Kuapir::PremiereResponseItem](docs/PremiereResponseItem.md)
+ - [Kuapir::RelatedFilmResponse](docs/RelatedFilmResponse.md)
+ - [Kuapir::RelatedFilmResponseItems](docs/RelatedFilmResponseItems.md)
+ - [Kuapir::ReviewDetailsResponse](docs/ReviewDetailsResponse.md)
+ - [Kuapir::ReviewsResponse](docs/ReviewsResponse.md)
+ - [Kuapir::ReviewsResponseReviews](docs/ReviewsResponseReviews.md)
+ - [Kuapir::Season](docs/Season.md)
+ - [Kuapir::SeasonResponse](docs/SeasonResponse.md)
+ - [Kuapir::StaffResponse](docs/StaffResponse.md)
+ - [Kuapir::VideoResponse](docs/VideoResponse.md)
+ - [Kuapir::VideoResponseItems](docs/VideoResponseItems.md)
+
+
+## Documentation for Authorization
+
+
+### ApiKeyAuth
+
+
+- **Type**: API key
+- **API key parameter name**: X-API-KEY
+- **Location**: HTTP header
+

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+
+begin
+  require "rspec/core/rake_task"
+
+  RSpec::Core::RakeTask.new(:spec)
+  task default: :spec
+rescue LoadError
+  # no rspec available
+end

data/docs/BoxOffice.md

@@ -0,0 +1,26 @@
+# Kuapir::BoxOffice
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **type** | **String** |  |  |
+| **amount** | **Integer** |  |  |
+| **currency_code** | **String** |  |  |
+| **name** | **String** |  |  |
+| **symbol** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'kuapir'
+
+instance = Kuapir::BoxOffice.new(
+  type: BUDGET,
+  amount: 63000000,
+  currency_code: USD,
+  name: US Dollar,
+  symbol: $
+)
+```
+

data/docs/BoxOfficeResponse.md

@@ -0,0 +1,20 @@
+# Kuapir::BoxOfficeResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **total** | **Integer** |  |  |
+| **items** | [**Array<BoxOffice>**](BoxOffice.md) |  |  |
+
+## Example
+
+```ruby
+require 'kuapir'
+
+instance = Kuapir::BoxOfficeResponse.new(
+  total: 5,
+  items: null
+)
+```
+

data/docs/Company.md

@@ -0,0 +1,18 @@
+# Kuapir::Company
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'kuapir'
+
+instance = Kuapir::Company.new(
+  name: Каро-Премьер
+)
+```
+

data/docs/Country.md

@@ -0,0 +1,18 @@
+# Kuapir::Country
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **country** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'kuapir'
+
+instance = Kuapir::Country.new(
+  country: США
+)
+```
+

data/docs/DigitalReleaseItem.md

@@ -0,0 +1,44 @@
+# Kuapir::DigitalReleaseItem
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **film_id** | **Integer** |  |  |
+| **name_ru** | **String** |  |  |
+| **name_en** | **String** |  |  |
+| **year** | **Integer** |  |  |
+| **poster_url** | **String** |  |  |
+| **poster_url_preview** | **String** |  |  |
+| **countries** | [**Array<Country>**](Country.md) |  |  |
+| **genres** | [**Array<Genre>**](Genre.md) |  |  |
+| **rating** | **Float** |  |  |
+| **rating_vote_count** | **Integer** |  |  |
+| **expectations_rating** | **Float** |  |  |
+| **expectations_rating_vote_count** | **Integer** |  |  |
+| **duration** | **Integer** |  |  |
+| **release_date** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'kuapir'
+
+instance = Kuapir::DigitalReleaseItem.new(
+  film_id: 301,
+  name_ru: Дитя погоды,
+  name_en: Tenki no ko,
+  year: 2019,
+  poster_url: http://kinopoiskapiunofficial.tech/images/posters/kp/1219417.jpg,
+  poster_url_preview: https://kinopoiskapiunofficial.tech/images/posters/kp_small/301.jpg,
+  countries: null,
+  genres: null,
+  rating: 7.962,
+  rating_vote_count: 14502,
+  expectations_rating: 99.13,
+  expectations_rating_vote_count: 1123,
+  duration: 112,
+  release_date: 2020-06-01
+)
+```
+

data/docs/DigitalReleaseResponse.md

@@ -0,0 +1,22 @@
+# Kuapir::DigitalReleaseResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **page** | **Integer** |  |  |
+| **total** | **Integer** |  |  |
+| **releases** | [**Array<DigitalReleaseItem>**](DigitalReleaseItem.md) |  |  |
+
+## Example
+
+```ruby
+require 'kuapir'
+
+instance = Kuapir::DigitalReleaseResponse.new(
+  page: 1,
+  total: 34,
+  releases: null
+)
+```
+

data/docs/Distribution.md

@@ -0,0 +1,28 @@
+# Kuapir::Distribution
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **type** | **String** |  |  |
+| **sub_type** | **String** |  |  |
+| **date** | **String** |  |  |
+| **re_release** | **Boolean** |  |  |
+| **country** | [**Country**](Country.md) |  |  |
+| **companies** | [**Array<Company>**](Company.md) |  |  |
+
+## Example
+
+```ruby
+require 'kuapir'
+
+instance = Kuapir::Distribution.new(
+  type: PREMIERE,
+  sub_type: CINEMA,
+  date: 1999-05-07,
+  re_release: false,
+  country: null,
+  companies: null
+)
+```
+

data/docs/DistributionResponse.md

@@ -0,0 +1,20 @@
+# Kuapir::DistributionResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **total** | **Integer** |  |  |
+| **items** | [**Array<Distribution>**](Distribution.md) |  |  |
+
+## Example
+
+```ruby
+require 'kuapir'
+
+instance = Kuapir::DistributionResponse.new(
+  total: 5,
+  items: null
+)
+```
+

data/docs/Episode.md

@@ -0,0 +1,28 @@
+# Kuapir::Episode
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **season_number** | **Integer** |  |  |
+| **episode_number** | **Integer** |  |  |
+| **name_ru** | **String** |  |  |
+| **name_en** | **String** |  |  |
+| **synopsis** | **String** |  |  |
+| **release_date** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'kuapir'
+
+instance = Kuapir::Episode.new(
+  season_number: 1,
+  episode_number: 1,
+  name_ru: null,
+  name_en: Chapter One: The Vanishing of Will Byers,
+  synopsis: The Vanishing of Will Byers...,
+  release_date: 2016-07-15
+)
+```
+

data/docs/Fact.md

@@ -0,0 +1,22 @@
+# Kuapir::Fact
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **text** | **String** |  |  |
+| **type** | **String** |  |  |
+| **spoiler** | **Boolean** |  |  |
+
+## Example
+
+```ruby
+require 'kuapir'
+
+instance = Kuapir::Fact.new(
+  text: В эпизоде, где Тринити и Нео в поисках Морфиуса оказываются на крыше...,
+  type: BLOOPER,
+  spoiler: false
+)
+```
+

data/docs/FactResponse.md

@@ -0,0 +1,20 @@
+# Kuapir::FactResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **total** | **Integer** |  |  |
+| **items** | [**Array<Fact>**](Fact.md) |  |  |
+
+## Example
+
+```ruby
+require 'kuapir'
+
+instance = Kuapir::FactResponse.new(
+  total: 5,
+  items: null
+)
+```
+