sql-blocks 1.2025.629__tar.gz → 1.2025.701__tar.gz

{sql_blocks-1.2025.629/sql_blocks.egg-info → sql_blocks-1.2025.701}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sql_blocks
-Version: 1.2025.629
+Version: 1.2025.701
 Summary: Allows you to create objects for parts of SQL query commands. Also to combine these objects by joining them, adding or removing parts...
 Home-page: https://github.com/julio-cascalles/sql_blocks
 Author: Júlio Cascalles
@@ -415,7 +415,7 @@ m2 = Select(
         )
     )
 
-10.1 - If the labels used in the CASE are based on ranges of values ​​in sequence, you can use the **Range class**:
+* 10.1 - If the labels used in the CASE are based on ranges of values ​​in sequence, you can use the **Range class**:
 
         query = Select(
             'People p',
@@ -440,6 +440,28 @@ is equivalent to...
         FROM
                 People p
 ```
+
+* 10.2 `If` class
+
+Usefull to conditional Sum, Avg, Count...
+
+**Example:**
+
+    Select('Emprestimo', 
+        taxa=If('atraso', gt(0), Sum)
+    )
+
+results...
+```
+SELECT
+        Sum(CASE
+                WHEN atraso > 0 THEN taxa
+                ELSE 0
+        END)
+FROM
+        Emprestimo
+```
+
 ---
 
 ### 11 - optimize method

{sql_blocks-1.2025.629 → sql_blocks-1.2025.701}/README.md

@@ -400,7 +400,7 @@ m2 = Select(
         )
     )
 
-10.1 - If the labels used in the CASE are based on ranges of values ​​in sequence, you can use the **Range class**:
+* 10.1 - If the labels used in the CASE are based on ranges of values ​​in sequence, you can use the **Range class**:
 
         query = Select(
             'People p',
@@ -425,6 +425,28 @@ is equivalent to...
         FROM
                 People p
 ```
+
+* 10.2 `If` class
+
+Usefull to conditional Sum, Avg, Count...
+
+**Example:**
+
+    Select('Emprestimo', 
+        taxa=If('atraso', gt(0), Sum)
+    )
+
+results...
+```
+SELECT
+        Sum(CASE
+                WHEN atraso > 0 THEN taxa
+                ELSE 0
+        END)
+FROM
+        Emprestimo
+```
+
 ---
 
 ### 11 - optimize method

{sql_blocks-1.2025.629 → sql_blocks-1.2025.701}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sql_blocks"
-version = "1.2025.0629"
+version = "1.2025.0701"
 authors = [
   { name="Julio Cascalles", email="julio.cascalles@outlook.com" },
 ]

{sql_blocks-1.2025.629 → sql_blocks-1.2025.701}/setup.py

@@ -3,7 +3,7 @@ from setuptools import setup
 
 setup(
     name = 'sql_blocks',
-    version = '1.2025.0629',
+    version = '1.2025.0701',
     author = 'Júlio Cascalles',
     author_email = 'julio.cascalles@outlook.com',
     packages = ['sql_blocks'],

{sql_blocks-1.2025.629 → sql_blocks-1.2025.701}/sql_blocks/sql_blocks.py

@@ -210,6 +210,34 @@ class NamedField:
         )
 
 
+class Code:
+    def __init__(self):
+        # --- Replace class method by instance method: ------
+        self.add = self.__add
+        # -----------------------------------------------------
+        self.field_class = Field
+        self.extra = {}
+
+    def As(self, field_alias: str, modifiers=None):
+        if modifiers:
+            self.extra[field_alias] = TO_LIST(modifiers)
+        self.field_class = NamedField(field_alias)
+        return self
+    
+    def format(self, name: str, main: SQLObject) -> str:
+        raise NotImplementedError('Use child classes instead of this one')
+
+    def __add(self, name: str, main: SQLObject):
+        name = self.format(name, main)
+        self.field_class.add(name, main)
+        if self.extra:
+            main.__call__(**self.extra)
+
+    @classmethod
+    def add(cls, name: str, main: SQLObject):
+        cls().__add(name, main)
+
+
 class Dialect(Enum):
     ANSI = 0
     SQL_SERVER = 1
@@ -220,7 +248,7 @@ class Dialect(Enum):
 SQL_TYPES = 'CHAR INT DATE FLOAT ANY'.split()
 CHAR, INT, DATE, FLOAT, ANY  =  SQL_TYPES
 
-class Function:
+class Function(Code):
     dialect = Dialect.ANSI
     inputs = None
     output = None
@@ -241,24 +269,13 @@ class Function:
                 if unfriendly:
                     return Cast(func, main_param)
             return param
-        # --- Replace class methods by instance methods: ------
-        self.add = self.__add
-        self.format = self.__format
-        # -----------------------------------------------------
         self.params = [set_func_types(p) for p in params]
-        self.field_class = Field
         self.pattern = self.get_pattern()
-        self.extra = {}
+        super().__init__()
     
     def get_pattern(self) -> str:
         return '{func_name}({params})'
 
-    def As(self, field_alias: str, modifiers=None):
-        if modifiers:
-            self.extra[field_alias] = TO_LIST(modifiers)
-        self.field_class = NamedField(field_alias)
-        return self
-
     def __str__(self) -> str:
         return self.pattern.format(
             func_name=self.__class__.__name__,
@@ -288,24 +305,11 @@ class Function:
         else:
             self.params = new_params + self.params         
 
-    def __format(self, name: str, main: SQLObject) -> str:
+    def format(self, name: str, main: SQLObject) -> str:
         if name not in '*_':
             self.set_main_param(name, main)
         return str(self)
 
-    @classmethod
-    def format(cls, name: str, main: SQLObject):
-        return cls().__format(name, main)
-
-    def __add(self, name: str, main: SQLObject):
-        name = self.format(name, main)
-        self.field_class.add(name, main)
-        if self.extra:
-            main.__call__(**self.extra)
-
-    @classmethod
-    def add(cls, name: str, main: SQLObject):
-        cls().__add(name, main)
 
 
 # ---- String Functions: ---------------------------------
@@ -395,15 +399,15 @@ class Frame:
         keywords = ''
         for field, obj in args.items():
             is_valid = any([
-                obj is OrderBy,
+                obj is OrderBy, obj is DescOrderBy,
                 obj is Partition,
                 isinstance(obj, Rows),
             ])
             if not is_valid:
                 continue
-            keywords += '{}{} {}'.format(
+            keywords += '{}{}'.format(
                 '\n\t\t' if self.break_lines else ' ',
-                obj.cls_to_str(), field if field != '_' else ''
+                obj.cls_to_str(field if field != '_' else '')
             )
         if keywords and self.break_lines:
             keywords += '\n\t'
@@ -750,7 +754,10 @@ class Case:
         while tokens:
             word = tokens.pop(0)
             if last_word in KEYWORDS:
-                block = KEYWORDS[last_word](word)
+                try:
+                    block = KEYWORDS[last_word](word)
+                except:
+                    break
                 result += block.fields
                 block.fields = []
             elif word not in RESERVED_WORDS:
@@ -759,6 +766,27 @@ class Case:
         return result
 
 
+class If(Code, Frame):
+    """
+    Behaves like an aggregation function
+    """
+    def __init__(self, field: str, condition: Where, func_class: Function):
+        self.field = field
+        self.condition = condition
+        self.func_class = func_class
+        super().__init__()
+
+    def format(self, name: str, main: SQLObject) -> str:
+        return '{func}({param}){over}'.format(
+            func=self.func_class.__name__,
+            param=Case(self.field).when(self.condition, f'={name}').else_value(0),
+            over=self.pattern
+        )
+    
+    def get_pattern(self) -> str:
+        return ''
+
+
 class Options:
     def __init__(self, **values):
         self.__children: dict = values
@@ -857,7 +885,7 @@ class Rows:
     def __init__(self, *rows: list[Row]):
         self.rows = rows
 
-    def cls_to_str(self) -> str:
+    def cls_to_str(self, field: str='') -> str:
         return 'ROWS {}{}'.format(
             'BETWEEN ' if len(self.rows) > 1 else '',
             ' AND '.join(str(row) for row in self.rows)
@@ -870,6 +898,11 @@ class DescOrderBy:
         name = Clause.format(name, main)
         main.values.setdefault(ORDER_BY, []).append(name + SortType.DESC.value)
 
+    @classmethod
+    def cls_to_str(cls, field: str='') -> str:
+        return f"{ORDER_BY} {field} DESC"
+
+
 class OrderBy(Clause):
     sort: SortType = SortType.ASC
     DESC = DescOrderBy
@@ -894,14 +927,13 @@ class OrderBy(Clause):
         return super().format(name, main)
 
     @classmethod
-    def cls_to_str(cls) -> str:
-        return ORDER_BY
+    def cls_to_str(cls, field: str='') -> str:
+        return f"{ORDER_BY} {field}"
 
-PARTITION_BY = 'PARTITION BY'
 class Partition:
     @classmethod
-    def cls_to_str(cls) -> str:
-        return PARTITION_BY
+    def cls_to_str(cls, field: str) -> str:
+        return f'PARTITION BY {field}'
 
 
 class GroupBy(Clause):
@@ -918,7 +950,7 @@ class Having:
 
     def add(self, name: str, main:SQLObject):
         main.values[GROUP_BY][-1] += ' HAVING {} {}'.format(
-            self.function.format(name, main), self.condition.content
+            self.function().format(name, main), self.condition.content
         )
     
     @classmethod
@@ -2297,4 +2329,16 @@ def detect(text: str, join_queries: bool = True, format: str='') -> Select | lis
     for query in query_list[1:]:
         result += query
     return result
-# ===========================================================================================//
+# ===========================================================================================//
+
+if __name__ == "__main__":
+    query = Select(
+        'Emprestimos e',
+        taxa=If('atraso', gt(0), Sum).over(            
+            mes_ano=OrderBy.DESC,
+            _=Rows(Current(), Following(5)),
+            # _=Rows(Preceding(3), Following()),
+            # _=Rows( Preceding(3) ),
+        ).As('multa')
+    )
+    print(query)

{sql_blocks-1.2025.629 → sql_blocks-1.2025.701/sql_blocks.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sql_blocks
-Version: 1.2025.629
+Version: 1.2025.701
 Summary: Allows you to create objects for parts of SQL query commands. Also to combine these objects by joining them, adding or removing parts...
 Home-page: https://github.com/julio-cascalles/sql_blocks
 Author: Júlio Cascalles
@@ -415,7 +415,7 @@ m2 = Select(
         )
     )
 
-10.1 - If the labels used in the CASE are based on ranges of values ​​in sequence, you can use the **Range class**:
+* 10.1 - If the labels used in the CASE are based on ranges of values ​​in sequence, you can use the **Range class**:
 
         query = Select(
             'People p',
@@ -440,6 +440,28 @@ is equivalent to...
         FROM
                 People p
 ```
+
+* 10.2 `If` class
+
+Usefull to conditional Sum, Avg, Count...
+
+**Example:**
+
+    Select('Emprestimo', 
+        taxa=If('atraso', gt(0), Sum)
+    )
+
+results...
+```
+SELECT
+        Sum(CASE
+                WHEN atraso > 0 THEN taxa
+                ELSE 0
+        END)
+FROM
+        Emprestimo
+```
+
 ---
 
 ### 11 - optimize method