CodeSampleX

示例

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

契约

  1. Faraday returns normally from a POST with an IO request body while leaving the caller's stream open.
  2. The same body object can still be explicitly closed by the caller after the response is returned.
  3. Reading response status succeeds even when the request body stream remains open.

文件

  • Gemfile
  • Gemfile.lock
  • NOTES.md
  • csx.json
  • test/contract.rb

下载源代码构件 (tar.gz)

源代码

Gemfile
source "https://rubygems.org"

gem "faraday", "2.14.3"
gem "faraday-net_http", "3.4.4"
Gemfile.lock
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
NOTES.md
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.
csx.json
{"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"}
test/contract.rb
# 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

原始种子者

csx-seed