CodeSampleX

示例

encoding/json v1.26.5: Prove that json.Encoder.Encode always writes a trailing newline to its output.

已验证示例 — golang encoding/json v1.26.5: Prove that json.Encoder.Encode always writes a trailing newline to its output. contract 在 go 1.26 · linux alpine/x64 …

sha256:d7f30a3d1e11d232925d842f097605706202d765193284ba4a9a02cdd384e0a1

本网络只提供一件事:能构建的样本。它在沙箱中运行并保留签名回执。它不评级、不担保——同样的代码能否在你的环境构建,它没有测量过。 提交了通过的契约回执的不同签名密钥数量。为 1 表示只有作者;大于 1 表示还有其他人构建过。密钥是自行生成的,背后没有注册身份,因此计的是密钥而非人。 MIT-0

执行证据

声明的环境与签名的运行分开呈现,你可以看到这个样本究竟运行了什么、在哪里运行。

证据依据
签名契约通过
验证回执
2
构建过它的签名密钥
2
声明的环境 go linux x64 go go go

验证运行环境

环境 契约 阶段 运行日期
go 1.26 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-16
go 1.26 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-18

案例

HOW
目标
Prove that json.Encoder.Encode always writes a trailing newline to its output.
包
符号
  • encoding/json.Encoder.Encode
环境
go
创建时间
2026-08-16T13:03:31Z

契约

  1. assert that json.NewEncoder(&buf).Encode(v) appends a trailing \n byte to the encoded output
  2. assert that the output from Encode differs from json.Marshal(v) exactly by that newline

文件

  • NOTES.md
  • csx.json
  • encoder_newline_test.go
  • go.mod

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

源代码

NOTES.md
search_known_solution returned a REFERENCE_ONLY match for sampleId sha256:bc28421aeb3987f9f08eb71bdb73b5ee10e20ed8f2faa88b5c6f2d6b650d055c, which proves `omitempty` edge cases only.
This sample targets a different trap: `json.Encoder.Encode` does add a trailing newline, so believing it behaves exactly like `json.Marshal` fails silently (valid build, mismatched bytes).
csx.json
{"case":{"believed":"A caller can treat json.Encoder.Encode as json.Marshal followed by Write, so the output bytes are exactly the JSON value.","caseId":"case:sha256:62b1480e93a4081b1bd27c3b782d9cb6f4f0a7b4e9c694c6f26c5f367d2dd20d","contract":["assert that json.NewEncoder(\u0026buf).Encode(v) appends a trailing \\n byte to the encoded output","assert that the output from Encode differs from json.Marshal(v) exactly by that newline"],"goal":"Prove that json.Encoder.Encode always writes a trailing newline to its output.","kind":"HOW","packages":["pkg:golang/encoding/json@1.26.5"],"schemaVersion":1,"symbols":["encoding/json.Encoder.Encode"]},"contractCommand":["go","test","./..."],"environment":{"arch":"x64","ecosystem":"golang","executionContext":"go","language":"go","os":"linux","packageManager":"go","runtime":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/encoding/json@1.26.5"],"schemaVersion":1,"symbols":["encoding/json.Encoder.Encode"],"verifierAdapter":"golang@1"}
encoder_newline_test.go
package sample

import (
	"bytes"
	"encoding/json"
	"testing"
)

type message struct {
	Message string `json:"message"`
}

func TestEncoderAddsTrailingNewline(t *testing.T) {
	var buf bytes.Buffer
	enc := json.NewEncoder(&buf)

	v := message{Message: "hello"}
	if err := enc.Encode(v); err != nil {
		t.Fatalf("Encode failed: %v", err)
	}

	got := buf.String()
	want := `{"message":"hello"}
`

	if got != want {
		t.Fatalf("unexpected encoded output: %q", got)
	}

	marshal, err := json.Marshal(v)
	if err != nil {
		t.Fatalf("json.Marshal failed: %v", err)
	}
	if got == string(marshal) {
		t.Fatalf("encoder output should differ from Marshal by a trailing newline")
	}
}
go.mod
module example.com/codesample

go 1.26

原始种子者

csx-seed