f_http_client 0.2.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 043b1047145e6431224027e68000eb4397224d1cd36da84766fa272aa9b472a2
-  data.tar.gz: 660c261f27d5654909d338729ed8a8ad5166ec1038c978f05b3ba2ef6c0c0242
+  metadata.gz: 7bc7ea9df893eeb1677e578522732aba2ae7f6b4613bdd7621a5ab1e4686f48a
+  data.tar.gz: f471ba64951044aab190a13e29f93da1858c45c32d225268f23a4dd4324edde4
 SHA512:
-  metadata.gz: 46118f4a70d1715d4c0fe3c86243f8ca80ccf2248c4c257b4b7ba69b3b3d089d6481e92299dcbf84f9675aacd5f8729a4df68037b156213dbcf4f32fc0cb35f8
-  data.tar.gz: 146d096e199781aee21e17054994c93d9961886a454bc4bdbcabb45f9b0a4a12060c5d3149d991ff4b54ca1c96ee73320bcbd35d81114d91635c61ed690a1bba
+  metadata.gz: 2560bfd3e0954a0fa58dc416a76a6018ce3acd41afdb808f04742a56495aae7ee975c87421aeb2f5fd2d95762a8d616a6554653ff5210c06eeb5530d4a6a7c2e
+  data.tar.gz: '058d4e67c2ce215ebaa7cddf3fed92a2b964e962530849eb854c7c4af73528352aa4ee5341cb72a3531f11ae9618f6fa15df40691eccae767585ffb07484669b'

data/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.4.0"
+}

data/.rubocop.yml

@@ -1,9 +1,10 @@
-require:
+plugins:
   - rubocop-rspec
   - rubocop-performance
+  - rubocop-vicenzo
 
 AllCops:
-  TargetRubyVersion: 3.0
+  TargetRubyVersion: 3.2
   SuggestExtensions: false
   NewCops: enable
   CacheRootDirectory: tmp
@@ -15,6 +16,14 @@ AllCops:
 
 ##### LAYOUT #####
 
+Layout/ArgumentAlignment:
+  Enabled: true
+  EnforcedStyle: with_fixed_indentation
+
+Layout/FirstArgumentIndentation:
+  Enabled: true
+  EnforcedStyle: consistent
+
 Layout/FirstArrayElementIndentation:
   Enabled: true
   EnforcedStyle: consistent
@@ -23,10 +32,44 @@ Layout/FirstHashElementIndentation:
   Enabled: true
   EnforcedStyle: consistent
 
+Layout/FirstMethodArgumentLineBreak:
+  Enabled: true
+
 Layout/LineLength:
   Max: 120
   AllowedPatterns: ['(\A|\s)#']
 
+Layout/MultilineMethodArgumentLineBreaks:
+  Enabled: true
+
+Layout/MultilineMethodCallBraceLayout:
+  Enabled: true
+  EnforcedStyle: new_line
+
+Layout/MultilineMethodCallIndentation:
+  Enabled: true
+  EnforcedStyle: indented
+
+Layout/FirstArrayElementLineBreak:
+  Enabled: true
+
+Layout/MultilineArrayLineBreaks:
+  Enabled: true
+
+Layout/MultilineArrayBraceLayout:
+  Enabled: true
+  EnforcedStyle: new_line
+
+Layout/FirstHashElementLineBreak:
+  Enabled: true
+
+Layout/MultilineHashKeyLineBreaks:
+  Enabled: true
+
+Layout/MultilineHashBraceLayout:
+  Enabled: true
+  EnforcedStyle: new_line
+
 ##### STYLE #####
 
 Style/PreferredHashMethods:
@@ -57,9 +100,6 @@ Style/LambdaCall:
 Style/Documentation:
   Enabled: false
 
-Style/ClassAndModuleChildren:
-  Enabled: false
-
 ##### LINT #####
 
 Lint/MissingSuper:
@@ -70,7 +110,7 @@ Lint/MissingSuper:
 Naming/InclusiveLanguage:
   Enabled: false
 
-Naming/PredicateName:
+Naming/PredicatePrefix:
   ForbiddenPrefixes:
     - is_
     - have_
@@ -110,12 +150,38 @@ RSpec/ContextWording:
 RSpec/ExampleLength:
   Max: 20
 
