my_api_client 0.15.0 → 0.19.0

data/.rubocop_challenge.yml

@@ -0,0 +1 @@
+---

data/.rubocop_todo.yml

@@ -1,7 +1,59 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2020-02-29 23:30:46 +0000 using RuboCop version 0.80.1.
+# on 2020-12-25 23:31:13 UTC using RuboCop version 1.7.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.
+
+# Offense count: 5
+# Configuration parameters: AllowComments, AllowEmptyLambdas.
+Lint/EmptyBlock:
+  Exclude:
+    - 'lib/my_api_client/rspec/matchers/be_handled_as_an_error.rb'
+    - 'spec/support/complete_about.rb'
+    - 'spec/support/complete_within.rb'
+
+# Offense count: 5
+Lint/MissingSuper:
+  Exclude:
+    - 'lib/my_api_client/error_handling/generator.rb'
+    - 'lib/my_api_client/error_handling/retry_option_processor.rb'
+    - 'lib/my_api_client/integrations/bugsnag.rb'
+    - 'lib/my_api_client/request/executor.rb'
+    - 'lib/my_api_client/sleeper.rb'
+
+# Offense count: 6
+# Configuration parameters: EnforcedStyle, CheckMethodNames, CheckSymbols, AllowedIdentifiers.
+# SupportedStyles: snake_case, normalcase, non_integer
+# AllowedIdentifiers: capture3, iso8601, rfc1123_date, rfc822, rfc2822, rfc3339
+Naming/VariableNumber:
+  Exclude:
+    - 'spec/lib/my_api_client/error_handling_spec.rb'
+    - 'spec/lib/my_api_client/request/executor_spec.rb'
+
+# Offense count: 60
+# Configuration parameters: AllowSubject.
+RSpec/MultipleMemoizedHelpers:
+  Max: 15
+
+# Offense count: 3
+Style/DocumentDynamicEvalDefinition:
+  Exclude:
+    - 'lib/my_api_client/config.rb'
+    - 'lib/my_api_client/request/basic.rb'
+    - 'lib/my_api_client/request/logger.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Style/HashTransformValues:
+  Exclude:
+    - 'lib/my_api_client/integrations/bugsnag.rb'
+
+# Offense count: 3
+# Cop supports --auto-correct.
+Style/StringConcatenation:
+  Exclude:
+    - 'lib/my_api_client/request.rb'
+    - 'lib/my_api_client/rspec/matchers/request_to.rb'
+    - 'my_api/app/controllers/pagination_controller.rb'

data/CHANGELOG.md

@@ -1,5 +1,176 @@
 # Change log
 
