carsensor 0.0.2.alpha.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d46313cda8c48a71f5f6b45c944163f821a7c88940ee0b2d3766f62c2a50cbf6
+  data.tar.gz: c5d01d78584693f3fdab26d66e645a1cbe821d9b419ef4c63477ff0c3448099e
+SHA512:
+  metadata.gz: 9859d0a0ccb5196cd3cc5541b4f7cff7748e594c6a1085edf8a0fbdf08762befd163225bcc60e9575ac6847f82d6a80e3b90186a3715e658a0cfc5b9338c491a
+  data.tar.gz: 9a32609e9235831c0c65abca9392e1b9ed2d07ff122ff8b0ac2c2e67c0736d46432e437a3ad64f90d1c6c5ed5d1cf8cc3b0f873d102472aa8aa032a9b7c036bc

data/.circleci/config.yml

@@ -0,0 +1,16 @@
+version: 2
+jobs:
+  build:
+    docker:
+      - image: circleci/ruby:2.6.0
+    steps:
+      - run: gem update bundler
+      - checkout
+      - restore_cache:
+          key: gem-cache-v1-{{ arch }}-{{ .Branch }}-{{ checksum "carsensor.gemspec" }}
+      - run: bin/setup
+      - save_cache:
+          key: gem-cache-v1-{{ arch }}-{{ .Branch }}-{{ checksum "carsensor.gemspec" }}
+          paths: vendor/bundle
+      - run: bin/rubocop
+      - run: bin/rake spec

data/.gitignore

@@ -0,0 +1,13 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+
+/Gemfile.lock

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,32 @@
+require:
+  - rubocop-rspec
+
+inherit_from:
+  - .rubocop/gemspec.yml
+  - .rubocop/layout.yml
+  - .rubocop/lint.yml
+  - .rubocop/metrics.yml
+  - .rubocop/rspec.yml
+  - .rubocop/security.yml
+  - .rubocop/style.yml
+  - .rubocop_todo.yml
+
+AllCops:
+  DisplayCopNames: true
+  DisplayStyleGuide: true
+  EnabledByDefault: true
+  Exclude:
+    - '*.gemspec'
+    - 'bin/*'
+    - 'vendor/bundle/**/*'
+    - 'spec/spec_helper.rb'
+  ExtraDetails: true
+  TargetRubyVersion: 2.6
+  UseCache: true
+
+# temporarily disabled stuff
+Metrics/LineLength:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: false

data/.rubocop/gemspec.yml

@@ -0,0 +1,2 @@
+Gemspec/OrderedDependencies:
+  Enabled: true

data/.rubocop/layout.yml

@@ -0,0 +1,57 @@
+Layout/ClassStructure:
+  Enabled: true
+  Categories:
+    module_inclusion:
+      - include
+      - prepend
+      - extend
+    ExpectedOrder:
+      - module_inclusion
+      - constants
+      - public_class_methods
+      - initializer
+      - public_methods
+      - protected_methods
+      - private_methods
+
+Layout/CommentIndentation:
+  Enabled: true
+
+Layout/EmptyLineAfterGuardClause:
+  Enabled: true
+
+Layout/EmptyLineAfterMagicComment:
+  Enabled: true
+
+Layout/EmptyLineBetweenDefs:
+  Enabled: true
+
+Layout/EmptyLines:
+  Enabled: true
+
+Layout/EmptyLinesAroundAccessModifier:
+  Enabled: true
+
+Layout/ExtraSpacing:
+  Enabled: true
+  AllowForAlignment: false
+
+Layout/IndentHeredoc:
+  Enabled: true
+
+Layout/LeadingCommentSpace:
+  Enabled: false
+
+Layout/SpaceAfterColon:
+  Enabled: true
+
+Layout/SpaceInsideBlockBraces:
+  Enabled: true
+  EnforcedStyle: space
+  EnforcedStyleForEmptyBraces: space
+  SpaceBeforeBlockParameters: false
+
+Layout/SpaceInsideHashLiteralBraces:
+  Enabled: true
+  EnforcedStyle: no_space
+  EnforcedStyleForEmptyBraces: no_space

