sql-blocks 0.1.3__tar.gz → 0.2.0__tar.gz

{sql_blocks-0.1.3/sql_blocks.egg-info → sql_blocks-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sql_blocks
-Version: 0.1.3
+Version: 0.2.0
 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
@@ -55,12 +55,12 @@ You can specify your own alias:  `a = Select('Actor a')`
 ---
 
 ### 3 - To set conditions, use **Where**:
-* For example, `a = Select(... age=Where.gt(45) )`
+* For example, `a = Select(... age=gt(45) )`
 
     Some possible conditions:
-    * field=Where.eq(value) - ...the field is EQUAL to the value;
-    * field=Where.gt(value) - ...the field is GREATER than the value;
-    * field=Where.lt(value) - ...the field is LESS than the value;
+    * field=eq(value) - ...the field is EQUAL to the value;
+    * field=gt(value) - ...the field is GREATER than the value;
+    * field=lt(value) - ...the field is LESS than the value;
 
     3.1 -- If you want to filter the field on a range of values:
     
@@ -71,7 +71,7 @@ You can specify your own alias:  `a = Select('Actor a')`
 query = Select('Movie m', title=Field,
     id=SelectIN(
         'Review r',
-        rate=Where.gt(4.5),
+        rate=gt(4.5),
         movie_id=Distinct
     )
 )
@@ -92,8 +92,8 @@ query = Select('Movie m', title=Field,
 3.3 -- Optional conditions:
 ```
     OR=Options(
-        genre=Where.eq("Sci-Fi"),
-        awards=Where.like("Oscar")
+        genre=eq("Sci-Fi"),
+        awards=like("Oscar")
     )
 ```
 > Could be AND=Options(...)
@@ -105,7 +105,7 @@ based_on_book=Not.is_null()
 
 3.5 -- List of values
 ```
-hash_tag=Where.list(['space', 'monster', 'gore'])
+hash_tag=contains(['space', 'monster', 'gore'])
 ```
 
 ---
@@ -117,7 +117,7 @@ hash_tag=Where.list(['space', 'monster', 'gore'])
     ```    
     SelectIN(
         'Review r', movie=[GroupBy, Distinct],
-        rate=Having.avg(Where.gt(4.5))
+        rate=Having.avg(gt(4.5))
     )
     ```
 ---
@@ -299,7 +299,7 @@ m = Select...
 ```
 best_movies = SelectIN(
     Review=Table('role'),
-    rate=[GroupBy, Having.avg(Where.gt(4.5))]
+    rate=[GroupBy, Having.avg(gt(4.5))]
 )
 m1 = Select(
     Movie=Table('title,release_date'),
@@ -320,9 +320,9 @@ m2 = Select(
     Select(
         'Product',
         label=Case('price').when(
-            Where.lt(50), 'cheap'
+            lt(50), 'cheap'
         ).when(
-            Where.gt(100), 'expensive'
+            gt(100), 'expensive'
         ).else_value(
             'normal'
         )
@@ -360,3 +360,22 @@ m2 = Select(
 * Replace `YEAR` function with date range comparison.
 
 > The method allows you to select which rules you want to apply in the optimization...Or define your own rules!
+
+---
+
+### 12 - Adding multiple fields at once
+```
+    query = Select('post p')
+    query.add_fields(
+        'user_id, created_at',
+        order_by=True, group_by=True
+    )
+```
+...is the same as...
+```
+    query = Select(
+        'post p',
+        user_id=[Field, GroupBy, OrderBy],
+        created_at=[Field, GroupBy, OrderBy]
+    )
+```

{sql_blocks-0.1.3 → sql_blocks-0.2.0}/README.md

@@ -40,12 +40,12 @@ You can specify your own alias:  `a = Select('Actor a')`
 ---
 
 ### 3 - To set conditions, use **Where**:
-* For example, `a = Select(... age=Where.gt(45) )`
+* For example, `a = Select(... age=gt(45) )`
 
     Some possible conditions:
-    * field=Where.eq(value) - ...the field is EQUAL to the value;
-    * field=Where.gt(value) - ...the field is GREATER than the value;
-    * field=Where.lt(value) - ...the field is LESS than the value;
+    * field=eq(value) - ...the field is EQUAL to the value;
+    * field=gt(value) - ...the field is GREATER than the value;
+    * field=lt(value) - ...the field is LESS than the value;
 
     3.1 -- If you want to filter the field on a range of values:
     
@@ -56,7 +56,7 @@ You can specify your own alias:  `a = Select('Actor a')`
 query = Select('Movie m', title=Field,
     id=SelectIN(
         'Review r',
-        rate=Where.gt(4.5),
+        rate=gt(4.5),
         movie_id=Distinct
     )
 )
@@ -77,8 +77,8 @@ query = Select('Movie m', title=Field,
 3.3 -- Optional conditions:
 ```
     OR=Options(
-        genre=Where.eq("Sci-Fi"),
-        awards=Where.like("Oscar")
+        genre=eq("Sci-Fi"),
+        awards=like("Oscar")
     )
 ```
 > Could be AND=Options(...)
@@ -90,7 +90,7 @@ based_on_book=Not.is_null()
 
 3.5 -- List of values
 ```
-hash_tag=Where.list(['space', 'monster', 'gore'])
+hash_tag=contains(['space', 'monster', 'gore'])
 ```
 
 ---
@@ -102,7 +102,7 @@ hash_tag=Where.list(['space', 'monster', 'gore'])
     ```    
     SelectIN(
         'Review r', movie=[GroupBy, Distinct],
-        rate=Having.avg(Where.gt(4.5))
+        rate=Having.avg(gt(4.5))
     )
     ```
 ---
@@ -284,7 +284,7 @@ m = Select...
 ```
 best_movies = SelectIN(
     Review=Table('role'),
-    rate=[GroupBy, Having.avg(Where.gt(4.5))]
+    rate=[GroupBy, Having.avg(gt(4.5))]
 )
 m1 = Select(
     Movie=Table('title,release_date'),
@@ -305,9 +305,9 @@ m2 = Select(
     Select(
         'Product',
         label=Case('price').when(
-            Where.lt(50), 'cheap'
+            lt(50), 'cheap'
         ).when(
-            Where.gt(100), 'expensive'
+            gt(100), 'expensive'
         ).else_value(
             'normal'
         )
@@ -344,4 +344,23 @@ m2 = Select(
 * Auto includes fields present in `ORDER/GROUP BY`;
 * Replace `YEAR` function with date range comparison.
 
-> The method allows you to select which rules you want to apply in the optimization...Or define your own rules!
+> The method allows you to select which rules you want to apply in the optimization...Or define your own rules!
+
+---
+
+### 12 - Adding multiple fields at once
+```
+    query = Select('post p')
+    query.add_fields(
+        'user_id, created_at',
+        order_by=True, group_by=True
+    )
+```
+...is the same as...
+```
+    query = Select(
+        'post p',
+        user_id=[Field, GroupBy, OrderBy],
+        created_at=[Field, GroupBy, OrderBy]
+    )
+```

{sql_blocks-0.1.3 → sql_blocks-0.2.0}/pyproject.toml

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

{sql_blocks-0.1.3 → sql_blocks-0.2.0}/setup.py

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

{sql_blocks-0.1.3 → sql_blocks-0.2.0}/sql_blocks/sql_blocks.py

@@ -74,14 +74,18 @@ class SQLObject:
             if symmetrical:
                 fld = fld.lower()
             return fld.strip()
-        # if key == SELECT and re.search(' as | AS ', fld)
+        def is_named_field(fld: str) -> bool:
+            return key == SELECT and re.search(' as | AS ', fld)
         pattern = KEYWORD[key][2] 
         if key == WHERE and symmetrical:
             pattern = f'{PATTERN_PREFIX}| '
         separator = self.get_separator(key)
         def field_set(source: list) -> set:
             return set(
-                re.sub(pattern, '', cleanup(fld))
+                (
+                    fld if is_named_field(fld) else
+                    re.sub(pattern, '', cleanup(fld))
+                )
                 for string in source
                 for fld in re.split(separator, string)
             )       
@@ -172,17 +176,27 @@ class ExpressionField:
             a=main.alias, f=name, t=main.table_name
         )
 
+class FieldList:
+    separator = ','
 
-class Table:
-    def __init__(self, fields: list=[]):
+    def __init__(self, fields: list=[], class_types = [Field]):
         if isinstance(fields, str):
-            fields = [f.strip() for f in fields.split(',')]
+            fields = [
+                f.strip() for f in fields.split(self.separator)
+            ]
         self.fields = fields
+        self.class_types = class_types
 
     def add(self, name: str, main: SQLObject):
-        main.set_table(name)
         for field in self.fields:
-            Field.add(field, main)
+            for class_type in self.class_types:
+                class_type.add(field, main)
+
+
+class Table(FieldList):
+    def add(self, name: str, main: SQLObject):
+        main.set_table(name)
+        super().add(name, main)
 
 
 class PrimaryKey:
@@ -257,7 +271,7 @@ class Where:
         return cls('IS NULL')
     
     @classmethod
-    def list(cls, values):
+    def contains(cls, values):
         if isinstance(values, list):
             values = ','.join(quoted(v) for v in values)
         return cls(f'IN ({values})')
@@ -268,6 +282,12 @@ class Where:
         ))
 
 
+eq, like, gt, gte, lt, lte, is_null, contains = (
+    getattr(Where, method) for method in 
+    ('eq', 'like', 'gt', 'gte', 'lt', 'lte', 'is_null', 'contains')
+) 
+
+
 class Not(Where):
     prefix = 'NOT '
 
@@ -342,9 +362,12 @@ class OrderBy:
     sort: SortType = SortType.ASC
     @classmethod
     def add(cls, name: str, main: SQLObject):
-        if main.alias:
+        found = re.findall(r'^_\d', name)
+        if found:
+            name = found[0].replace('_', '')
+        elif main.alias:
             name = f'{main.alias}.{name}'
-        main.values.setdefault(ORDER_BY, []).append(name + cls.sort.value)
+        main.values.setdefault(ORDER_BY, []).append(name+cls.sort.value)
 
 
 class GroupBy:
@@ -410,17 +433,16 @@ class Select(SQLObject):
             self.values.setdefault(key, []).append(value)
 
     def add(self, name: str, main: SQLObject):
-        new_tables = [
+        old_tables = main.values.get(FROM, [])
+        new_tables = set([
             '{jt}JOIN {tb} {a2} ON ({a1}.{f1} = {a2}.{f2})'.format(
                 jt=self.join_type.value,
                 tb=self.table_name,
                 a1=main.alias, f1=name,
                 a2=self.alias, f2=self.key_field
             )
-        ]
-        if new_tables not in main.values.get(FROM, []):
-            new_tables += self.values[FROM][1:]
-            main.values.setdefault(FROM, []).extend(new_tables)
+        ] + old_tables[1:])
+        main.values[FROM] = old_tables[:1] + list(new_tables)
         for key in USUAL_KEYS:
             main.update_values(key, self.values.get(key, []))
 
@@ -553,13 +575,22 @@ class Select(SQLObject):
         for rule in rules:
             rule.apply(self)
 
+    def add_fields(self, fields: list, order_by: bool=False, group_by:bool=False):
+        class_types = [Field]
+        if order_by:
+            class_types += [OrderBy]
+        if group_by:
+            class_types += [GroupBy]
+        FieldList(fields, class_types).add('', self)
+
+
 
 class SelectIN(Select):
     condition_class = Where
 
     def add(self, name: str, main: SQLObject):
         self.break_lines = False
-        self.condition_class.list(self).add(name, main)
+        self.condition_class.contains(self).add(name, main)
 
 SubSelect = SelectIN
 
@@ -574,6 +605,7 @@ class RulePutLimit(Rule):
         if need_limit:
             target.limit()
 
+
 class RuleSelectIN(Rule):
     @classmethod
     def apply(cls, target: Select):
@@ -588,6 +620,7 @@ class RuleSelectIN(Rule):
                     ','.join(t.split('=')[-1].strip() for t in tokens)
                 )
 
+
 class RuleAutoField(Rule):
     @classmethod
     def apply(cls, target: Select):
@@ -599,13 +632,11 @@ class RuleAutoField(Rule):
             s2 = set(target.values[ORDER_BY])
             target.values.setdefault(SELECT, []).extend( list(s2-s1) )
 
+
 class RuleLogicalOp(Rule):
-    REVERSE = {
-        ">=": "<",
-        "<=": ">",
-        "<>": "=",
-        "=": "<>"
-    }
+    REVERSE = {">=": "<", "<=": ">", "=": "<>"}
+    REVERSE |= {v: k for k, v in REVERSE.items()}
+
     @classmethod
     def apply(cls, target: Select):
         REGEX = re.compile('({})'.format(
@@ -613,13 +644,14 @@ class RuleLogicalOp(Rule):
         ))
         for i, condition in enumerate(target.values.get(WHERE, [])):
             expr = re.sub('\n|\t', ' ', condition)
-            tokens = [t for t in re.split(r'(NOT\b|not\b)',expr) if t.strip()]
-            if len(tokens) < 2 or not REGEX.findall(tokens[-1]):
+            if not re.search(r'\b(NOT|not)\b', expr):
                 continue
-            tokens = REGEX.split(tokens[-1])
-            tokens[1] = cls.REVERSE[tokens[1]]
+            tokens = [t.strip() for t in re.split(r'NOT\b|not\b|(<|>|=)', expr) if t]
+            op = ''.join(tokens[1: len(tokens)-1])
+            tokens = [tokens[0], cls.REVERSE[op], tokens[-1]]
             target.values[WHERE][i] = ' '.join(tokens)
 
+
 class RuleDateFuncReplace(Rule):
     """
     SQL algorithm by Ralff Matias

{sql_blocks-0.1.3 → sql_blocks-0.2.0/sql_blocks.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sql_blocks
-Version: 0.1.3
+Version: 0.2.0
 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
@@ -55,12 +55,12 @@ You can specify your own alias:  `a = Select('Actor a')`
 ---
 
 ### 3 - To set conditions, use **Where**:
-* For example, `a = Select(... age=Where.gt(45) )`
+* For example, `a = Select(... age=gt(45) )`
 
     Some possible conditions:
-    * field=Where.eq(value) - ...the field is EQUAL to the value;
-    * field=Where.gt(value) - ...the field is GREATER than the value;
-    * field=Where.lt(value) - ...the field is LESS than the value;
+    * field=eq(value) - ...the field is EQUAL to the value;
+    * field=gt(value) - ...the field is GREATER than the value;
+    * field=lt(value) - ...the field is LESS than the value;
 
     3.1 -- If you want to filter the field on a range of values:
     
@@ -71,7 +71,7 @@ You can specify your own alias:  `a = Select('Actor a')`
 query = Select('Movie m', title=Field,
     id=SelectIN(
         'Review r',
-        rate=Where.gt(4.5),
+        rate=gt(4.5),
         movie_id=Distinct
     )
 )
@@ -92,8 +92,8 @@ query = Select('Movie m', title=Field,
 3.3 -- Optional conditions:
 ```
     OR=Options(
-        genre=Where.eq("Sci-Fi"),
-        awards=Where.like("Oscar")
+        genre=eq("Sci-Fi"),
+        awards=like("Oscar")
     )
 ```
 > Could be AND=Options(...)
@@ -105,7 +105,7 @@ based_on_book=Not.is_null()
 
 3.5 -- List of values
 ```
-hash_tag=Where.list(['space', 'monster', 'gore'])
+hash_tag=contains(['space', 'monster', 'gore'])
 ```
 
 ---
@@ -117,7 +117,7 @@ hash_tag=Where.list(['space', 'monster', 'gore'])
     ```    
     SelectIN(
         'Review r', movie=[GroupBy, Distinct],
-        rate=Having.avg(Where.gt(4.5))
+        rate=Having.avg(gt(4.5))
     )
     ```
 ---
@@ -299,7 +299,7 @@ m = Select...
 ```
 best_movies = SelectIN(
     Review=Table('role'),
-    rate=[GroupBy, Having.avg(Where.gt(4.5))]
+    rate=[GroupBy, Having.avg(gt(4.5))]
 )
 m1 = Select(
     Movie=Table('title,release_date'),
@@ -320,9 +320,9 @@ m2 = Select(
     Select(
         'Product',
         label=Case('price').when(
-            Where.lt(50), 'cheap'
+            lt(50), 'cheap'
         ).when(
-            Where.gt(100), 'expensive'
+            gt(100), 'expensive'
         ).else_value(
             'normal'
         )
@@ -360,3 +360,22 @@ m2 = Select(
 * Replace `YEAR` function with date range comparison.
 
 > The method allows you to select which rules you want to apply in the optimization...Or define your own rules!
+
+---
+
+### 12 - Adding multiple fields at once
+```
+    query = Select('post p')
+    query.add_fields(
+        'user_id, created_at',
+        order_by=True, group_by=True
+    )
+```
+...is the same as...
+```
+    query = Select(
+        'post p',
+        user_id=[Field, GroupBy, OrderBy],
+        created_at=[Field, GroupBy, OrderBy]
+    )
+```