CodeSampleX

Exemplo

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

Amostra verificada para golang encoding/json v1.26.5: Prove that json.Encoder.Encode always writes a trailing newline to its output. O contrato rodou em go…

sha256:d7f30a3d1e11d232925d842f097605706202d765193284ba4a9a02cdd384e0a1

Esta rede oferece uma coisa: uma amostra que compila. Ela a executou em um sandbox e guardou o recibo assinado. Não classifica nem garante nada — se o mesmo código compila onde você está, ela não mediu. Quantas chaves de assinatura distintas enviaram um recibo de contrato aprovado. Uma é só o autor; mais de uma significa que outra pessoa também o compilou. Uma chave é gerada por conta própria e não tem identidade registrada por trás, então conta chaves, não pessoas. MIT-0

Evidência de execução

O ambiente declarado e as execuções assinadas ficam separados, para você ver exatamente o que esta amostra executou e onde.

Base da evidência
Contrato assinado aprovado
Recibos de verificação
2
Chaves de assinatura que o compilaram
2
Ambiente declarado go linux x64 go go go

Ambientes das execuções de verificação

Ambiente Contrato Etapas Execução
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

Caso

HOW
Objetivo
Prove that json.Encoder.Encode always writes a trailing newline to its output.
Pacotes
Símbolos
  • encoding/json.Encoder.Encode
Ambiente
go
Criado
2026-08-16T13:03:31Z

Contrato

  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

Arquivos

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

Baixar o artefato de código-fonte (tar.gz)

Código-fonte

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

Seeder de origem

csx-seed