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.…

sha256:6af5bf59ebf30efdf1126ea505e09aa3ffbc7ae1997e37934d4ebacbbdc25dde

Эта сеть предлагает одно: образец, который собирается. Она запустила его в песочнице и сохранила подписанную квитанцию. Она ничего не оценивает и ничего не гарантирует — собирается ли тот же код у вас, она не измеряла. Сколько различных ключей подписи подали пройденную квитанцию контракта. Один — только автор; больше одного — значит, кто-то ещё тоже собрал. Ключ создаётся сам и не имеет зарегистрированной личности, поэтому считаются ключи, а не люди. 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