Queries

Syntax

Query.userByName("Bob")

For queries that use the implicit this the syntax looks like the following:
entity.query("queryName", arg1, arg2)
Or, if you prefer:
entity.queryName(arg1, arg2, $piql_env)

What is Returned?

A Scala List instance that contains the entities that match the query.
You can learn more about Scala Lists here. Two important methods are head and tail, which are the car and cdr of Scala. Also, you may find isEmpty and length useful.

Ruby Enumerable is mixed in. You can do things like each for iteration.
Call to_a on the return value of a query to get a Ruby Array.