data/.rubocop/lint.yml

@@ -0,0 +1,8 @@
+Lint/MissingCopEnableDirective:
+  Enabled: true
+
+Lint/NumberConversion:
+  Enabled: true
+
+Lint/UselessAssignment:
+  Enabled: true

data/.rubocop/metrics.yml

@@ -0,0 +1,13 @@
+Metrics/BlockLength:
+  Enabled: true
+  CountComments: false
+  ExcludedMethods:
+    - context
+    - describe
+    - namespace
+    - refine
+    - task
+
+Metrics/LineLength:
+  Enabled: true
+  IgnoreCopDirectives: true

data/.rubocop/rails.yml

@@ -0,0 +1,2 @@
+Rails:
+  Enabled: false

data/.rubocop/rspec.yml

@@ -0,0 +1,34 @@
+RSpec/AlignLeftLetBrace:
+  Enabled: false
+
+RSpec/AlignRightLetBrace:
+  Enabled: false
+
+RSpec/AnyInstance:
+  Enabled: true
+
+RSpec/ContextWording:
+  Enabled: true
+
+RSpec/DescribedClass:
+  Enabled: true
+  EnforcedStyle: explicit
+
+RSpec/EmptyLineAfterFinalLet:
+  Enabled: true
+
+RSpec/ExampleLength:
+  Enabled: true
+
+RSpec/LeadingSubject:
+  Enabled: true
+
+RSpec/LetBeforeExamples:
+  Enabled: true
+
+RSpec/NotToNot:
+  Enabled: true
+  EnforcedStyle: not_to
+
+RSpec/ScatteredLet:
+  Enabled: true

data/.rubocop/security.yml

@@ -0,0 +1,2 @@
+Security/MarshalLoad:
+  Enabled: true

data/.rubocop/style.yml

@@ -0,0 +1,91 @@
+Style/AccessModifierDeclarations:
+  Enabled: false
+
+Style/BlockDelimiters:
+  Enabled: true
+  EnforcedStyle: braces_for_chaining
+
+Style/CharacterLiteral:
+  Enabled: false
+
+Style/CollectionMethods:
+  Enabled: true
+
+Style/Copyright:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: true
+  Exclude:
+    - spec/**/*
+
+Style/ExpandPathArguments:
+  Enabled: true
+
+Style/FormatString:
+  Enabled: true
+  EnforcedStyle: percent
+
+Style/FormatStringToken:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+
+Style/GlobalVars:
+  Enabled: true
+
+Style/HashSyntax:
+  Enabled: true
+  EnforcedStyle: ruby19
+
+Style/LambdaCall:
+  EnforcedStyle: braces
+
+Style/MethodCalledOnDoEndBlock:
+  Enabled: true
+
+Style/MethodCallWithArgsParentheses:
+  Enabled: true
+  IgnoreMacros: true
+  IgnoredMethods:
+    # Language core
+    - raise
+    - require
+    # Rspec
+    - be
+    - describe
+    - expect
+    - include_context
+    - not_to
+    - shared_context
+    - to
+    # Rake
+    - task
+    # gem/bundler
+    - add_dependency
+    - add_development_dependency
+    - source
+
+Style/MutableConstant:
+  Enabled: true
+
+Style/PercentLiteralDelimiters:
+  Enabled: false
+
+Style/Semicolon:
+  Enabled: true
+  AllowAsExpressionSeparator: true
+
+Style/Send:
+  Enabled: true
+
+Style/StringHashKeys:
+  Enabled: false
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: single_quotes
+
+Style/UnneededPercentQ:
+  Enabled: true

data/.rubocop_todo.yml

@@ -0,0 +1,7 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config --no-auto-gen-timestamp`
+# using RuboCop version 0.62.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in carsensor.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 OZAWA Sakuro
+
+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,39 @@
+# Carsensor
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/carsensor/api`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'carsensor'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install carsensor
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/carsensor.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/bundle

