dplex 0.2.8__tar.gz → 0.3.0__tar.gz

{dplex-0.2.8 → dplex-0.3.0}/PKG-INFO

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

{dplex-0.2.8 → dplex-0.3.0}/dplex/dp_filters.py

@@ -235,12 +235,17 @@ class DPFilters[SortFieldType](BaseModel):
 
     def has_sort(self) -> bool:
         """
-        Проверить, установлены ли параметры сортировки
+        Проверить, установлены ли параметры сортировки.
 
         Returns:
-            True если установлена сортировка, иначе False
+            True если есть хотя бы одно правило Sort с заданным полем (by is not None), иначе False.
+            Sort(by=None) не считается активной сортировкой.
         """
-        return self.sort is not None
+        if self.sort is None:
+            return False
+        if isinstance(self.sort, list):
+            return any(s.by is not None for s in self.sort)
+        return self.sort.by is not None
 
     def __repr__(self) -> str:
         """
@@ -299,7 +304,12 @@ class DPFilters[SortFieldType](BaseModel):
             parts.append(f"{count} active filters")
 
         if self.has_sort():
-            sort_count = len(self.sort) if isinstance(self.sort, list) else 1
+            if isinstance(self.sort, list):
+                items = self.sort
+            else:
+                assert self.sort is not None  # has_sort() guarantees this
+                items = [self.sort]
+            sort_count = len([s for s in items if s.by is not None])
             parts.append(f"{sort_count} sort rule(s)")
 
         if self.has_pagination():

{dplex-0.2.8 → dplex-0.3.0}/dplex/dp_service.py

@@ -276,17 +276,17 @@ class DPService[
         sort: list[Sort[SortFieldSchemaType]] | Sort[SortFieldSchemaType] | None,
     ) -> list[Sort[SortFieldSchemaType]]:
         """
-        Нормализовать сортировку в список
+        Нормализовать сортировку в список.
+        Элементы Sort с by=None отфильтровываются — сортировка по ним не применяется.
         Args:
             sort: Один элемент Sort, список Sort или None
         Returns:
-            Список элементов сортировки (может быть пустым)
+            Список элементов сортировки с заданным полем (может быть пустым)
         """
         if sort is None:
             return []
-        if isinstance(sort, list):
-            return sort
-        return [sort]
+        items = sort if isinstance(sort, list) else [sort]
+        return [s for s in items if s.by is not None]
 
     def _apply_sort_to_query(
         self,
@@ -302,6 +302,8 @@ class DPService[
             QueryBuilder с примененной сортировкой
         """
         for sort_item in sort_list:
+            if sort_item.by is None:
+                continue
             column_name = self._sort_field_to_column_name(sort_item.by)
             column = self._get_model_column(column_name)
             desc_order = sort_item.order == Order.DESC

{dplex-0.2.8 → dplex-0.3.0}/dplex/internal/sort.py

@@ -65,7 +65,7 @@ class Sort[SortByType]:
         SortByType: Тип поля для сортировки (обычно str или Enum)
 
     Attributes:
-        by: Поле для сортировки
+        by: Поле для сортировки; если None — сортировка не применяется (удобно для запросов с опциональным sort_by)
         order: Направление сортировки (по умолчанию ASC)
         nulls: Размещение NULL значений (по умолчанию None - поведение СУБД)
 
@@ -73,8 +73,9 @@ class Sort[SortByType]:
     Notes:
         - Класс immutable (frozen=True) для безопасного использования в хешируемых структурах
         - Параметр nulls опционален - если None, используется поведение СУБД по умолчанию
+        - При by=None правило сортировки игнорируется (можно передавать Sort(by=request.sort_by, order=...) при опциональном sort_by)
     """
 
-    by: SortByType
+    by: SortByType | None = None
     order: Order = Order.ASC
     nulls: NullsPlacement | None = None

{dplex-0.2.8 → dplex-0.3.0}/pyproject.toml

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