+## v0.19.0 (Jan 04, 2021)
+
+### Feature
+
+* [#402](https://github.com/ryz310/my_api_client/pull/402) Support ruby 3.0 and rails 6.1 ([@ryz310](https://github.com/ryz310))
+
+### Rubocop Challenge
+
+* [#400](https://github.com/ryz310/my_api_client/pull/400) Re-generate .rubocop_todo.yml with RuboCop v1.7.0 ([@ryz310](https://github.com/ryz310))
+
+### Dependabot
+
+* [#352](https://github.com/ryz310/my_api_client/pull/352) Bump jets from 2.3.17 to 2.3.18 in /my_api ([@ryz310](https://github.com/ryz310))
+* [#391](https://github.com/ryz310/my_api_client/pull/391) ryz310/dependabot/bundler/rubocop-1.6.1 ([@ryz310](https://github.com/ryz310))
+* [#392](https://github.com/ryz310/my_api_client/pull/392) ryz310/dependabot/bundler/my_api/puma-5.1.1 ([@ryz310](https://github.com/ryz310))
+* [#395](https://github.com/ryz310/my_api_client/pull/395) ryz310/dependabot/bundler/rubocop-rspec-2.1.0 ([@ryz310](https://github.com/ryz310))
+* [#396](https://github.com/ryz310/my_api_client/pull/396) ryz310/dependabot/bundler/webmock-3.11.0 ([@ryz310](https://github.com/ryz310))
+* [#398](https://github.com/ryz310/my_api_client/pull/398) ryz310/dependabot/bundler/rake-13.0.3 ([@ryz310](https://github.com/ryz310))
+* [#401](https://github.com/ryz310/my_api_client/pull/401) ryz310/dependabot/bundler/yard-0.9.26 ([@ryz310](https://github.com/ryz310))
+* [#403](https://github.com/ryz310/my_api_client/pull/403) ryz310/dependabot/bundler/jsonpath-1.1.0 ([@ryz310](https://github.com/ryz310))
+* [#404](https://github.com/ryz310/my_api_client/pull/404) Bump faraday from 1.2.0 to 1.3.0 ([@ryz310](https://github.com/ryz310))
+* [#406](https://github.com/ryz310/my_api_client/pull/406) ryz310/dependabot/bundler/rubocop-performance-1.9.2 ([@ryz310](https://github.com/ryz310))
+* [#407](https://github.com/ryz310/my_api_client/pull/407) Bump nokogiri from 1.10.10 to 1.11.0 in /my_api ([@ryz310](https://github.com/ryz310))
+* [#408](https://github.com/ryz310/my_api_client/pull/408) Bump nokogiri from 1.10.10 to 1.11.0 in /rails_app/rails_5.2 ([@ryz310](https://github.com/ryz310))
+* [#409](https://github.com/ryz310/my_api_client/pull/409) Bump nokogiri from 1.10.10 to 1.11.0 in /rails_app/rails_6.1 ([@ryz310](https://github.com/ryz310))
+* [#410](https://github.com/ryz310/my_api_client/pull/410) Bump nokogiri from 1.10.10 to 1.11.0 in /rails_app/rails_6.0 ([@ryz310](https://github.com/ryz310))
+
+## v0.18.0 (Dec 04, 2020)
+
+### Feature
+
+* [#381](https://github.com/ryz310/my_api_client/pull/381) Add endpoint option to the generator ([@ryz310](https://github.com/ryz310))
+
+### Breaking Change
+
+* [#365](https://github.com/ryz310/my_api_client/pull/365) End of support for ruby 2.4 and rails 4.2 ([@ryz310](https://github.com/ryz310))
+
+### Rubocop Challenge
+
+* [#383](https://github.com/ryz310/my_api_client/pull/383) Re-generate .rubocop_todo.yml with RuboCop v1.5.1 ([@ryz310](https://github.com/ryz310))
+
+### Dependabot
+
+* [#338](https://github.com/ryz310/my_api_client/pull/338) ryz310/dependabot/bundler/faraday-1.1.0 ([@ryz310](https://github.com/ryz310))
+* [#344](https://github.com/ryz310/my_api_client/pull/344) ryz310/dependabot/bundler/bugsnag-6.18.0 ([@ryz310](https://github.com/ryz310))
+* [#345](https://github.com/ryz310/my_api_client/pull/345) ryz310/dependabot/bundler/rspec-3.10.0 ([@ryz310](https://github.com/ryz310))
+* [#356](https://github.com/ryz310/my_api_client/pull/356) ryz310/dependabot/bundler/webmock-3.10.0 ([@ryz310](https://github.com/ryz310))
+* [#369](https://github.com/ryz310/my_api_client/pull/369) ryz310/dependabot/bundler/jsonpath-1.0.6 ([@ryz310](https://github.com/ryz310))
+* [#376](https://github.com/ryz310/my_api_client/pull/376) ryz310/dependabot/bundler/rubocop-performance-1.9.1 ([@ryz310](https://github.com/ryz310))
+* [#380](https://github.com/ryz310/my_api_client/pull/380) ryz310/dependabot/bundler/rubocop-rspec-2.0.1 ([@ryz310](https://github.com/ryz310))
+* [#382](https://github.com/ryz310/my_api_client/pull/382) ryz310/dependabot/bundler/rubocop-1.5.1 ([@ryz310](https://github.com/ryz310))
+
+## v0.17.0 (Sep 20, 2020)
+
+### Feature
+
+* [#303](https://github.com/ryz310/my_api_client/pull/303) Change the duration format to milliseconds ([@ryz310](https://github.com/ryz310))
+* [#308](https://github.com/ryz310/my_api_client/pull/308) Add testing for api client generators ([@ryz310](https://github.com/ryz310))
+
+### Rubocop Challenge
+
+* [#311](https://github.com/ryz310/my_api_client/pull/311) Style/GlobalStdStream-20200906233350 ([@ryz310](https://github.com/ryz310))
+* [#312](https://github.com/ryz310/my_api_client/pull/312) Style/StringConcatenation-20200907233020 ([@ryz310](https://github.com/ryz310))
+* [#313](https://github.com/ryz310/my_api_client/pull/313) Style/HashTransformValues-20200908233016 ([@ryz310](https://github.com/ryz310))
+* [#316](https://github.com/ryz310/my_api_client/pull/316) Layout/EmptyLinesAroundAttributeAccessor-20200909233021 ([@ryz310](https://github.com/ryz310))
+* [#320](https://github.com/ryz310/my_api_client/pull/320) Re-generate .rubocop_todo.yml with RuboCop v0.91.0 ([@ryz310](https://github.com/ryz310))
+
+### Dependabot
+
+* [#299](https://github.com/ryz310/my_api_client/pull/299) ryz310/dependabot/bundler/bugsnag-6.17.0 ([@ryz310](https://github.com/ryz310))
+* [#310](https://github.com/ryz310/my_api_client/pull/310) ryz310/dependabot/bundler/rubocop-performance-1.8.0 ([@ryz310](https://github.com/ryz310))
+* [#314](https://github.com/ryz310/my_api_client/pull/314) ryz310/dependabot/bundler/activesupport-5.2.4.4 ([@ryz310](https://github.com/ryz310))
+* [#315](https://github.com/ryz310/my_api_client/pull/315) ryz310/dependabot/bundler/my_api/actionview-6.0.3.3 ([@ryz310](https://github.com/ryz310))
+* [#318](https://github.com/ryz310/my_api_client/pull/318) ryz310/dependabot/bundler/webmock-3.9.1 ([@ryz310](https://github.com/ryz310))
+* [#319](https://github.com/ryz310/my_api_client/pull/319) ryz310/dependabot/bundler/rubocop-0.91.0 ([@ryz310](https://github.com/ryz310))
+* [#321](https://github.com/ryz310/my_api_client/pull/321) ryz310/dependabot/bundler/my_api/puma-5.0.0 ([@ryz310](https://github.com/ryz310))
+
+## v0.16.1 (Aug 27, 2020)
+
+### Feature
+
+* [#296](https://github.com/ryz310/my_api_client/pull/296) Support HTTP PUT method ([@ryz310](https://github.com/ryz310))
+
+### Rubocop Challenge
+
+* [#256](https://github.com/ryz310/my_api_client/pull/256) Performance/StartWith-20200523233027 ([@ryz310](https://github.com/ryz310))
+* [#268](https://github.com/ryz310/my_api_client/pull/268) Lint/RedundantCopDisableDirective-20200622233019 ([@ryz310](https://github.com/ryz310))
+* [#289](https://github.com/ryz310/my_api_client/pull/289) Re-generate .rubocop_todo.yml with RuboCop v0.89.1 ([@ryz310](https://github.com/ryz310))
+* [#293](https://github.com/ryz310/my_api_client/pull/293) RSpec/LeadingSubject-20200817233022 ([@ryz310](https://github.com/ryz310))
+
+### Dependabot
+
+* [#232](https://github.com/ryz310/my_api_client/pull/232) ryz310/dependabot/bundler/faraday-1.0.1 ([@ryz310](https://github.com/ryz310))
+* [#241](https://github.com/ryz310/my_api_client/pull/241) ryz310/dependabot/bundler/my_api/byebug-11.1.3 ([@ryz310](https://github.com/ryz310))
+* [#243](https://github.com/ryz310/my_api_client/pull/243) ryz310/dependabot/bundler/yard-0.9.25 ([@ryz310](https://github.com/ryz310))
+* [#248](https://github.com/ryz310/my_api_client/pull/248) ryz310/dependabot/bundler/activesupport-5.2.4.3 ([@ryz310](https://github.com/ryz310))
+* [#251](https://github.com/ryz310/my_api_client/pull/251) ryz310/dependabot/bundler/my_api/puma-4.3.5 ([@ryz310](https://github.com/ryz310))
+* [#257](https://github.com/ryz310/my_api_client/pull/257) ryz310/dependabot/bundler/my_api/dynomite-1.2.6 ([@ryz310](https://github.com/ryz310))
+* [#264](https://github.com/ryz310/my_api_client/pull/264) ryz310/dependabot/bundler/my_api/rack-2.2.3 ([@ryz310](https://github.com/ryz310))
+* [#265](https://github.com/ryz310/my_api_client/pull/265) ryz310/dependabot/bundler/my_api/actionpack-6.0.3.2 ([@ryz310](https://github.com/ryz310))
+* [#266](https://github.com/ryz310/my_api_client/pull/266) ryz310/dependabot/bundler/my_api/capybara-3.33.0 ([@ryz310](https://github.com/ryz310))
+* [#281](https://github.com/ryz310/my_api_client/pull/281) ryz310/dependabot/bundler/rubocop-performance-1.7.1 ([@ryz310](https://github.com/ryz310))
+* [#287](https://github.com/ryz310/my_api_client/pull/287) ryz310/dependabot/bundler/my_api/kramdown-2.3.0 ([@ryz310](https://github.com/ryz310))
+* [#290](https://github.com/ryz310/my_api_client/pull/290) ryz310/dependabot/bundler/bugsnag-6.16.0 ([@ryz310](https://github.com/ryz310))
+* [#294](https://github.com/ryz310/my_api_client/pull/294) ryz310/dependabot/bundler/my_api/jets-2.3.17 ([@ryz310](https://github.com/ryz310))
+* [#295](https://github.com/ryz310/my_api_client/pull/295) ryz310/dependabot/bundler/rubocop-rspec-1.43.2 ([@ryz310](https://github.com/ryz310))
+
+### Misc
+
+* [#271](https://github.com/ryz310/my_api_client/pull/271) Minor fixes ([@ryz310](https://github.com/ryz310))
+
+## v0.16.0 (Mar 29, 2020)
+
+### Breaking Change
+
+#### [#225](https://github.com/ryz310/my_api_client/pull/225) Raise an exception whenever an error is detected ([@ryz310](https://github.com/ryz310))
+
+Until now, using `with` or `block` in `error_handling` did not automatically raise an exception, but will now always raise an exception when an error is detected.
+You can specify raising error class with `raise` option.
+
+**Before**
+
+```rb
+error_handling json: { '$.errors.code': 10..19 }, with: :my_error_handling
+
+def my_error_handling
+  # Executes this method when an error is detected.
+  # No exception is raised. You can raise an error if necessary.
+end
+```
+```rb
+error_handling status_code: 500..599 do |_params, logger|
+  # Executes this block when an error is detected.
+  # No exception is raised. You can raise an error if necessary.
+end
+```
+
+**After**
+
+```rb
+error_handling json: { '$.errors.code': 10..19 }, with: :my_error_handling
+
+def my_error_handling
+  # Executes this method when an error is detected.
+  # And then raise `MyApiClient::Error`.
+end
+```
+```rb
+error_handling status_code: 500..599 do |params, logger|
+  # Executes this block when an error is detected.
+  # And then raise `MyApiClient::Error`.
+end
+```
+
+#### [#226](https://github.com/ryz310/my_api_client/pull/226) Default error handlers ([@ryz310](https://github.com/ryz310))
+
+Until now, you needed define all `error_handling` or `retry_on` yourself. But will now some `error_handling` and `retry_on` are prepared as default.
+
+You can check default `error_handling` or `retry_on` here.
+
+See: https://github.com/ryz310/my_api_client/blob/master/lib/my_api_client/default_error_handlers.rb
+
+### Dependabot
+
+* [#227](https://github.com/ryz310/my_api_client/pull/227) ryz310/dependabot/bundler/pry-byebug-3.9.0 ([@ryz310](https://github.com/ryz310))
+* [#228](https://github.com/ryz310/my_api_client/pull/228) ryz310/dependabot/bundler/my_api/jets-2.3.15 ([@ryz310](https://github.com/ryz310))
+
+### Misc
+
+* [#229](https://github.com/ryz310/my_api_client/pull/229) Edit dependabot configuration ([@ryz310](https://github.com/ryz310))
+
 ## v0.15.0 (Mar 21, 2020)
 
 ### Feature

data/Gemfile

@@ -4,9 +4,6 @@ source 'https://rubygems.org'
 
 git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
-# Workaound for ruby 2.4. Because activesupport v6.0.0 requires ruby 2.5 over.
-gem 'activesupport', '< 6.0.0'
-
 group :integrations, optional: true do
   gem 'bugsnag', '>= 6.11.0'
 end

data/Gemfile.lock

@@ -1,8 +1,8 @@
 PATH
   remote: .
   specs:
-    my_api_client (0.15.0)
-      activesupport (>= 4.2.0)
+    my_api_client (0.19.0)
+      activesupport (>= 5.2.0)
       faraday (>= 0.17.1)
       jsonpath
       sawyer (>= 0.8.2)
@@ -10,79 +10,87 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (5.2.4.2)
+    activesupport (6.1.0)
       concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
     addressable (2.7.0)
       public_suffix (>= 2.0.2, < 5.0)
-    ast (2.4.0)
-    bugsnag (6.13.0)
+    ast (2.4.1)
+    bugsnag (6.18.0)
       concurrent-ruby (~> 1.0)
-    byebug (11.1.1)
-    coderay (1.1.2)
-    concurrent-ruby (1.1.6)
-    crack (0.4.3)
-      safe_yaml (~> 1.0.0)
-    diff-lcs (1.3)
-    docile (1.3.2)
-    faraday (1.0.0)
+    byebug (11.1.3)
+    coderay (1.1.3)
+    concurrent-ruby (1.1.7)
+    crack (0.4.5)
+      rexml
+    diff-lcs (1.4.4)
+    docile (1.3.4)
+    faraday (1.3.0)
+      faraday-net_http (~> 1.0)
       multipart-post (>= 1.2, < 3)
+      ruby2_keywords
+    faraday-net_http (1.0.0)
     hashdiff (1.0.1)
-    i18n (1.8.2)
+    i18n (1.8.7)
       concurrent-ruby (~> 1.0)
-    jaro_winkler (1.5.4)
-    json (2.3.0)
-    jsonpath (1.0.5)
+    json (2.5.1)
+    jsonpath (1.1.0)
       multi_json
-      to_regexp (~> 0.2.1)
-    method_source (0.9.2)
-    minitest (5.14.0)
-    multi_json (1.14.1)
+    method_source (1.0.0)
+    minitest (5.14.2)
+    multi_json (1.15.0)
     multipart-post (2.1.1)
-    parallel (1.19.1)
-    parser (2.7.0.4)
-      ast (~> 2.4.0)
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    pry-byebug (3.8.0)
+    parallel (1.20.1)
+    parser (3.0.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.10)
-    public_suffix (4.0.3)
+      pry (~> 0.13.0)
+    public_suffix (4.0.6)
     rainbow (3.0.0)
-    rake (13.0.1)
+    rake (13.0.3)
+    regexp_parser (2.0.3)
     rexml (3.2.4)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.1)
-      rspec-support (~> 3.9.1)
-    rspec-expectations (3.9.1)
+    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.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.2)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.1)
     rspec_junit_formatter (0.4.1)
       rspec-core (>= 2, < 4, != 2.12.0)
-    rubocop (0.80.1)
-      jaro_winkler (~> 1.5.1)
+    rubocop (1.7.0)
       parallel (~> 1.10)
-      parser (>= 2.7.0.1)
+      parser (>= 2.7.1.5)
       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, < 1.7)
-    rubocop-performance (1.5.2)
-      rubocop (>= 0.71.0)
-    rubocop-rspec (1.38.1)
-      rubocop (>= 0.68.1)
-    ruby-progressbar (1.10.1)
-    safe_yaml (1.0.5)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (1.4.0)
+      parser (>= 2.7.1.5)
+    rubocop-performance (1.9.2)
+      rubocop (>= 0.90.0, < 2.0)
+      rubocop-ast (>= 0.4.0)
+    rubocop-rspec (2.1.0)
+      rubocop (~> 1.0)
+      rubocop-ast (>= 1.1.0)
+    ruby-progressbar (1.11.0)
+    ruby2_keywords (0.0.2)
     sawyer (0.8.2)
       addressable (>= 2.3.5)
       faraday (> 0.8, < 2.0)
@@ -91,22 +99,20 @@ GEM
       json (>= 1.8, < 3)
       simplecov-html (~> 0.10.0)
     simplecov-html (0.10.2)
-    thread_safe (0.3.6)
-    to_regexp (0.2.1)
-    tzinfo (1.2.6)
-      thread_safe (~> 0.1)
-    unicode-display_width (1.6.1)
-    webmock (3.8.3)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (1.7.0)
+    webmock (3.11.0)
       addressable (>= 2.3.6)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    yard (0.9.24)
+    yard (0.9.26)
+    zeitwerk (2.4.2)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  activesupport (< 6.0.0)
   bugsnag (>= 6.11.0)
   bundler (>= 2.0)
   my_api_client!
@@ -122,4 +128,4 @@ DEPENDENCIES
   yard
 
 BUNDLED WITH
-   2.1.2
+   2.2.3

data/README.jp.md

@@ -6,12 +6,14 @@ MyApiClient は API リクエストクラスを作成するための汎用的な
 
 ただし、 Sawyer はダミーデータの作成が難しかったり、他の gem で競合することがよくあるので、将来的には依存しないように変更していくかもしれません。
 
-また、 Ruby on Rails で利用することを想定してますが、それ以外の環境でも動作するように作っているつもりです。不具合などあれば Issue ページからご報告下さい。
+また、 Ruby on Rails で利用することを想定してますが、それ以外の環境でも動作するように作っています。不具合などあれば Issue ページからご報告下さい。
+
+[toc]
 
 ## Supported Versions
 
-* Ruby 2.4, 2.5, 2.6, 2.7
-* Rails 4.2, 5.0, 5.1, 5.2, 6.0
+* Ruby 2.5, 2.6, 2.7, 3.0
+* Rails 5.2, 6.0, 6.1
 
 ## Installation
 
@@ -24,7 +26,7 @@ gem 'my_api_client'
 Ruby on Rails を利用している場合は `generator` 機能を利用できます。
 
 ```sh
-$ rails g api_client path/to/resource get:path/to/resource
+$ rails g api_client path/to/resource get:path/to/resource --endpoint https://example.com
 
 create  app/api_clients/application_api_client.rb
 create  app/api_clients/path/to/resource_api_client.rb
@@ -147,30 +149,31 @@ end
 
 ### Error handling
 
-上記のコードにエラーハンドリングを追加してみます。
+`my_api_client` ではレスポンスの内容によって例外を発生させるエラーハンドリングを定義できます。ここでは例として前述のコードにエラーハンドリングを定義しています。
 
 ```ruby
 class ExampleApiClient < MyApiClient::Base
   endpoint 'https://example.com'
 
-  error_handling status_code: 400..499, raise: MyApiClient::ClientError
+  error_handling status_code: 400..499,
+                 raise: MyApiClient::ClientError
 
-  error_handling status_code: 500..599 do |params, logger|
+  error_handling status_code: 500..599, raise: MyApiClient::ServerError do |_params, logger|
     logger.warn 'Server error occurred.'
-    raise MyApiClient::ServerError, params
   end
 
-  error_handling json: { '$.errors.code': 10..19 }, with: :my_error_handling
+  error_handling json: { '$.errors.code': 10..19 },
+                 raise: MyApiClient::ClientError,
+                 with: :my_error_handling
 
   # Omission...
 
   private
 
-  # @param params [MyApiClient::Params::Params] HTTP req and res params
+  # @param params [MyApiClient::Params::Params] HTTP reqest and response params
   # @param logger [MyApiClient::Request::Logger] Logger for a request processing
   def my_error_handling(params, logger)
     logger.warn "Response Body: #{params.response.body.inspect}"
-    raise MyApiClient::ClientError, params
   end
 end
 ```
@@ -183,29 +186,26 @@ error_handling status_code: 400..499, raise: MyApiClient::ClientError
 
 これは `ExampleApiClient` からのリクエスト全てにおいて、レスポンスのステータスコードが `400..499` であった場合に `MyApiClient::ClientError` が例外として発生するようになります。 `ExampleApiClient` を継承したクラスにもエラーハンドリングは適用されます。ステータスコードのエラーハンドリングは親クラスで定義すると良いと思います。
 
-なお、 `status_code` には `Integer` `Range` `Regexp` が指定可能です。`raise` には `MyApiClient::Error` を継承したクラスが指定可能です。`my_api_client` で標準で定義しているエラークラスについては以下のソースコードをご確認下さい。
+なお、 `status_code` には `Integer` `Range` `Regexp` が指定可能です。
+
+`raise` には `MyApiClient::Error` を継承したクラスが指定可能です。`my_api_client` で標準で定義しているエラークラスについては以下のソースコードをご確認下さい。 `raise` を省略した場合は `MyApiClient::Error` を発生するようになります。
 
-https://github.com/ryz310/my_api_client/blob/master/lib/my_api_client/errors.rb
+https://github.com/ryz310/my_api_client/blob/master/lib/my_api_client/errors
 
-次に、 `raise` の代わりに `block` を指定する場合について。
+次に、 `block` を指定する場合について。
 
 ```ruby
-error_handling status_code: 500..599 do |params, logger|
+error_handling status_code: 500..599, raise: MyApiClient::ServerError do |_params, logger|
   logger.warn 'Server error occurred.'
-  raise MyApiClient::ServerError, params
 end
 ```
 
-上記の例であれば、ステータスコードが `500..599` の場合に `block` の内容が実行れます。引数の `params` にはリクエスト情報とレスポンス情報が含まれています。`logger` はログ出力用インスタンスですが、このインスタンスを使ってログ出力すると、以下のようにリクエスト情報がログ出力に含まれるようになり、デバッグの際に便利です。
+上記の例であれば、ステータスコードが `500..599` の場合に `MyApiClient::ServerError`  を発生させる前に `block` の内容が実行れます。引数の `params` にはリクエスト情報とレスポンス情報が含まれています。`logger` はログ出力用インスタンスですが、このインスタンスを使ってログ出力すると、以下のようにリクエスト情報がログ出力に含まれるようになり、デバッグの際に便利です。
 
 ```text
 API request `GET https://example.com/path/to/resouce`: "Server error occurred."
 ```
 
-リクエストに失敗した場合は例外処理を実行する、という設計が一般的だと思われるので、基本的にブロックの最後に `raise` を実行する事になると思います。
-
-最後に `json` と `with` を利用する場合について。
-
 ```ruby
 error_handling json: { '$.errors.code': 10..19 }, with: :my_error_handling
 ```
@@ -221,17 +221,28 @@ error_handling json: { '$.errors.code': 10..19 }, with: :my_error_handling
 }
 ```
 
-`with` にはインスタンスメソッド名を指定することで、エラーを検出した際に任意のメソッドを実行させることができます。メソッドに渡される引数は `block` 定義の場合と同じく `params` と `logger` です。
+`with` にはインスタンスメソッド名を指定することで、エラーを検出した際、例外を発生させる前に任意のメソッドを実行させることができます。メソッドに渡される引数は `block` 定義の場合と同じく `params` と `logger` です。なお、 `block` と `with` は同時には利用できません。
 
 ```ruby
 # @param params [MyApiClient::Params::Params] HTTP req and res params
 # @param logger [MyApiClient::Request::Logger] Logger for a request processing
 def my_error_handling(params, logger)
   logger.warn "Response Body: #{params.response.body.inspect}"
-  raise MyApiClient::ClientError, params
 end
 ```
 
+#### Default error handling
+
+`my_api_client` では、標準でステータスコード 400 ~ 500 番台のレスポンスを例外として処理するようにしています。ステータスコードが 400 番台場合は `MyApiClient::ClientError`、 500 番台の場合は `MyApiClient::ServerError` を継承した例外クラスが raise されます。
+
+また、 `MyApiClient::NetworkError` に対しても標準で `retry_on` が定義されています。
+
+いずれも override 可能ですので、必要に応じて `error_handling` を定義して下さい。
+
+以下のファイルで定義しています。
+
+https://github.com/ryz310/my_api_client/blob/master/lib/my_api_client/default_error_handlers.rb
+
 #### Symbol を利用する
 
 ```ruby
@@ -300,7 +311,9 @@ end
 
 API リクエストを何度も実行していると回線の不調などによりネットワークエラーが発生する事があります。長時間ネットワークが使えなくなるケースもありますが、瞬間的なエラーであるケースも多々あります。 `MyApiClient` ではネットワーク系の例外はまとめて `MyApiClient::NetworkError` として `raise` されます。この例外の詳細は後述しますが、 `retry_on` を利用する事で、 `ActiveJob` のように任意の例外処理を補足して、一定回数、一定の期間を空けて API リクエストをリトライさせる事ができます。
 
-ただし、 `ActiveJob` とは異なり同期処理でリトライするため、ネットワークの瞬断に備えたリトライ以外ではあまり使う機会はないのではないかと思います。上記の例のように API Limit に備えてリトライするケースもあるかと思いますが、こちらは `ActiveJob` で対応した方が良いと思います。
+なお、 `retry_on MyApiClient::NetworkError` は標準実装されているため、特別に定義せずとも自動的に適用されます。 `wait` や `attempts` に任意の値を設定したい場合のみ定義してご利用ください。
+
+ただし、 `ActiveJob` とは異なり同期処理でリトライするため、ネットワークの瞬断に備えたリトライ以外ではあまり使う機会はないのではないかと思います。上記の例のように API Rate Limit に備えてリトライするケースもあるかと思いますが、こちらは `ActiveJob` で対応した方が良いかもしれません。
 
 ちなみに一応 `discard_on` も実装していますが、作者自身が有効な用途を見出せていないので、詳細は割愛します。良い利用方法があれば教えてください。
 
@@ -629,6 +642,66 @@ rescue MyApiClient::Error => e
 end
 ```
 
+## Deployment
+
+この gem のリリースには [gem_comet](https://github.com/ryz310/gem_comet) を利用しています。
+`gem_comet` の README.md にも使い方が載っていますが、備忘録のため、こちらにもリリースフローを記載しておきます。
+
+### Preparement
+
+以下のコマンドで `.envrc` を作成し、 `GITHUB_ACCESS_TOKEN` を設定します。
+
+```sh
+$ cp .envrc.skeleton .envrc
+```
+
+以下のコマンドで `gem_comet` をインストールします。
+
+```sh
+$ gem install gem_comet
+```
+
+### USAGE
+
+以下のコマンドで、最後のリリースから現在までに merge した PR の一覧を確認できます。
+
+```sh
+$ gem_comet changelog
+```
+
+以下のコマンドで gem のリリースを実行します。
+`{VERSION}` には新しく付与するバージョン番号を指定します。
+
+```sh
+$ gem_comet release {VERSION}
+```
+
+実行すると、 https://github.com/ryz310/my_api_client/pulls に以下のような PR が作成されます。
+
+* [Update v0\.16\.1](https://github.com/ryz310/my_api_client/pull/297)
+* [Release v0\.16\.1](https://github.com/ryz310/my_api_client/pull/298)
+
+まず、 `Update v{VERSION}`  という PR から merge に取り掛かります。
+
+PR のコメントにも TODO が記載されていますが、まず、バージョン番号が正しく採番されているかを確認します。
+
+See: [314a4c0](https://github.com/ryz310/my_api_client/pull/297/commits/314a4c06f66324ce77b640b1ee8db5c84ee038a2)
+
+次に `CHANGELOG.md` を編集して、 CHANGELOG を見やすく整理します。
+
+See: [33a2d17](https://github.com/ryz310/my_api_client/pull/297/commits/33a2d1703c773813c837e74ee3181906b2f2e502)
+
+これらが整ったら、 `Update v{VERSION}`  を merge します。
+
+これでリリース準備が整ったので、`Release v{VERSION}`  の merge に取り掛かります。
+
+この PR にこれからリリースする gem に対する変更が全て載っています。
+変更内容の最終確認をして、 CI も通ったことを確認したら `Release v{VERSION}`  を merge します。
+
+あとは Circle CI 側で gem のリリースが自動実行されるので、暫く待ちましょう。
+
+お疲れさまでした :tea:
+
 ## Contributing
 
 不具合の報告や Pull Request を歓迎しています。OSS という事で自分はなるべく頑張って英語を使うようにしていますが、日本語での報告でも大丈夫です :+1: