curious 1.2.0

Example

Book.last(10) Book.author_set Author.country(continent__name="North America")

Query Language

The query language allows traversing models by identfying the relationships between them, through foreign keys in Django models, or arbitrary id-mapping functions. A Curious query is a space-separated set of terms, which connect models together by relationships.

Several kinds of “joins” are possible using these relationship primitives:

• A traditional inner join Book Book.author_set

• A left outer join: Book.last(10) ?(Book.author_set)

• A recusrive join: Parent.children_*

Furthermore, at each stage in a join, filtering can happen:

• Filtering by Django field lookups: Book Book.author_set(id__in=[2,3,4])

• Filtering by subquery: Book +(Book.author_set(id__in=[2,3,4]))

• Filtering by exclusive subquery Book -(Book.author_set(id__in=[2,3,4]))

Finally, relationships can generate counts:

• Counting Book Book.author_set__count

Configuring Curious

import myapp.models
from curious import model_registry

def register():
  model_registry.register(myapp.models)

Then include register when your Django app boots up.

Using Curious

Turn off CSRF. Deploy it as a Django app.

Writing Customized Relationships

Use filter and deferred to real functions.

Development

Requires Docker. Spin up your container using the provided docker-compose.yml file and Makefile by running make image. This creates an image with a correct git configuration for your user, which makes it easy to release. All of the commands you should need to run are defined the Makefile as targets. All of the targets except for image, are meant to be run inside the Docker container, but can be run from the host machine by having -ext appended to them. For example, to run tests, you could either call make test from inside the container, or make test-ext from the host.

If you are modifying the static assets during development, they can be recompiled with the build_assets make task, or by calling python setup.py build_assets.

./make test-ext

Deployment

Deployment of tagged commits happens to PyPI automatically via Travis CI. To bump and deploy a new version, run make bump/[foo]-ext, where [foo] is major, minor, or patch. Then git push origin --tags master.