wojtekmach/req
68.9
Adequate · 13 November 2026
7.8k
lines of production code
Elixir
primary language
8
measurements over time
What this system is
This system is the Req HTTP client library for Elixir, providing a high-level, composable API for making HTTP requests. It features a modular step-based architecture that handles authentication, compression, decoding, and error management, with built-in support for streaming large responses. The library abstracts underlying HTTP transports via an adapter behavior, defaulting to Finch, and includes comprehensive tooling for testing concurrent and stateful client behavior.
Features
Added example scripts for OpenAI streaming and reverse proxying
New Livemd example files have been added to the examples directory. The openai.livemd file demonstrates how to use Req to stream chat completions from the OpenAI API, handling chunked responses and usage statistics. The reverse\_proxy.livemd file provides a complete example of building a reverse proxy using Req and Bandit, showing how to stream request and response bodies between a client and an upstream server.
examples · high confidence
Behavioural changes
Redesigned high-level API with new request struct and streaming support
The \Req\ module has been completely redesigned to serve as the high-level API, built on top of a new \Req.Request\ struct and a modular step system (\Req.Steps\). This change introduces a new \Req.new/1\ function for building requests and adds dedicated functions for HTTP methods (\Req.get/2\, \Req.post/2\, etc.). A key behavioral change is the introduction of response body streaming via the \Req.stream/4\ function and the \:into\ option, allowing users to handle large responses as enumerables or stream directly to a collectable. The module documentation has also been expanded to cover these new capabilities, including header handling and connection options.
lib · high confidence
Req v0.8 introduces streaming, step wrappers, and modular step modules
Req v0.8 requires Elixir 1.18+ and brings ergonomic streaming via \Req.stream/4\, request body streaming with \body: fun\, and automatic NDJSON & SSE decoding. Internally, the library replaces legacy steps (such as \compressed\, \auth\, \redirect\, \retry\, \decode\_body\, \handle\_http\_errors\, and \checksum\) with dedicated modules (\Req.Decompress\, \Req.Auth\, \Req.Redirect\, \Req.Retry\, \Req.Decode\, \Req.Expect\, \Req.Checksum\) and introduces step wrappers to support extensible streaming decoding. This release also removes the \jason\ dependency in favor of the \JSON.Encoder\ protocol, deprecates \into: fun\ in favor of \Req.stream/4\, and adds support for setting private options and inspecting the final request via \resp.request\.
(repo-wide) · high confidence
Req v0.9 redesign: new step-based architecture and API
The library has been redesigned around a composable step-based architecture, replacing the previous monolithic request flow with dedicated modules for each concern. Authentication is now handled by \Req.Auth\ (supporting basic, bearer, digest, and netrc), while response handling is split into \Req.Decompress\ (for gzip, brotli, zstd) and \Req.Decode\ (for JSON, NDJSON, SSE, and opt-in archive/CSV formats). Error handling is managed by \Req.Expect\ (replacing \:http\_errors\) and \Req.Checksum\ (for body integrity). The HTTP transport is abstracted via the \Req.Adapter\ behaviour with \Req.Finch\ as the default, and the API now uses \Req.Request\ for building requests and \Req.Response\ for results, introducing options like \:decoders\, \:compressed\, and \:expect\.
lib/req · high confidence
Test environment logger configuration added
A new configuration file for the test environment has been introduced to customize the logger output. Specifically, the logger formatter is set to a simplified plain-text format without color codes when running in the :test environment, ensuring cleaner and more readable test logs.
config · high confidence
Test coverage
Added comprehensive test suite for Req core modules; Added documentation, integration, and unit tests for the Req library; Added test helpers for process ownership tracking; Added test support infrastructure for HTTP adapters and testing.
Dependencies
Upgrade to Req 0.8.0-rc.0 with Elixir 1.18 and Finch 0.21
This release bumps the minimum Elixir requirement to 1.18 and updates the Finch HTTP adapter dependency to version 0.21. The project also drops the Jason dependency in favor of Elixir's built-in JSON support, adds optional support for NimbleCSV and Brotli compression, and introduces new test dependencies including Bandit and AWS Signature. The lockfile reflects these changes with updated versions for core libraries like Plug (1.16.1), Mint (1.8.0), and Telemetry (1.4.2).
(dependencies) · 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 70 → 69 (-0.9)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.
Lenses
- Code Health 95 → 95 (+0.0)
- Architecture 100 → 100 (+0.0)
- Maturity 57 → 55 (-1.9)
- Readiness 70 → 69 (-0.2)
- Security 88 → 89 (+0.2)
New (10)
- Edited copies of one member (3 members, 21+ corresponding lines) (lib/req/brotli.ex)
- Edited copies of one member (3 members, 26+ corresponding lines) (lib/req/brotli.ex)
- Edited copy of a member (13 corresponding lines) (lib/req.ex)
- Edited copy of a member (3 corresponding lines) (lib/req/gzip.ex)
- Edited copy of a member (3 corresponding lines) (lib/req/gzip.ex)
- Edited copy of a member (9 corresponding lines) (lib/req.ex)
- Medium CVE: EEF-[CVE redacted] (mix.lock)
- Medium vulnerability: EEF-[CVE redacted] (mix.lock)
- Outdated: bandit
- Outdated: brotli
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
wojtekmach/req 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 13 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 70df5038949f1cbfe3b63370c9f66f24ac109762 — the exact code this score is about.
- Scored under rubric-2026.11.3 — 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.57+preprod-8ebfb01cf4c0.