Add comments to more explicitly state the process in cql_quote

timsavage · timsavage · commit b56ad8587dce · 2014-03-22T11:19:56.000+11:00
diff --git a/cassandra/encoder.py b/cassandra/encoder.py
@@ -13,8 +13,14 @@
 
 
 def cql_quote(term):
+    # The ordering of this method is important for the result of this method to
+    # be a native str type (for both Python 2 and 3)
+
+    # Handle quoting of native str and bool types
     if isinstance(term, (str, bool)):
         return "'%s'" % str(term).replace("'", "''")
+    # This branch of the if statement will only be used by Python 2 to catch
+    # unicode strings, text_type is used to prevent type errors with Python 3.
     elif isinstance(term, six.text_type):
         return "'%s'" % term.encode('utf8').replace("'", "''")
     else:
