dplex 0.3.2__tar.gz → 0.3.3__tar.gz

{dplex-0.3.2 → dplex-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dplex
-Version: 0.3.2
+Version: 0.3.3
 Summary: 
 License-Expression: MIT
 License-File: LICENSE

{dplex-0.3.2 → dplex-0.3.3}/dplex/internal/filter_applier.py

@@ -419,6 +419,9 @@ class FilterApplier:
         self,
         query_builder: SupportsFiltering,
         filter_data: WordsFilter,
+        *,
+        model: type | None = None,
+        field_name: str | None = None,
     ) -> SupportsFiltering:
         """
         Применить фильтр слов к нескольким колонкам
@@ -427,37 +430,41 @@ class FilterApplier:
         Для каждого слова создается условие OR (слово должно быть найдено хотя бы в одной колонке).
         Все слова объединяются через AND (все слова должны быть найдены).
 
-        Если filter_data.text или filter_data.columns равны None, фильтр не применяется.
+        Если filter_data.columns равен None, используются колонка текущего поля (model, field_name).
+        При отсутствии поля в модели выбрасывается ValueError.
+
+        Если filter_data.text пустой, фильтр не применяется.
 
         Args:
             query_builder: Query builder для применения фильтров
-            filter_data: Экземпляр WordsFilter с указанными колонками
+            filter_data: Экземпляр WordsFilter
+            model: Модель для разрешения колонки по имени поля (при columns=None)
+            field_name: Имя поля для поиска (при columns=None)
 
         Returns:
             Query builder с примененным фильтром слов (или без изменений, если фильтр не активен)
 
-        Examples:
-            >>> from sqlalchemy import and_, or_
-            >>> words_filter = WordsFilter("john developer", columns=[User.name, User.email])
-            >>> query = applier.apply_words_filter(query_builder, words_filter)
-            >>>
-            >>> # Фильтр не будет применен, если text или columns равны None
-            >>> inactive_filter = WordsFilter(None, None)
-            >>> query = applier.apply_words_filter(query_builder, inactive_filter)  # вернет query без изменений
+        Raises:
+            ValueError: Если columns=None, field_name не задан или поле отсутствует в модели
         """
         from sqlalchemy import and_, or_
 
-        search_columns = filter_data.columns
-
-        # Если columns равны None или пустые, фильтр не применяется
-        if search_columns is None or not search_columns:
-            return query_builder
-
         words = filter_data.words
-        # Если words пустые (text был None или пустой), фильтр не применяется
+        # Если text пустой — фильтр не применяется (не проверяем columns)
         if not words:
             return query_builder
 
+        search_columns = filter_data.columns
+        # Если columns заданы — используем их; иначе — колонку текущего поля
+        if search_columns is None or not search_columns:
+            if model is None or field_name is None:
+                return query_builder
+            if not hasattr(model, field_name):
+                raise ValueError(
+                    f"WordsFilter: модель {model.__name__} не имеет поля '{field_name}'"
+                )
+            search_columns = [getattr(model, field_name)]
+
         # Для каждого слова создаем условие: слово должно быть найдено хотя бы в одной колонке (OR)
         word_conditions = []
         for word in words:
@@ -516,8 +523,9 @@ class FilterApplier:
 
             # Обрабатываем WordsFilter отдельно (может быть кастомным фильтром)
             if isinstance(field_value, WordsFilter):
-                # WordsFilter теперь всегда имеет колонки (обязательный параметр)
-                query_builder = self.apply_words_filter(query_builder, field_value)
+                query_builder = self.apply_words_filter(
+                    query_builder, field_value, model=model, field_name=field_name
+                )
                 continue
 
             # Пропускаем поля, отсутствующие в модели

{dplex-0.3.2 → dplex-0.3.3}/dplex/internal/filters.py

@@ -873,30 +873,30 @@ class WordsFilter:
     Фильтр для поиска по нескольким словам с автоматической разбивкой строки
 
     Автоматически разбивает строку на слова и предоставляет их для поиска.
-    Предназначен для кастомных фильтров, где нужно искать каждое слово
-    в разных колонках модели.
+    Поддерживает два режима:
+    - columns задан: поиск в указанных колонках (для кастомных полей вроде query)
+    - columns=None: поиск в колонке текущего поля схемы (имя поля = имя колонки модели).
+      Если поле отсутствует в модели, при применении фильтра выбрасывается ValueError.
 
     Args:
         text: Строка для поиска, которая будет автоматически разбита на слова.
-              Если None, фильтр не будет применяться.
+              Если None или пустая, фильтр не применяется.
         columns: Список колонок модели для поиска.
-                 Если None, фильтр не будет применяться.
+                 Если None, используется колонка текущего поля (где WordsFilter в схеме).
 
     Examples:
-        >>> # Использование с указанием колонок
-        >>> words_filter = WordsFilter("john developer", columns=[User.name, User.email, User.bio])
-        >>> # words_filter.words = ["john", "developer"]
+        >>> # Поиск по текущему полю (name в схеме -> User.name в модели)
+        >>> class UserFilters(DPFilters):
+        ...     name: WordsFilter | None = None
+        >>> filters = UserFilters(name=WordsFilter("john"))  # поиск в User.name
         >>>
-        >>> # В схеме фильтрации
+        >>> # Поиск в нескольких колонках (кастомное поле query)
         >>> class UserFilters(DPFilters):
         ...     query: WordsFilter | None = None
+        >>> filters = UserFilters(query=WordsFilter("john dev", columns=[User.name, User.email, User.bio]))
         >>>
-        >>> filters = UserFilters(query=WordsFilter("python developer", columns=[User.name, User.email]))
-        >>>
-        >>> # Упрощенное использование: если text или columns равны None, фильтр не применяется
-        >>> filters = UserFilters(query=WordsFilter(None, None))  # фильтр не будет применен
-        >>> filters = UserFilters(query=WordsFilter("text", None))  # фильтр не будет применен
-        >>> filters = UserFilters(query=WordsFilter(None, [User.name]))  # фильтр не будет применен
+        >>> # Не применяется при пустом text
+        >>> filters = UserFilters(name=WordsFilter(None))  # фильтр не будет применен
     """
 
     def __init__(
@@ -907,9 +907,10 @@ class WordsFilter:
 
         Args:
             text: Строка для поиска, которая будет автоматически разбита на слова.
-                  Если None, фильтр не будет применяться.
+                  Если None, фильтр не применяется.
             columns: Список колонок модели для поиска.
-                     Если None, фильтр не будет применяться.
+                     Если None, используется колонка текущего поля (при применении).
+                     Поле должно существовать в модели, иначе ValueError.
 
         Returns:
             None
@@ -953,8 +954,10 @@ class WordsFilter:
 
     def __str__(self) -> str:
         """Человекочитаемое представление"""
-        if self.columns is None or not self.text:
+        if not self.text:
             return "WordsFilter(inactive)"
         if self.words:
-            return f"WordsFilter({len(self.words)} words: {', '.join(self.words)} in {len(self.columns)} columns)"
+            if self.columns:
+                return f"WordsFilter({len(self.words)} words: {', '.join(self.words)} in {len(self.columns)} columns)"
+            return f"WordsFilter({len(self.words)} words: {', '.join(self.words)} in current field)"
         return "WordsFilter(empty)"

{dplex-0.3.2 → dplex-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dplex"
-version = "0.3.2"
+version = "0.3.3"
 description = ""
 authors = [
     {name = "Igor Chesnokov",email = "front-gold@mail.ru"}