From 8fac5002282cec9ab87e1c5f3bde685475dbf615 Mon Sep 17 00:00:00 2001
From: Semyon Krestyaninov <ensiouel@gmail.com>
Date: Thu, 15 Feb 2024 17:14:39 +0300
Subject: [PATCH] fix docs
---
log/zap/filter_core.go | 13 +++++++++++++
1 file changed, 13 insertions(+)
diff --git a/log/zap/filter_core.go b/log/zap/filter_core.go
index 5d984413..1c6099e6 100644
--- a/log/zap/filter_core.go
+++ b/log/zap/filter_core.go
@@ -34,6 +34,19 @@ type filterCore struct {
fields []zap.Field
}
+// RegisterFilters - добавить фильтры, которые будут применяться при записи лога (вызове `core.Write`)
+// Метод `core.Write` будет вызван только в случае, когда результат всех фильтров `true`
+//
+// Обратить внимание, фильтр не применяется к полям, которые были добавлены в `core` через вызов `core.With`
+// до вызова RegisterFilters. Пример:
+//
+// l, _ := zap.NewDevelopment()
+// core := l.Core().With([]zapcore.Field{zap.Int("a", 5)})
+// core = RegisterFilters(core, HasField(zap.Int("a", 5)))
+//
+// logger := zap.New(core)
+// logger.Info("Test log") // НЕ будет записан
+// logger.Info("Test log", zap.Int("a", 5)) // будет записан
func RegisterFilters(core zapcore.Core, filters ...FilterFunc) zapcore.Core {
return &filterCore{
Core: core,
--
GitLab