f_http_client 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bac525ad09c72f1354f9e12325df3954162a0a403a1490954965ebe0857cf1f8
-  data.tar.gz: 8dcf73d13e10dac54c0f8160b315c0cfb832b316d7b15f37b1484bfa71e9a173
+  metadata.gz: 7bc7ea9df893eeb1677e578522732aba2ae7f6b4613bdd7621a5ab1e4686f48a
+  data.tar.gz: f471ba64951044aab190a13e29f93da1858c45c32d225268f23a4dd4324edde4
 SHA512:
-  metadata.gz: dc919bb2e2ec31f726a15cb4d811909678daaf76ca63ce0bc2d87d816af9c3cc5f26a4fda77c18909ba0428439fb9e5559c07eecd8bbf7d2354b70ae974edb75
-  data.tar.gz: 40452092e5d0a7635c5bbf227750a2d32baf88f0d39eca5a1cd87a1f22af821990568989a8be3438cdbadaa4640dcaac795af4f5402a66136f0c09e5467c41be
+  metadata.gz: 2560bfd3e0954a0fa58dc416a76a6018ce3acd41afdb808f04742a56495aae7ee975c87421aeb2f5fd2d95762a8d616a6554653ff5210c06eeb5530d4a6a7c2e
+  data.tar.gz: '058d4e67c2ce215ebaa7cddf3fed92a2b964e962530849eb854c7c4af73528352aa4ee5341cb72a3531f11ae9618f6fa15df40691eccae767585ffb07484669b'

data/.release-please-manifest.json

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

data/.rubocop.yml

@@ -4,7 +4,7 @@ plugins:
   - rubocop-vicenzo
 
 AllCops:
-  TargetRubyVersion: 3.0
+  TargetRubyVersion: 3.2
   SuggestExtensions: false
   NewCops: enable
   CacheRootDirectory: tmp

data/CHANGELOG.md

@@ -1,4 +1,17 @@
-## [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

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

@@ -25,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,7 +1,7 @@
 PATH
   remote: .
   specs:
-    f_http_client (0.3.0)
+    f_http_client (0.4.0)
       activesupport (>= 7.2)
       addressable
       dry-configurable
@@ -12,7 +12,7 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (8.1.2)
+    activesupport (8.1.3.1)
       base64
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.3.1)
@@ -25,21 +25,20 @@ GEM
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
       uri (>= 0.13.1)
-    addressable (2.8.8)
+    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.0.1)
+    bigdecimal (4.1.2)
     coderay (1.1.3)
-    concurrent-ruby (1.3.6)
+    concurrent-ruby (1.3.8)
     connection_pool (3.0.2)
     crack (1.0.1)
       bigdecimal
       rexml
-    csv (3.3.5)
+    csv (3.3.6)
     diff-lcs (1.6.2)
-    docile (1.4.1)
     drb (2.2.3)
     dry-configurable (1.3.0)
       dry-core (~> 1.1)
@@ -49,27 +48,28 @@ GEM
       logger
       zeitwerk (~> 2.6)
     dry-initializer (3.2.0)
-    f_service (0.3.1)
+    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.8)
+    i18n (1.15.2)
       concurrent-ruby (~> 1.0)
-    json (2.18.0)
-    language_server-protocol (3.17.0.5)
+    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 (6.0.1)
+    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.27.0)
-    parser (3.3.10.1)
+    parallel (1.28.0)
+    parser (3.3.12.0)
       ast (~> 2.4.1)
       racc
     prism (1.9.0)
@@ -78,11 +78,11 @@ GEM
       method_source (~> 1.0)
     pry-nav (1.0.0)
       pry (>= 0.9.10, < 0.15)
-    public_suffix (7.0.2)
+    public_suffix (7.0.5)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.3.1)
-    regexp_parser (2.11.3)
+    rake (13.4.2)
+    regexp_parser (2.12.0)
     rexml (3.4.4)
     rspec (3.13.2)
       rspec-core (~> 3.13.0)
@@ -97,46 +97,42 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.7)
-    rubocop (1.84.0)
+    rubocop (1.89.0)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
-      parallel (~> 1.10)
+      parallel (>= 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.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, < 4.0)
-    rubocop-ast (1.49.0)
+    rubocop-ast (1.50.0)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
-    rubocop-performance (1.26.1)
+    rubocop-performance (1.27.0)
       lint_roller (~> 1.1)
-      rubocop (>= 1.75.0, < 2.0)
+      rubocop (>= 1.89.0, < 2.0)
       rubocop-ast (>= 1.47.1, < 2.0)
-    rubocop-rspec (3.9.0)
+    rubocop-rspec (3.10.2)
       lint_roller (~> 1.1)
-      rubocop (~> 1.81)
-    rubocop-vicenzo (0.3.0)
+      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 (0.22.0)
-      docile (~> 1.1)
-      simplecov-html (~> 0.11)
-      simplecov_json_formatter (~> 0.1)
-    simplecov-html (0.13.2)
-    simplecov_json_formatter (0.1.4)
+    simplecov (1.1.1)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
     unicode-emoji (4.2.0)
     uri (1.1.1)
-    webmock (3.26.1)
+    webmock (3.26.2)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
@@ -154,7 +150,7 @@ DEPENDENCIES
   pry
   pry-nav
   racc
-  rake (~> 13.0)
+  rake (~> 13.4)
   rspec (~> 3.0)
   rubocop
   rubocop-performance

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:

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/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:

data/lib/f_http_client/version.rb

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

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,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: f_http_client
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Fretadao Tech Team
@@ -99,15 +99,18 @@ 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
@@ -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:
@@ -148,14 +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: 4.0.3
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Gem to provade a base for an HTTP client using FService architecture
 test_files: []