-RSpec/FilePath:
-  CustomTransform:
-    FHTTPClient: f_http_client
+RSpec/MultipleExpectations:
+  Exclude:
+    - 'spec/f_http_client/rspec/matchers/**/*'
+
+  # This directory contains specs for custom RSpec matchers.
+  # These examples intentionally use nested `expect { ... }.to raise_error(...)`
+  # to assert on matcher failure messages, which inherently requires more than
+  # one `expect` per example and conflicts with the MultipleExpectations cop.
+  #
+  # Using `:aggregate_failures` here is not an option, because it captures the
+  # inner expectation failure and re-raises an aggregated error, so the outer
+  # `raise_error` matcher no longer sees the original `ExpectationNotMetError`
+  # and the specs for the failure messages become impossible to express.
 
 RSpec/MultipleMemoizedHelpers:
   Enabled: false
 
 RSpec/NestedGroups:
   Enabled: false
+
+RSpec/SpecFilePathFormat:
+  CustomTransform:
+    FHTTPClient: f_http_client
+
+##### RUBYGEMS #####
+Gemspec/RequireMFA:
+  Enabled: false
+
+##### Vicenzo #####
+
+Vicenzo/Style/MultilineMethodCallParentheses:
+  AllowedMethods:
+    - to
+    - not_to
+    - to_not

data/CHANGELOG.md

