Заменить или дополнить поле команд Pattern фильтрами

[EgorBron]

В других библиотеках, которыми я вдохновляюсь при создании этого модуля, присутствует полезный механизм фильтров. Благодаря этому можно ограничить возможные источники команд (или событий).

Фильтры должны покрывать как можно больше видов информации.

API будет примерно следующим:

filter := filters.NewFilter().PeerId(2000000001).DateF(filter.Before(time.Hour)).TextF(func(text string) bool { return text == "hello" })
// или сокращённо
filter := filters.PeerId(2000000001)
// или через старый способ
filter := vkc.Text("hello")

Фильтры будут принимать все объекты библиотеки, которые работают с событиями VK или потоками данных. Над итоговой реализацией я ещё подумаю.

[EgorBron]

В итоге API фильтров следующий. Он не зависит от остальной библиотеки:

const IntField FieldDescriptor = "int"
func MyFilter(match int) Filter {
	return NewFilter(IntField, func(value int) (bool, map[string]any) {
		return value == match, map[string]any{ "myint": 123 }
	})
}
filter := filters.New(filters.Text("hi"), vkfilters.MessagePeerId(2000000001), MyFilter(42))
// или
filter := filters.Text("hi") // .And(vkfilters.MessagePeerId(2000000001), MyFilter(42))

// вычисление фильтра
result, sideValues := filter.Eval(map[filters.FieldDescriptor]any{
	filters.TextField: "hi",
	vkfilters.MessageField: msg,
	IntField: 0
})

Пояснения:

• фильтры реализуют интерфейс Filter, который и следует использовать при работе с фильтрацией;
• стандартные фильтры - предикатный (FilterItem) и композитный (CompositeFilter);
• фильтры могут возвращать "побочные значения", которые могут понадобиться при анализе результатов фильтра (да, единственная ответственность фильтров нарушается, но что поделать).

Новые фильтры и описания полей будут добавляться постепенно.