Updating querpy

README.md

@@ -3,6 +3,10 @@
 The Query class is intended to provide a high level interface for
 building/editing SQL query strings.
 
+This library should now support python 3.
+
+
+
 Example usage:
 ```python
     >>> from querpy import Query
@@ -11,7 +15,7 @@ Example usage:
     >>> new_query.s += ['col1', 'col2', 'col3']  # can take lists
     >>> new_query.s += 'col4'  # can take single strings
     >>> new_query.w += 'col1 = 1'  # can also take a list (separated by AND)
-    >>> new_query.w &= 'col2 IS NULL'  # handles &= and |= operators
+    >>> new_query.w |= 'col2 IS NULL'  # handles &= and |= operators
     >>> print new_query
     SELECT
         col1,
@@ -71,12 +75,11 @@ Suppose you want to extend your query by joining to another table and adding col
         col1 = 1 
           OR col2 IS NULL
 ```
-While this works, we are returning to the land of long strings. We can do the same thing (n.b. we'll LEFT JOIN this time) using the build_join helper function to make the join step more readable and modular:
+While this works, we are returning to the land of long strings. We can do the same thing (n.b. we'll LEFT JOIN this time) using the Query.build_join helper function to make the join step more readable and modular:
 ```python	
-    >>> from querpy import build_join
     >>> new_query.j.clear()
     >>> new_query.join_type = 'LEFT'
-    >>> new_query.j += build_join('ex_db.dbo.new_tbl nt', 'tbl.id', 'nt.id', 'tbl.city', 'nt.city')
+    >>> new_query.j += Query.build_join('ex_db.dbo.new_tbl nt', 'tbl.id', 'nt.id', 'tbl.city', 'nt.city')
     >>> new_query.join_type = ''  # set back to regular join
     >>> new_query
     SELECT
@@ -94,4 +97,33 @@ When your query string is ready to be passed to the function that will execute t
     >>> new_query.statement
     SELECT col2, nt.id FROM ex_db.dbo.ex_table tbl LEFT JOIN ex_db.dbo.new_tbl nt ON tbl.id = nt.id AND tbl.city = nt.city WHERE col1 = 1 OR col2 IS NULL
 ```
+
+You can also prepend a CREATE TABLE <> AS to the SQL
+```python
+    >>> new_query.j += 'ex_db.dbo.new_tbl nt ON tbl.id = nt.id'
+    >>> new_query.s += 'nt.id'
+    >>> new_query.g += 'col1'
+    >>> new_query.l += ' 10, 100' 
+    >>> new_query.ci += ' db_name.tbl_name ' 
+    >>> new_query
+    CREATE TABLE db_name.tbl_name AS 
+    SELECT
+        col1,
+        nt.id
+      FROM
+        ex_db.dbo.ex_table tbl
+          JOIN ex_db.dbo.new_tbl nt ON tbl.id = nt.id
+      WHERE
+        col1 = 1 
+          OR col2 IS NULL
+      GROUP BY 
+        col1
+      LIMIT 10, 100
+```
+
+
+Suppose you want to extend your query by joining to another table and adding columns from this table:
+
+
 NOTE: the SQL constructed is **not** validated.
+

doc_example.py

@@ -12,32 +12,38 @@
     ">>> new_query.s += 'col4'  # can take single strings",
     ">>> new_query.w += 'col1 = 1'  # can also take a list",
     ">>> new_query.w |= 'col2 IS NULL'  # handles &= and |= operators",
-    ">>> print new_query",
+    ">>> print(new_query)",
     ">>> new_query",
     ">>> new_query.s.clear()  # clear SELECT component",
     ">>> new_query.s += 'col1'",
     ">>> new_query",
     ">>> new_query.s[0] = 'col2'",
-    ">>> print new_query.s",
+    ">>> print(new_query.s)",
     ">>> new_query.j += 'ex_db.dbo.new_tbl nt ON tbl.id = nt.id'",
     ">>> new_query.s += 'nt.id'",
     ">>> new_query",
-    ">>> from querpy import build_join",
     ">>> new_query.j.clear()",
     ">>> new_query.join_type = 'LEFT'",
-    ">>> new_query.j += build_join('ex_db.dbo.new_tbl nt', 'tbl.id', 'nt.id',"
+    ">>> new_query.j += Query.build_join('ex_db.dbo.new_tbl nt', 'tbl.id', 'nt.id',"
     " 'tbl.city', 'nt.city')",
     ">>> new_query.join_type = ''  # set back to regular join",
+    ">>> new_query.ci += 'thisDB.thatTable'  # set back to regular join",
+    ">>> new_query.l += ' 10, 100' ",
+    ">>> new_query.g += 'col1' ",
+    ">>> new_query.g += 'col3' ",
+    ">>> new_query.o += 'col1' ",
+    ">>> new_query.o += 'col3' ",
+    ">>> new_query",
     ">>> new_query",
     ">>> new_query.statement",
 ]
 
 def main():
 
     for c in commands:
-        print c
+        print(c)
         if c in ('>>> new_query', '>>> new_query.statement'):
-            print eval(c[4:])
+            print(eval(c[4:]))
         else:
             exec(c[4:])
 

doc_example.txt

@@ -53,10 +53,9 @@ SELECT
   WHERE
     col1 = 1 
       OR col2 IS NULL
->>> from querpy import build_join
 >>> new_query.j.clear()
 >>> new_query.join_type = 'LEFT'
->>> new_query.j += build_join('ex_db.dbo.new_tbl nt', 'tbl.id', 'nt.id', 'tbl.city', 'nt.city')
+>>> new_query.j += Query.build_join('ex_db.dbo.new_tbl nt', 'tbl.id', 'nt.id', 'tbl.city', 'nt.city')
 >>> new_query.join_type = ''  # set back to regular join
 >>> new_query
 SELECT