@@ -1,4 +1,21 @@
-## [Unreleased]
+# Changelog
+
+## [0.4.0](https://github.com/Fretadao/f_http_client/compare/v0.3.0...v0.4.0) (2026-08-20)
+
+
+### ⚠ BREAKING CHANGES
+
+* the FService matchers compare the type list for equality, so specs asserting have_failed_with(:unprocessable_entity, :client_error) now need have_failed_with(:unprocessable_content, :unprocessable_entity, :client_error). Runtime is unaffected — on_failure matches by inclusion. Seven specs across apps/router and apps/web need this adjustment.
+
+### Features
+
+* expose RFC 9110 status type aliases for 422 and 413 [CU-86ak35ptc] ([#37](https://github.com/Fretadao/f_http_client/issues/37)) ([277ac96](https://github.com/Fretadao/f_http_client/commit/277ac966c1aad874839445066cc251d2f3ea09e5))
+
+## [0.3.0] - 2026-08-19
+
+- Add `f_http_client_response_including` RSpec matcher for testing HTTParty::Response objects with nested matchers
+- Fix Ruby 4.0+ compatibility by adding activesupport >= 7.2, ostruct, and csv dependencies
+- Change Disable rubygems MFA checking #14
 
 ## [0.2.1] - 2023-09-27
 

data/CONTRIBUTING.md

@@ -0,0 +1,92 @@
+# Contributing
+
+## Development setup
+
+Run `bin/setup` once after cloning. It installs dependencies and points
+`core.hooksPath` at `.githooks/`, enabling a `commit-msg` hook that enforces
+Conventional Commits locally.
+
+Run the linter and the tests the same way CI does:
+
+```bash
+bundle exec rubocop -c .rubocop.yml --parallel
+bundle exec rspec -fp
+```
+
+## Commit messages — Conventional Commits
+
+This project follows [Conventional Commits](https://www.conventionalcommits.org/).
+The version bump and the `CHANGELOG.md` are generated automatically from commit
+messages, so the prefix matters:
+
+| Type | When to use | Release effect |
+|------|-------------|----------------|
+| `feat:` | New capability | minor bump |
+| `fix:` | Bug fix | patch bump |
+| `feat!:` or a `BREAKING CHANGE:` footer | Backwards-incompatible change | minor bump while `0.x`, major from `1.0` on |
+| `chore:` `ci:` `docs:` `style:` `test:` `refactor:` | Maintenance | no release |
+
+Pull requests are squash-merged, so **the PR title becomes the commit message**
+release-please reads. Get the title right even when the individual commits are
+messy.
+
+> One thing to keep in mind when changing result types: the FService matchers
+> compare the type list for **equality**, not inclusion. Adding a type to an
+> existing result — say a second alias for a status — breaks every consuming spec
+> that matches the exact list (`have_failed_with(:conflict, :client_error)`), even
+> though `on_failure(:conflict)` hooks keep working. Treat it as a breaking change.
+
+## Releasing (release-please)
+
+Releases are automated with [release-please](https://github.com/googleapis/release-please);
+there is no version to edit and no tag to create by hand.
+
+1. Every push to `master` creates or updates a **release PR** titled
+   `chore(master): release X.Y.Z`. It bumps `lib/f_http_client/version.rb`,
+   `.release-please-manifest.json` and `Gemfile.lock`, and updates `CHANGELOG.md`
+   from the Conventional Commits made since the last release.
+2. **Do not edit `CHANGELOG.md` by hand.** release-please owns it.
+3. **Merging the release PR** creates the git tag `vX.Y.Z` and a GitHub Release.
+   That triggers `.github/workflows/publish.yml`, which publishes the gem to
+   RubyGems through [Trusted Publishing](https://guides.rubygems.org/trusted-publishing/)
+   — OIDC, with no API key stored in this repository. Consumers resolve it normally:
+
+   ```ruby
+   gem 'f_http_client', '~> 0.3'
+   ```
+
+4. The release PR always reflects **everything on `master` since the last
+   release**. Cut releases promptly: merge the release PR before landing
+   unrelated work you don't want included.
+
+> Why this exists: 0.3.0 was published to RubyGems in February 2026, but the tag
+> `v0.3.0` was never created — the newest tag is still `v0.2.1`, from 2023. So the
+> released code has no reference point in git: no compare link, no way to check out
+> what shipped. Nothing in the manual process caught that, and it had happened
+> silently for a whole release.
+
+## If the release PR is failing
+
+release-please only rebuilds the release branch when a **releasable** commit
+(`feat:` / `fix:`) lands on `master`. Non-releasable commits (`chore:`, `ci:`,
+`docs:`, `style:`, `test:`) do **not** rebuild it, so the release branch can fall
+behind `master` and its CI can run stale code.
+
+When the release PR's CI is red:
+
+1. Push the fix to `master` through a normal PR. **Never** push directly to the
+   `release-please--…` branch — release-please overwrites it.
+2. If those fix commits are non-releasable (so the release PR won't refresh on its
+   own), **close the release PR and delete its branch**. On the next push to
+   `master`, release-please recreates it from the current `master`.
+3. Merge the freshly recreated release PR.
+
+Never manually rebase or force-push the release-please branch.
+
+## If the gem was not published
+
+The tag and the GitHub Release already exist, so publishing is retryable: fix the
+cause and use **Re-run jobs** on the failed `Publish gem` workflow run. An
+authentication failure points at the trusted publisher registration on RubyGems
+(the repository and the workflow filename must match `publish.yml`), not at the
+workflow itself.

data/Gemfile

@@ -6,12 +6,17 @@ source 'https://rubygems.org'
 gemspec
 
 group :development do
+  gem 'benchmark' # Required by rubocop on Ruby 4+
+  gem 'racc' # Required by parser on Ruby 4+
   gem 'rubocop'
   gem 'rubocop-performance'
   gem 'rubocop-rspec'
+  gem 'rubocop-vicenzo'
 end
 
 group :test do
+  gem 'csv' # Required by httparty on Ruby 4+ (moved from stdlib)
+  gem 'ostruct' # Required by simplecov on Ruby 4+ (moved from stdlib)
   gem 'rspec', '~> 3.0'
   gem 'simplecov'
   gem 'webmock'
@@ -20,5 +25,5 @@ end
 group :development, :test do
   gem 'pry'
   gem 'pry-nav'
-  gem 'rake', '~> 13.0'
+  gem 'rake', '~> 13.4'
 end

data/Gemfile.lock

@@ -1,8 +1,8 @@
 PATH
   remote: .
   specs:
-    f_http_client (0.2.1)
-      activesupport
+    f_http_client (0.4.0)
+      activesupport (>= 7.2)
       addressable
       dry-configurable
       dry-initializer
@@ -12,113 +12,150 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.0.8)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+    activesupport (8.1.3.1)
+      base64
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
       i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
       minitest (>= 5.1)
-      tzinfo (~> 2.0)
-    addressable (2.8.1)
-      public_suffix (>= 2.0.2, < 6.0)
-    ast (2.4.2)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
+    ast (2.4.3)
+    base64 (0.3.0)
+    benchmark (0.5.0)
+    bigdecimal (4.1.2)
     coderay (1.1.3)
-    concurrent-ruby (1.2.2)
-    crack (0.4.5)
+    concurrent-ruby (1.3.8)
+    connection_pool (3.0.2)
+    crack (1.0.1)
+      bigdecimal
       rexml
-    diff-lcs (1.5.0)
-    docile (1.4.0)
-    dry-configurable (1.1.0)
-      dry-core (~> 1.0, < 2)
+    csv (3.3.6)
+    diff-lcs (1.6.2)
+    drb (2.2.3)
+    dry-configurable (1.3.0)
+      dry-core (~> 1.1)
       zeitwerk (~> 2.6)
-    dry-core (1.0.1)
+    dry-core (1.2.0)
       concurrent-ruby (~> 1.0)
+      logger
       zeitwerk (~> 2.6)
-    dry-initializer (3.1.1)
-    f_service (0.3.0)
-    hashdiff (1.0.1)
-    httparty (0.21.0)
+    dry-initializer (3.2.0)
+    f_service (0.4.1)
+    hashdiff (1.2.1)
+    httparty (0.24.2)
+      csv
       mini_mime (>= 1.0.0)
       multi_xml (>= 0.5.2)
-    i18n (1.14.1)
+    i18n (1.15.2)
       concurrent-ruby (~> 1.0)
-    json (2.6.3)
-    method_source (1.0.0)
+    json (2.21.2)
+    language_server-protocol (3.17.0.6)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    method_source (1.1.0)
     mini_mime (1.1.5)
-    minitest (5.20.0)
-    multi_xml (0.6.0)
-    parallel (1.22.1)
-    parser (3.2.1.0)
+    minitest (6.0.6)
+      drb (~> 2.0)
+      prism (~> 1.5)
+    multi_xml (0.8.1)
+      bigdecimal (>= 3.1, < 5)
+    ostruct (0.6.3)
+    parallel (1.28.0)
+    parser (3.3.12.0)
       ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
     pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
     pry-nav (1.0.0)
       pry (>= 0.9.10, < 0.15)
-    public_suffix (5.0.1)
+    public_suffix (7.0.5)
+    racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.0.6)
-    regexp_parser (2.7.0)
-    rexml (3.2.5)
-    rspec (3.12.0)
-      rspec-core (~> 3.12.0)
-      rspec-expectations (~> 3.12.0)
-      rspec-mocks (~> 3.12.0)
-    rspec-core (3.12.1)
-      rspec-support (~> 3.12.0)
-    rspec-expectations (3.12.2)
+    rake (13.4.2)
+    regexp_parser (2.12.0)
+    rexml (3.4.4)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-mocks (3.12.3)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.7)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-support (3.12.0)
-    rubocop (1.45.1)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rubocop (1.89.0)
       json (~> 2.3)
-      parallel (~> 1.10)
-      parser (>= 3.2.0.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (>= 1.10)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.24.1, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.26.0)
-      parser (>= 3.2.1.0)
-    rubocop-capybara (2.17.1)
-      rubocop (~> 1.41)
-    rubocop-performance (1.16.0)
-      rubocop (>= 1.7.0, < 2.0)
-      rubocop-ast (>= 0.4.0)
-    rubocop-rspec (2.18.1)
-      rubocop (~> 1.33)
-      rubocop-capybara (~> 2.17)
-    ruby-progressbar (1.11.0)
-    simplecov (0.22.0)
-      docile (~> 1.1)
-      simplecov-html (~> 0.11)
-      simplecov_json_formatter (~> 0.1)
-    simplecov-html (0.12.3)
-    simplecov_json_formatter (0.1.4)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.50.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-performance (1.27.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.89.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    rubocop-rspec (3.10.2)
+      lint_roller (~> 1.1)
+      regexp_parser (>= 2.0)
+      rubocop (~> 1.86, >= 1.86.2)
+    rubocop-vicenzo (0.6.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.2)
+      rubocop-rspec (>= 3.5.0)
+    ruby-progressbar (1.13.0)
+    securerandom (0.4.1)
+    simplecov (1.1.1)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (2.4.2)
-    webmock (3.18.1)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+    webmock (3.26.2)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    zeitwerk (2.6.12)
+    zeitwerk (2.7.4)
 
 PLATFORMS
+  x86_64-darwin-24
   x86_64-linux
 
 DEPENDENCIES
+  benchmark
+  csv
   f_http_client!
+  ostruct
   pry
   pry-nav
-  rake (~> 13.0)
+  racc
+  rake (~> 13.4)
   rspec (~> 3.0)
   rubocop
   rubocop-performance
   rubocop-rspec
+  rubocop-vicenzo
   simplecov
   webmock
 

data/README.md

@@ -93,13 +93,44 @@ Result examples:
 ```rb
 Person::Create.(name: 'Joe Vicenzo', birthdate: '2000-01-01')
   .and_then { |user| return redirect_to users_path(user.id) }
-  .on_failure(:unprocessable_entity) { |errors| return render_action :new, locals: { errors: errors } }
+  .on_failure(:unprocessable_content) { |errors| return render_action :new, locals: { errors: errors } }
   .on_failure(:client_error) { |errors| render_action :new, warning: errors }
   .on_failure(:server_error) { |error| render_action :new, warning: ['Try again latter.'] }
   .on_failure(:server_error) { |error| render_action :new, warning: ['Server is busy. Try again latter.'] }
   .on_failure { |_error, type| render_action :new, warning: ["Unexpected error. Contact admin and talk about #{type} error."] }
 ```
 
+### Status names renamed by RFC 9110
+
+The failure/success type comes from the `Net::HTTPResponse` class name, which still carries the
+pre-RFC 9110 names for two status codes. Rack 3.1+ — and therefore every Rails app — already
+canonicalized them. For those two codes the result carries **both** symbols as types, canonical
+first, so either name matches:
+
+| Status | Canonical type (Rack 3.1+) | Legacy type (still matches) |
+|--------|----------------------------|-----------------------------|
+| 422    | `:unprocessable_content`   | `:unprocessable_entity`     |
+| 413    | `:content_too_large`       | `:payload_too_large`        |
+
+```rb
+# A 422 response yields the types below, in this order:
+# [:unprocessable_content, :unprocessable_entity, :client_error]
+
+Person::Create.(name: 'Joe Vicenzo')
+  .on_failure(:unprocessable_content) { |errors| render_action :new, locals: { errors: errors } }
+  .on_failure(:unprocessable_entity) { |errors| render_action :new, locals: { errors: errors } }
+```
+
+Prefer the canonical name: an untyped `on_failure` receives it as the `type`, and the legacy one is
+kept only to ease the migration — it will be dropped in a future major release.
+
+If you assert on types with the FService matchers, note that `have_failed_with` compares the whole
+type list, so specs covering those two codes need the full trio:
+
+```rb
+expect(result).to have_failed_with(:unprocessable_content, :unprocessable_entity, :client_error)
+```
+
 This gem uses the gem [HTTParty](https://github.com/jnunemaker/httparty) as base to perform requests.
 Then we can use any [example](https://github.com/jnunemaker/httparty/tree/master/examples) to implements the method make_request, for GET, POST, PUT, etc.
 The class *FHTTPClient::Base* provides the following options to help building the request:
@@ -109,6 +140,47 @@ The class *FHTTPClient::Base* provides the following options to help building th
 - *options*: can be used provide any other option for HTTParty;
 - *path_params*, can be used to fills params which is in the request path.
 
+## RSpec Matchers
+
+### `f_http_client_response_including`
+
+Tests HTTParty::Response objects with support for nested RSpec matchers.
+
+```rb
+require 'f_http_client/rspec'
+
+RSpec.describe MyApi::Products::List do
+  it 'returns successful response with products' do
+    stub_request(:get, "https://api.example.com/products")
+      .to_return(status: 200, body: { products: [{id: 1}, {id: 2}] }.to_json)
+
+    service_result = described_class.()
+
+    # Use with FService matchers
+    expect(service_result)
+      .to have_succeed_with(:ok, :successful)
+      .and_value(f_http_client_response_including(products: have_attributes(size: 2), page: be_a(Integer)))
+  end
+
+  it 'supports nested matchers' do
+    stub_request(:get, "https://api.example.com/products")
+      .to_return(status: 200, body: { items: [{id: 1}] }.to_json)
+
+    response = described_class.().value
+
+    # Direct response testing
+    expect(response)
+      .to f_http_client_response_including(items: a_collection_containing_exactly(a_hash_including(id: 1)))
+  end
+end
+```
+
+The matcher:
+- Automatically calls `parsed_response` on HTTParty::Response objects
+- Supports any nested RSpec matchers (`have_attributes`, `a_hash_including`, `be_a`, etc.)
+- Works seamlessly with FService's `.and_value()` and `.and_error()` matchers
+- Provides clear failure messages showing expected vs actual
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.

data/f_http_client.gemspec

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative 'lib/f_http_client/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'f_http_client'
+  spec.version = FHTTPClient::VERSION
+  spec.authors = ['Fretadao Tech Team']
+  spec.email = ['tech@fretadao.com.br']
+
+  spec.summary = 'Gem to provade a base for an HTTP client using FService architecture'
+  spec.homepage = 'https://github.com/Fretadao/f_http_client'
+  spec.license = 'MIT'
+  spec.required_ruby_version = '>= 3.2.0'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = 'https://github.com/Fretadao/f_http_client/blob/master/CHANGELOG.md'
+
+  # 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(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|circleci)|appveyor)})
+    end
+  end
+  spec.bindir = 'exe'
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  # Uncomment to register a new dependency of your gem
+  # spec.add_dependency "example-gem", "~> 1.0"
+  spec.add_dependency 'activesupport', '>= 7.2'
+  spec.add_dependency 'addressable'
+  spec.add_dependency 'dry-configurable'
+  spec.add_dependency 'dry-initializer'
+  spec.add_dependency 'f_service', '>= 0.3.0'
+  spec.add_dependency 'httparty'
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+  spec.metadata['rubygems_mfa_required'] = 'false'
+end

data/lib/f_http_client/base.rb

@@ -23,7 +23,8 @@ module FHTTPClient
         FHTTPClient::Processor::Response.(response: response, log_strategy: log_strategy)
       end
     rescue StandardError => e
-      FHTTPClient::Processor::Exception.(error: e, log_strategy: log_strategy)
+      FHTTPClient::Processor::Exception
+        .(error: e, log_strategy: log_strategy)
         .on_failure(:uncaught_error) { raise e }
     end
 

data/lib/f_http_client/cache/rails.rb

@@ -2,7 +2,8 @@
 
 module FHTTPClient
   module Cache
-    RailsNotDefined = Class.new(StandardError)
+    class RailsNotDefined < StandardError
+    end
 
     class Rails
       class << self

data/lib/f_http_client/processor/exception.rb

@@ -31,6 +31,8 @@ module FHTTPClient
           :connection_refused
         when 'SocketError'
           :connection_error
+        when 'OpenSSL::SSL::SSLError'
+          :ssl_error
         when /timeout/i
           :timeout
         else

data/lib/f_http_client/processor/response.rb

@@ -34,6 +34,24 @@ module FHTTPClient
 
       private_constant :STATUS_FAMILIES
 
+      # Status codes whose canonical name changed with RFC 9110. The type comes from
+      # Net::HTTPResponse::CODE_TO_OBJ, which still carries the pre-RFC names, while Rack
+      # 3.1+ (and therefore every Rails app consuming this gem) already canonicalized them.
+      # Emitting both symbols, canonical first, lets `on_failure` match either name so
+      # consumers can migrate at their own pace.
+      #
+      # TODO: Drop this constant and #response_types once net-http adopts the RFC 9110 names
+      # (or the status-to-type source stops being CODE_TO_OBJ) AND consumers have migrated
+      # off the legacy names. See Rack::Utils OBSOLETE_SYMBOL_MAPPINGS (rack >= 3.1).
+      RENAMED_TYPES = {
+        unprocessable_entity: %i[unprocessable_content unprocessable_entity],
+        unprocessable_content: %i[unprocessable_content unprocessable_entity],
+        payload_too_large: %i[content_too_large payload_too_large],
+        content_too_large: %i[content_too_large payload_too_large]
+      }.freeze
+
+      private_constant :RENAMED_TYPES
+
       def run
         log_data.and_then { success? ? success_response : failure_response }
       end
@@ -43,11 +61,24 @@ module FHTTPClient
       def_delegators :@response, :headers, :success?, :parsed_response, :code
 
       def success_response
-        Success(response_type, response_family, data: response)
+        Success(*response_types, response_family, data: response)
       end
 
       def failure_response
-        Failure(response_type, response_family, data: response)
+        Failure(*response_types, response_family, data: response)
+      end
+
+      # Private:
+      # Result types for the response status, from the canonical name to the legacy one.
+      # Ex: When the request returns a 422 (Unprocessable Content)
+      #
+      # # => [:unprocessable_content, :unprocessable_entity]
+      #
+      # Ex: When the request returns a 404 (Not Found)
+      #
+      # # => [:not_found]
+      def response_types
+        RENAMED_TYPES.fetch(response_type) { [response_type] }
       end
 
       # Private:
@@ -81,10 +112,10 @@ module FHTTPClient
       # # => "Unprocessable Entity"
       def message
         @message ||= response_class
-                     .to_s
-                     .delete_prefix('Net::HTTP')
-                     .gsub(/([A-Z]+)([A-Z][a-z])/, '\1 \2')
-                     .gsub(/([a-z])([A-Z])/, '\1 \2')
+          .to_s
+          .delete_prefix('Net::HTTP')
+          .gsub(/([A-Z]+)([A-Z][a-z])/, '\1 \2')
+          .gsub(/([a-z])([A-Z])/, '\1 \2')
       end
 
       # Private

data/lib/f_http_client/rspec/matchers/f_http_client_response_including.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+RSpec::Matchers.define :f_http_client_response_including do |expected_hash|
+  match do |actual|
+    return false unless actual.respond_to?(:parsed_response)
+
+    @actual_parsed = actual.parsed_response
+
+    # Check if all expected key-value pairs are present in actual
+    expected_hash.all? do |expected_key, expected_value|
+      actual_value = @actual_parsed[expected_key]
+      # Use values_match? to support nested matchers
+      values_match?(expected_value, actual_value)
+    end
+  end
+
+  failure_message do |actual|
+    if actual.respond_to?(:parsed_response)
+      "expected HTTParty::Response parsed_response to include #{expected_hash.inspect}, " \
+        "but got #{@actual_parsed.inspect}"
+    else
+      "expected an HTTParty::Response, but got #{actual.class}"
+    end
+  end
+
+  diffable
+end

data/lib/f_http_client/rspec/matchers.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative 'matchers/f_http_client_response_including'

data/lib/f_http_client/rspec.rb

@@ -1,3 +1,4 @@
 # frozen_string_literal: true
 
 require_relative 'rspec/support'
+require_relative 'rspec/matchers'

data/lib/f_http_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FHTTPClient
-  VERSION = '0.2.1'
+  VERSION = '0.4.0'
 end

data/lib/f_http_client.rb

@@ -3,6 +3,7 @@
 require_relative 'f_http_client/version'
 require 'active_support/core_ext/array'
 require 'active_support/core_ext/enumerable'
+require 'active_support/core_ext/object/blank'
 require 'active_support/core_ext/string'
 require 'addressable'
 require 'dry-configurable'

data/release-please-config.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "bump-minor-pre-major": true,
+  "include-component-in-tag": false,
+  "packages": {
+    ".": {
+      "release-type": "ruby",
+      "package-name": "f_http_client",
+      "version-file": "lib/f_http_client/version.rb",
+      "extra-files": [
+        {
+          "type": "generic",
+          "path": "spec/f_http_client_spec.rb"
+        }
+      ]
+    }
+  }
+}

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: f_http_client
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Fretadao Tech Team
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-10-06 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -16,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '7.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: addressable
   requirement: !ruby/object:Gem::Requirement
@@ -94,22 +93,24 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 
 email:
 - tech@fretadao.com.br
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".release-please-manifest.json"
 - ".rspec"
 - ".rubocop.yml"
 - CHANGELOG.md
+- CONTRIBUTING.md
 - Gemfile
 - Gemfile.lock
 - LICENSE
 - README.md
 - Rakefile
 - examples/post_find.rb
+- f_http_client.gemspec
 - lib/f_http_client.rb
 - lib/f_http_client/base.rb
 - lib/f_http_client/cache/http_response_analizer.rb
@@ -125,6 +126,8 @@ files:
 - lib/f_http_client/processor/exception.rb
 - lib/f_http_client/processor/response.rb
 - lib/f_http_client/rspec.rb
+- lib/f_http_client/rspec/matchers.rb
+- lib/f_http_client/rspec/matchers/f_http_client_response_including.rb
 - lib/f_http_client/rspec/support.rb
 - lib/f_http_client/rspec/support/helpers.rb
 - lib/f_http_client/rspec/support/helpers/fake_response.rb
@@ -132,6 +135,7 @@ files:
 - lib/f_http_client/service.rb
 - lib/f_http_client/store.rb
 - lib/f_http_client/version.rb
+- release-please-config.json
 - sig/f_http_client.rbs
 homepage: https://github.com/Fretadao/f_http_client
 licenses:
@@ -141,7 +145,6 @@ metadata:
   source_code_uri: https://github.com/Fretadao/f_http_client
   changelog_uri: https://github.com/Fretadao/f_http_client/blob/master/CHANGELOG.md
   rubygems_mfa_required: 'false'
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -149,15 +152,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.32
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Gem to provade a base for an HTTP client using FService architecture
 test_files: []