bitshift/bitshift/query/tree.py

__all__ = ["Tree"]

class Tree(object):
    """Represents a query tree."""

    def __init__(self, root):
        self._root = root

    def __repr__(self):
        return "Tree({0})".format(self._root)

    @property
    def root(self):
        """The root node of the tree."""
        return self._root

    def sortkey(self):
        """Return a string sort key for the query tree."""
        return self._root.sortkey()

    def serialize(self):
        """Create a string representation of the query for caching.

        :return: Query string representation.
        :rtype: str
        """
        return repr(self)

    def parameterize(self):
        """Parameterize the query tree for an SQL SELECT statement.

        :return: SQL query data.
        :rtype: 3-tuple of (query conditional string, table set, param tuple)
        """
        conditional, tables, arglist = self._root.parameterize(set())
        return conditional, tables, tuple(arglist)