savonrb/savon
64.7
Adequate · 6 November 2026
2.6k
lines of production code
Ruby
primary language
4
measurements over time
What this system is
Features
Introduce opt-in Faraday HTTP transport
Savon now supports an opt-in HTTP transport backed by Faraday, allowing users to leverage Faraday's middleware stack for features like custom authentication, proxy handling, and request/response transformations. This new transport is available alongside the existing HTTPI-based default, with the \Savon::Transport::Faraday\ class handling header assembly, request execution, and response normalization. The implementation includes a transport-agnostic \Response\ object that normalizes cookies differently depending on the underlying transport (Hash for Faraday, Array for HTTPI) to maintain compatibility, and a shared \Logging\ module to standardize request/response logging across both transports.
lib/savon/transport · high confidence
Savon 2.17.5 introduces a new transport abstraction and WS-Addressing support
Savon now supports an opt-in Faraday transport alongside the existing HTTPI transport, allowing users to configure middleware, SSL, and timeouts via the Faraday API. The library also adds support for WS-Addressing 1.0 headers (Action, To, MessageID) and introduces a new \Savon::Client\ entry point that replaces the legacy \Savon::Service\ class. This release drops support for Ruby versions below 2.1 and includes various fixes for SOAP 1.2, multipart requests, and namespace handling.
lib/savon · high confidence
Behavioural changes
Added binstubs for direct command execution
Executable binstubs have been added for bundle-audit, bundler-audit, rake, rspec, and rubocop in the bin directory. These scripts allow users to run these tools directly by name (e.g., \bundle-audit\) without needing to prefix commands with \bundle exec\, simplifying the workflow for development and testing tasks.
bin · high confidence
New mock interface with expectation matchers and observer-based verification
The Savon mock system has been refactored to use a new \MockExpectation\ class and an observer-based architecture. Users can now define expectations using a fluent interface (e.g., \expects(...).with(...).returns(...)\) and utilize the \:any\ symbol or RSpec-style matchers (via \===\) within expected message hashes for flexible validation. The mock system now actively verifies that all defined expectations are met and that responses are configured, raising specific errors if requests are unexpected, messages mismatch, or expected calls do not occur. A dedicated \SpecHelper\ is provided to integrate this verification into test suites, ensuring mocks are validated at the end of test runs.
lib/savon/mock · high confidence
Refactored library structure and error hierarchy
The library has been reorganized to use a modular directory structure, replacing the previous flat file layout with separate require paths for version, client, model, and string utilities. The error handling system was updated to introduce a custom \Savon::Error\ base class, with specific exceptions like \UnknownOptionError\ and \UnknownOperationError\ inheriting from it. Additionally, the codebase now enforces frozen string literals and exposes an observer pattern for notifying external listeners about operations.
lib · high confidence
Test coverage
Added SSL and WSDL test fixtures for integration specs; Added SSL test fixtures for client certificates and keys; Added comprehensive test coverage for Savon core components; Added integration tests for Faraday transport and cookie handling; Added integration tests for concurrent requests, WSDL routing, and error handling; Added spec support infrastructure for testing; Added test coverage for the new transport abstraction layer; Initial test infrastructure setup with RSpec and SimpleCov; New local integration test server with authentication and SSL support; Removal of legacy test suite and fixtures.
Dependencies
Savon gemspec and Gemfile updated for modern Ruby and HTTP stack
The Savon gemspec and Gemfile have been updated to require Ruby 3.0.0 or higher and modernize the dependency stack. Runtime dependencies now include httpi 4.x, wasabi 5.x, and nokogiri 1.8.1+, replacing older libraries like hpricot and smacks-apricoteatsgorilla. Development dependencies have also been refreshed, adding bundler-audit, rubocop, and puma 8.x to support current CI and testing workflows.
(dependencies) · high confidence
Housekeeping
Project initialization with RuboCop linting and documentation
The repository is initialized with a new \.rubocop.yml\ configuration targeting Ruby 3.0, including plugins for Rake and RSpec, alongside a generated \.rubocop\_todo.yml\ to manage existing style offenses. Documentation and contributor guidelines are added via \README.md\, \CHANGELOG.md\, \CONTRIBUTING.md\, \CODE\_OF\_CONDUCT.md\, \SECURITY.md\, and \RELEASING.md\, while legacy files like \README.rdoc\ are removed.
(repo-wide) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 63 → 65 (+1.9)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 75 → 74 (-0.7)
- Architecture 100 → 100 (+0.0)
- Maturity 50 → 56 (+5.4)
- Readiness 67 → 67 (+0.0)
- Security 82 → 75 (-7.1)
Resolved (5)
- Ambiguous naming convention for similar data extraction methods. It is unclear what the distinction between hash and full_hash is without documentation (e.g., one might include metadata, the other only the body). This violates the principle of least surprise.
- Confusingly similar query methods. find likely wraps xpath or uses a simplified syntax, but the existence of two methods for querying the response body with a path-like argument is inconsistent with standard XML parsing APIs which usually stick to xpath or css.
- Off-boarding risk: anonymized user #1
- Redundant entry points for the same core action. Client.call acts as a facade that delegates to Operation.call. Exposing both creates confusion about whether the user should interact with the Client or the Operation directly.
- Redundant request building operations. Client.build_request is a convenience wrapper around Client.operation(name).build(...). This duplicates the intent of constructing a request object.
New (3)
- Off-boarding risk: anonymized user #1
- QualifiedMessage.to_hash (cognitive 18) (lib/savon/qualified_message.rb)
- TooManyMethods: Builder (lib/savon/builder.rb)
Changes since last survey
- 10 commits — 10 feature/other, 0 fixes
By area
- (root) — 4 commits
- .github/workflows — 4 commits
- lib/savon — 2 commits
Notable commits
- change: Bump ruby/setup-ruby from 1.328.0 to 1.329.0 (#1085)
- change: Bump ruby/setup-ruby from 1.329.0 to 1.334.0 (#1088)
- change: Bump zizmorcore/zizmor-action from 0.6.4 to 0.7.1 (#1086)
- change: Bump zizmorcore/zizmor-action from 0.7.1 to 0.8.0 (#1089)
- change: Derive Savon::Model reserved operation names from the ancestor chains
- change: Mtom request framing (#1047)
- change: Order messages like the WSDL schema with order!: :use_schema
- change: Release 2.18.0
- change: Replace namespace iteration with a Hash#key lookup in Builder
- change: Skip reserved xml prefixes when reusing WSDL namespace identifiers
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
savonrb/savon was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 6 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit e70d85d5d286398046a3c6a115877ad38ed499a9 — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.2+preprod-5c4e66d9318b.