CodeSampleX

示例

github.com/lmittmann/tint 1.2.0: Pin down the log/slog Handler contract that custom and third-party handlers have to honour

已验证示例 — golang github.com/lmittmann/tint 1.2.0: Pin down the log/slog Handler contract that custom and third-party handlers have to honour. contract 在 go…

sha256:6af5bf59ebf30efdf1126ea505e09aa3ffbc7ae1997e37934d4ebacbbdc25dde

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

执行证据

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

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

验证运行环境

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

案例

HOW
目标
Pin down the log/slog Handler contract that custom and third-party handlers have to honour
包
符号
  • slog.NewJSONHandler
  • slog.HandlerOptions.ReplaceAttr
  • slog.Logger.WithGroup
  • slog.LogValuer
  • slog.Handler.Enabled
  • tint.NewTextHandler
  • tint.NewHandler
环境
go 1.26
创建时间
2026-08-14T12:53:34Z

契约

  1. assert JSONHandler writes time, level and msg in that order under slog's built-in key constants
  2. assert the JSON timestamp is RFC3339Nano with a variable-length fraction, while TextHandler and tint pad a time attribute to exactly three digits
  3. assert a zero Record.Time drops the timestamp field entirely
  4. assert ReplaceAttr renames the level and message keys and drops a field by returning a zero Attr
  5. assert a ReplaceAttr without a len(groups) guard renames a user attribute named msg inside a group as well
  6. assert the guard still cannot protect the built-in msg from a top-level attribute of the same name: the record carries two message keys and the JSON decoder keeps the last
  7. assert only a zero Attr drops a field, while an empty value or an empty key is still written out
  8. assert ReplaceAttr is called for the built-ins with no open groups and for a group's contents with the group path, never for the group attr itself
  9. assert WithGroup nests later attributes, an empty group is omitted, and WithGroup with an empty name is a no-op
  10. assert JSONHandler ignores fmt.Stringer and json-marshals the struct, while LogValue wins on both handlers
  11. assert Handler.Enabled is consulted and Handle is skipped when the level is disabled
  12. assert LogValue does not run for a disabled level but plain call arguments are evaluated anyway, and only an explicit Enabled guard skips them
  13. assert a LogValuer passed to With is resolved once, at With time, and not again per record
  14. assert WithAttrs and WithGroup each return a new handler, so a child logger's attrs and open group reach neither the parent nor a sibling
  15. assert tint follows the same ReplaceAttr, group and LogValuer contract but formats a Stringer with %+v and writes ANSI escapes to a non-terminal unless NoColor is set
  16. assert tint.NewHandler is the constructor deprecated in v1.2.0 and produces output identical to tint.NewTextHandler

文件

  • csx.json
  • go.mod
  • go.sum
  • src/logging.go
  • test/main.go

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

原始种子者

anonymous