Query interface for sdk3 seems incomplete

As I understand it, the 'SDK3' way to query would be something like:

cluster.query('SELECT * FROM `default`') # which works fine

# or

cluster.query('SELECT * FROM `default` WHERE foo LIKE $email', email='%foo%'). # nope

# or

cluster.query('SELECT * FROM `default` WHERE foo LIKE $1', '%foo%') # nope

But the older way, using a N1QLQuery object, works fine:

cluster.query(N1QLQuery('SELECT * FROM `default` WHERE email LIKE $email', email='%king%'))

A couple questions arise:

• do we really want to still support a N1QLQuery object?
• should we support something like the 2 usages above?

Of course it is entirely possible I'm misunderstanding the code (or the sdk3 RFCs).