YAQL: Yet Another Query Language
================================

YAQL (Yet Another Query Language) is an embeddable and extensible query
language, that allows performing complex queries against arbitrary objects. It
has a vast and comprehensive standard library of frequently used querying
functions and can be extend even further with user-specified functions. YAQL is
written in python and is distributed via PyPI.

Quickstart
----------
Install the latest version of yaql:

    pip install yaql>=1.0.0

Run yaql REPL:

    yaql

Load a json file:

    yaql> @load my_file.json

Check it loaded to current context, i.e. `$`:

    yaql> $

Run some queries:

    yaql> $.customers
    ...
    yaql> $.customers.orders
    ...
    yaql> $.customers.where($.age > 18)
    ...
    yaql> $.customers.groupBy($.sex)
    ...
    yaql> $.customers.where($.orders.len() >= 1 or name = "John")
    ...
    yaql> let(min_orders => $.min_orders)
    ...   -> $.customers.where($.orders.len() >= $min_orders)

Project Resources
-----------------

* `Official Documentation <http://yaql.readthedocs.org>`_

* Project status, bugs, and blueprints are tracked on
  `Launchpad <https://launchpad.net/yaql>`_


License
-------

Apache License Version 2.0 http://www.apache.org/licenses/LICENSE-2.0