@@ -0,0 +1,105 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'bundle' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "rubygems"
+
+m = Module.new do
+    module_function
+
+  def invoked_as_script?
+    File.expand_path($0) == File.expand_path(__FILE__)
+  end
+
+  def env_var_version
+    ENV["BUNDLER_VERSION"]
+  end
+
+  def cli_arg_version
+    return unless invoked_as_script? # don't want to hijack other binstubs
+    return unless "update".start_with?(ARGV.first || " ") # must be running `bundle update`
+    bundler_version = nil
+    update_index = nil
+    ARGV.each_with_index do |a, i|
+      if update_index && update_index.succ == i && a =~ Gem::Version::ANCHORED_VERSION_PATTERN
+        bundler_version = a
+      end
+      next unless a =~ /\A--bundler(?:[= ](#{Gem::Version::VERSION_PATTERN}))?\z/
+      bundler_version = $1 || ">= 0.a"
+      update_index = i
+    end
+    bundler_version
+  end
+
+  def gemfile
+    gemfile = ENV["BUNDLE_GEMFILE"]
+    return gemfile if gemfile && !gemfile.empty?
+
+    File.expand_path("../../Gemfile", __FILE__)
+  end
+
+  def lockfile
+    lockfile =
+      case File.basename(gemfile)
+      when "gems.rb" then gemfile.sub(/\.rb$/, gemfile)
+      else "#{gemfile}.lock"
+      end
+    File.expand_path(lockfile)
+  end
+
+  def lockfile_version
+    return unless File.file?(lockfile)
+    lockfile_contents = File.read(lockfile)
+    return unless lockfile_contents =~ /\n\nBUNDLED WITH\n\s{2,}(#{Gem::Version::VERSION_PATTERN})\n/
+    Regexp.last_match(1)
+  end
+
+  def bundler_version
+    @bundler_version ||= begin
+      env_var_version || cli_arg_version ||
+        lockfile_version || "#{Gem::Requirement.default}.a"
+    end
+  end
+
+  def load_bundler!
+    ENV["BUNDLE_GEMFILE"] ||= gemfile
+
+    # must dup string for RG < 1.8 compatibility
+    activate_bundler(bundler_version.dup)
+  end
+
+  def activate_bundler(bundler_version)
+    if Gem::Version.correct?(bundler_version) && Gem::Version.new(bundler_version).release < Gem::Version.new("2.0")
+      bundler_version = "< 2"
+    end
+    gem_error = activation_error_handling do
+      gem "bundler", bundler_version
+    end
+    return if gem_error.nil?
+    require_error = activation_error_handling do
+      require "bundler/version"
+    end
+    return if require_error.nil? && Gem::Requirement.new(bundler_version).satisfied_by?(Gem::Version.new(Bundler::VERSION))
+    warn "Activating bundler (#{bundler_version}) failed:\n#{gem_error.message}\n\nTo install the version of bundler this project requires, run `gem install bundler -v '#{bundler_version}'`"
+    exit 42
+  end
+
+  def activation_error_handling
+    yield
+    nil
+  rescue StandardError, LoadError => e
+    e
+  end
+end
+
+m.load_bundler!
+
+if m.invoked_as_script?
+  load Gem.bin_path("bundler", "bundle")
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "carsensor/api"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/rake

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rake", "rake")

data/bin/rspec

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rspec-core", "rspec")

data/bin/rubocop

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rubocop' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rubocop", "rubocop")

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/bin/yard

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'yard' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("yard", "yard")

data/bin/yardoc

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'yardoc' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("yard", "yardoc")

data/bin/yri

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'yri' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("yard", "yri")

data/carsensor.gemspec

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'carsensor/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'carsensor'
+  spec.version       = Carsensor::VERSION
+  spec.authors       = ['OZAWA Sakuro']
+  spec.email         = ['sakuro@2238.club']
+
+  spec.summary       = %q{Ruby binding to Carsensor API}
+  spec.description   = %q{Ruby binding to Carsensor API(https://webservice.recruit.co.jp/carsensor/reference.html)}
+  spec.homepage      = 'https://github.com/sakuro/carsensor'
+  spec.license       = 'MIT'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'rack'
+  spec.add_dependency 'retriable', '~> 3.1'
+  spec.add_dependency 'dry-struct'
+  spec.add_dependency 'dry-types', '~> 0.11.0'
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'pry-byebug'
+  spec.add_development_dependency 'rake', '>= 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'rubocop-rspec'
+  spec.add_development_dependency 'yard'
+  spec.add_development_dependency 'webmock'
+end

data/lib/carsensor.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'carsensor/api'
+require 'carsensor/types'

data/lib/carsensor/api.rb

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+require 'logger'
+require 'uri'
+require 'open-uri'
+require 'rack/utils'
+require 'retriable'
+
+module Carsensor
+  # A thin wrapper for Carsensor Web API at https://webservice.recruit.co.jp/carsensor/reference.html
+  class API
+    # Exception class for errors which would occur during invocation of Carsensor API
+    class Error < StandardError
+      # @param message [String] Message for the exception
+      # @param code [Integer,String] Error code of API itself or error status of HTTP
+      def initialize(message:, code: nil)
+        if code
+          super('%s(code: %s)' % [message, code])
+        else
+          super(message)
+        end
+      end
+    end
+
+    ENDPOINT_BASE_URI = URI('http://webservice.recruit.co.jp')
+
+    # A class for metadata of responses from Carsensor API
+    module Metadata
+      attr_accessor :metadata
+    end
+
+    # @param key [String] The API key
+    def initialize(key:, logger: Logger.new(STDOUT), tries: 3)
+      raise ArgumentError, 'key: must be a String' unless key.is_a?(String)
+
+      @key = key
+      @logger = logger
+      @tries = tries
+    end
+
+    # Returns bodies for given criterion
+    #
+    # @param query [Hash] options to specify criterion
+    # @return [Array<Hash>,Carsensor::API::Metadata] bodies and metadata
+    def bodies(**query)
+      call_api(:body, '/carsensor/body/v1', query)
+    end
+
+    # Returns brands for given criterion
+    #
+    # @param query [Hash] options to specify criterion
+    # @return [Array<Hash>,Carsensor::API::Metadata] brands and metadata
+    def brands(**query)
+      call_api(:brand, '/carsensor/brand/v1', query)
+    end
+
+    # Returns colors for given criterion
+    #
+    # @param query [Hash] options to specify criterion
+    # @return [Array<Hash>,Carsensor::API::Metadata] colors and metadata
+    def colors(**query)
+      call_api(:color, '/carsensor/color/v1', query)
+    end
+
+    # Returns countries for given criterion
+    #
+    # @param query [Hash] options to specify criterion
+    # @return [Array<Hash>,Carsensor::API::Metadata] countries and metadata
+    def countries(**query)
+      call_api(:country, '/carsensor/country/v1', query)
+    end
+
+    # Returns large areas for given criterion
+    #
+    # @param query [Hash] options to specify criterion
+    # @return [Array<Hash>,Carsensor::API::Metadata] large areas and metadata
+    def large_areas(**query)
+      call_api(:large_area, '/carsensor/large_area/v1', query)
+    end
+
+    # Returns prefectures for given criterion
+    #
+    # @param query [Hash] options to specify criterion
+    # @return [Array<Hash>,Carsensor::API::Metadata] prefectures and metadata
+    def prefectures(**query)
+      call_api(:pref, '/carsensor/pref/v1', query)
+    end
+
+    # Returns used cars for given criterion
+    #
+    # @param query [Hash] options to specify criterion
+    # @return [Array<Hash>,Carsensor::API::Metadata] used cars and metadata
+    def used_cars(**query)
+      call_api(:usedcar, '/carsensor/usedcar/v1', query)
+    end
+
+    # Returns number of total available used cars.
+    #
+    # @return [Integer] number of total available used cars
+    def total_available
+      area_codes = large_areas.map {|area| area[:code] }
+      area_codes.sort!
+      used_cars(large_area: area_codes.join(','), start: 1, count: 1).metadata[:results_available]
+    end
+
+    private
+
+    def call_api(root, path, **query)
+      Retriable.retriable(tries: @tries, on: [Error], on_retry: on_retry_proc(path, query)) do
+        (method(:build_uri) >> method(:read_uri) >> method(:parse_body) >> method(:extract_result).curry[root]).(path, query)
+      end
+    end
+
+    def on_retry_proc(path, **query)
+      lambda do |exception, _try, _elapsed_time, _next_interval|
+        return unless @logger
+
+        @logger.info(retry_message(exception, path, query))
+      end
+    end
+
+    def retry_message(exception, path, **query)
+      query_string = build_query_string(query)
+      request = query_string.length.zero? ? path : path + '?' + query_string
+      '%s %s %s' % [exception.class, exception.message, request]
+    end
+
+    def build_query_string(**query)
+      Rack::Utils.build_query(key: @key, format: 'json', **query.transform_values {|v| v.is_a?(Array) ? v.join(',') : v })
+    end
+
+    def build_uri(path, **query)
+      ENDPOINT_BASE_URI.dup.tap do |u|
+        u.path = path
+        u.query = build_query_string(query)
+      end
+    end
+
+    def read_uri(uri)
+      uri.read
+    rescue OpenURI::HTTPError => e
+      status = e.io.status
+      raise Error.new(message: status[1], code: status[0])
+    rescue SocketError => e
+      raise Error.new(message: e.message)
+    end
+
+    def parse_body(body)
+      JSON.parse(body, symbolize_names: true).tap do |data|
+        api_error = data.dig(:results, :error, 0)
+        raise Error.new(**api_error) if api_error
+      end
+    rescue JSON::ParserError => e
+      raise Error.new(message: e.message)
+    end
+
+    def extract_result(root, data)
+      (data.dig(:results, root) || []).tap do |result|
+        result.extend(Metadata)
+        result.metadata = extract_metadata(data).freeze
+      end
+    end
+
+    def extract_metadata(data)
+      %i[api_version results_available results_returned results_start].each_with_object({}) do |field, metadata|
+        metadata[field] = extract_metadata_field(data, field)
+      end
+    end
+
+    def extract_metadata_field(data, field)
+      value = data.dig(:results, field)
+      field.match?(/\Aresults_/) && !value.is_a?(Integer) ? Integer(value, 10) : value # rubocop:disable Performance/StartWith
+    end
+  end
+end

data/lib/carsensor/types.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require 'dry-struct'
+require 'dry-types'
+
+module Carsensor
+  # Types for datas obtained via Carsensor API
+  module Types
+    include Dry::Types.module
+
+    # Type of body
+    class Body < Dry::Struct
+      attribute :name, Types::String.constrained(min_size: 1)
+      attribute :code, Types::String.constrained(size: 1)
+    end
+
+    # Type of country
+    class Country < Dry::Struct
+      attribute :name, Types::String.constrained(min_size: 1)
+      attribute :code, Types::String.constrained(size: 3)
+    end
+
+    # Type of brand
+    class Brand < Dry::Struct
+      attribute :name, Types::String.constrained(min_size: 1)
+      attribute :code, Types::String.constrained(size: 2)
+    end
+
+    # Type of color
+    class Color < Dry::Struct
+      attribute :name, Types::String.constrained(min_size: 1)
+      attribute :code, Types::String.constrained(size: 2)
+    end
+
+    # Type of large_area
+    class LargeArea < Dry::Struct
+      attribute :name, Types::String.constrained(min_size: 1)
+      attribute :code, Types::String.constrained(size: 1)
+    end
+
+    # Type of pref
+    class Prefecture < Dry::Struct
+      attribute :name, Types::String.constrained(min_size: 3)
+      attribute :code, Types::String.constrained(size: 2)
+    end
+
+    # Type of shop
+    class Shop < Dry::Struct
+      attribute :name, Types::String.constrained(min_size: 1)
+      attribute :pref, Prefecture
+      attribute :lat, Types::Coercible::Float
+      attribute :lng, Types::Coercible::Float
+      attribute :datum, String
+    end
+
+    # Type of photo/main
+    class Photo_Main < Dry::Struct # rubocop:disable Naming/ClassAndModuleCamelCase
+      attribute :l, Types::String
+      attribute :s, Types::String
+      attribute :caption, Types::String
+    end
+
+    # Type of photo
+    class Photo < Dry::Struct
+      attribute :main, Photo_Main
+      attribute :sub, Types::Array.of(Types::String)
+    end
+
+    # Type of sub_img
+    class SubImg < Dry::Struct
+      attribute :l, Types::String
+      attribute :caption, Types::String
+    end
+
+    # Type of urls
+    class Urls < Dry::Struct
+      attribute :pc, Types::String
+      attribute :mobile, Types::String
+      attribute :qr, Types::String
+    end
+
+    # TYpe of usedcar
+    class UsedCar < Dry::Struct
+      attribute :id, Types::String.constrained(min_size: 1)
+      attribute :brand, Brand
+      attribute :model, Types::String
+      attribute :grade, Types::String
+      attribute :price, Types::String
+      attribute :inspection, Types::String
+      attribute :maintenance, Types::String
+      attribute :warranty, Types::String
+      attribute :recycle, Types::String
+      attribute :engine, Types::String
+      attribute :desc, Types::String
+      attribute :body, Body
+      attribute :odd, Types::String
+      attribute :year, Types::String
+      attribute :shop, Shop
+      attribute :color, Types::String
+      attribute :maintenance_comment, Types::String
+      attribute :maintenance_fee, Types::String
+      attribute :photo, Photo
+      attribute :sub_img, Types::Array.of(SubImg)
+      attribute :urls, Urls
+      attribute :warranty_comment, Types::String
+      attribute :warranty_distance, Types::String
+      attribute :warranty_length, Types::String
+      attribute :warranty_fee, Types::String
+    end
+  end
+end

data/lib/carsensor/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Carsensor
+  VERSION = '0.0.2.alpha.1'
+end

data/vendor/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

metadata

@@ -0,0 +1,243 @@
+--- !ruby/object:Gem::Specification
+name: carsensor
+version: !ruby/object:Gem::Version
+  version: 0.0.2.alpha.1
+platform: ruby
+authors:
+- OZAWA Sakuro
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2019-01-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: retriable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: dry-struct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dry-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  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'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  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'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  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'
+- !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'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  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: Ruby binding to Carsensor API(https://webservice.recruit.co.jp/carsensor/reference.html)
+email:
+- sakuro@2238.club
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".circleci/config.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".rubocop/gemspec.yml"
+- ".rubocop/layout.yml"
+- ".rubocop/lint.yml"
+- ".rubocop/metrics.yml"
+- ".rubocop/rails.yml"
+- ".rubocop/rspec.yml"
+- ".rubocop/security.yml"
+- ".rubocop/style.yml"
+- ".rubocop_todo.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/bundle
+- bin/console
+- bin/rake
+- bin/rspec
+- bin/rubocop
+- bin/setup
+- bin/yard
+- bin/yardoc
+- bin/yri
+- carsensor.gemspec
+- lib/carsensor.rb
+- lib/carsensor/api.rb
+- lib/carsensor/types.rb
+- lib/carsensor/version.rb
+- vendor/.gitignore
+homepage: https://github.com/sakuro/carsensor
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubygems_version: 3.0.1
+signing_key: 
+specification_version: 4
+summary: Ruby binding to Carsensor API
+test_files: []