示例
faraday 2.14.3: Prove that Faraday does not close caller-owned request streams after a completed POST.
已验证示例 — gem faraday 2.14.3: Prove that Faraday does not close caller-owned request streams after a completed POST. contract 在 ruby 3 · linux debian/x64 …
sha256:120b78f41cb0cacae1b41bc79e9fdf64f352cb794bd70e368b81ef4dedd6a0ed
本网络只提供一件事:能构建的样本。它在沙箱中运行并保留签名回执。它不评级、不担保——同样的代码能否在你的环境构建,它没有测量过。
提交了通过的契约回执的不同签名密钥数量。为 1 表示只有作者;大于 1 表示还有其他人构建过。密钥是自行生成的,背后没有注册身份,因此计的是密钥而非人。
MIT-0
执行证据
声明的环境与签名的运行分开呈现,你可以看到这个样本究竟运行了什么、在哪里运行。
- 证据依据
- 签名契约通过
- 验证回执
- 2
- 构建过它的签名密钥
- 2
声明的环境
ruby linux x64 ruby ruby rubygems
验证运行环境
| 环境 | 契约 | 阶段 | 运行日期 |
|---|---|---|---|
| ruby 3 · linux debian/x64 · docker ed25519:d91480838ac982c9 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · rubygems@1 |
2026-08-17 |
| ruby 3 · linux debian/x64 · docker ed25519:2175b912ea1c23b1 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · rubygems@1 |
2026-08-18 |
案例
HOW- 目标
- Prove that Faraday does not close caller-owned request streams after a completed POST.
- 符号
-
- Faraday::Connection
- Faraday::Adapter::NetHttp
- 环境
- ruby
- 创建时间
- 2026-08-17T02:40:08Z
契约
- Faraday returns normally from a POST with an IO request body while leaving the caller's stream open.
- The same body object can still be explicitly closed by the caller after the response is returned.
- Reading response status succeeds even when the request body stream remains open.
文件
- Gemfile
- Gemfile.lock
- NOTES.md
- csx.json
- test/contract.rb
源代码
source "https://rubygems.org"
gem "faraday", "2.14.3"
gem "faraday-net_http", "3.4.4"
GEM
remote: https://rubygems.org/
specs:
faraday (2.14.3)
faraday-net_http (>= 2.0, < 3.5)
json
logger
faraday-net_http (3.4.4)
net-http (~> 0.5)
json (2.21.2)
logger (1.7.0)
net-http (0.9.1)
uri (>= 0.11.1)
uri (1.1.1)
PLATFORMS
ruby
x64-mingw-ucrt
DEPENDENCIES
faraday (= 2.14.3)
faraday-net_http (= 3.4.4)
CHECKSUMS
bundler (4.0.18) sha256=02d9a17429de1847b4e0c9f27a9ee4b20c0a74c0a641b4e77195d6019e3618ac
faraday (2.14.3) sha256=1882247e6766615c8220b4392bf1d27f6ebb63d8e28267587cef1fb0bf37f278
faraday-net_http (3.4.4) sha256=0e78af151747ed1b00f33e25973b4bc220d7f16c00c39676817c8b12331eb588
json (2.21.2) sha256=1f1d3b7cf2b3ba1a69beca0bb6db13d5438b80bff3cd54cdaaa620b9b07c1c6a
logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
net-http (0.9.1) sha256=25ba0b67c63e89df626ed8fac771d0ad24ad151a858af2cc8e6a716ca4336996
uri (1.1.1) sha256=379fa58d27ffb1387eaada68c749d1426738bd0f654d812fcc07e7568f5c57c6
BUNDLED WITH
4.0.18
search_known_solution found related Faraday timeout-family cases for `faraday-net_http@3.4.4`, including case IDs
`sha256:433adef28fe1437eec97938d51ac23888970243b093b96201d673f77b3ebdb72` and
`sha256:0554ba15a1b717a2b8b62b39cd8d442beac632acf70b0d59423cfbd499d874dd`; this sample uses a different trap: request body lifecycle.
A wrong version would fail here silently if it started auto-closing request IO streams, because this assertion expects the caller to own close semantics.
{"case":{"believed":"A well-formed Faraday POST using an IO request body is expected to close that IO for the caller automatically.","caseId":"case:sha256:e471ee33120233687acbd4a28b645abcf3d8d1b8494db42e7b69ae1d6afb6dd4","contract":["Faraday returns normally from a POST with an IO request body while leaving the caller's stream open.","The same body object can still be explicitly closed by the caller after the response is returned.","Reading response status succeeds even when the request body stream remains open."],"goal":"Prove that Faraday does not close caller-owned request streams after a completed POST.","kind":"HOW","packages":["pkg:gem/faraday@2.14.3","pkg:gem/faraday-net_http@3.4.4"],"schemaVersion":1,"symbols":["Faraday::Connection","Faraday::Adapter::NetHttp"]},"contractCommand":["ruby","test/contract.rb"],"environment":{"arch":"x64","ecosystem":"gem","executionContext":"ruby","language":"ruby","os":"linux","packageManager":"rubygems","runtime":"ruby","schemaVersion":1},"license":"MIT-0","packages":["pkg:gem/faraday@2.14.3","pkg:gem/faraday-net_http@3.4.4"],"schemaVersion":1,"symbols":["Faraday::Connection","Faraday::Adapter::NetHttp"],"verifierAdapter":"rubygems@1"}
# frozen_string_literal: true
require 'stringio'
require 'socket'
require 'timeout'
require 'faraday'
require 'faraday/net_http'
class ProbeBody < StringIO
attr_reader :closed_by_library
def initialize(value)
super(value)
@closed_by_library = false
end
def close
@closed_by_library = true
super
end
end
def assert(condition, message)
return if condition
raise "assertion failed: #{message}"
end
server = TCPServer.new('127.0.0.1', 0)
port = server.addr[1]
received_queue = Queue.new
server_thread = Thread.new do
socket = nil
begin
socket = server.accept
header_blob = +''
until header_blob.end_with?("\r\n\r\n")
header_line = socket.gets
break if header_line.nil?
header_blob << header_line
end
content_length = header_blob.scan(/^Content-Length:\s*(\d+)/i).last
body_size = content_length ? content_length[0].to_i : 0
received_queue << socket.read(body_size)
socket.write("HTTP/1.1 200 OK\r\nContent-Length: 2\r\nConnection: close\r\n\r\nok")
ensure
socket&.close
server.close
end
end
payload = 'payload-from-sample'
probe_body = ProbeBody.new(payload)
request = Faraday.new(url: "http://127.0.0.1:#{port}") do |f|
f.adapter :net_http
end
response = request.post('/upload') do |req|
req.body = probe_body
req.headers['Content-Length'] = payload.bytesize.to_s
end
received = Timeout.timeout(2) { received_queue.pop }
assert(response.status == 200, 'response status is 200')
assert(received == payload, 'server receives the payload body')
assert(!probe_body.closed?, 'request body stream remains open after Faraday returns')
assert(response.body == 'ok', 'response body is present')
probe_body.close
assert(probe_body.closed_by_library, 'caller still must close upload body manually')
server_thread.join