Skip to content

Commit

Permalink
First draft of querysets document
Browse files Browse the repository at this point in the history
  • Loading branch information
James Dennis committed May 10, 2012
1 parent 13c2651 commit d7836c5
Showing 1 changed file with 18 additions and 0 deletions.
18 changes: 18 additions & 0 deletions docs/QUERYSETS.md
@@ -0,0 +1,18 @@
# QuerySets

There are times when a carefully crafted query is right and there are times
when a simple CRUD interface can do the trick. Brubeck provides querysets that
implement a simple CRUD interface. This is useful for the AutoAPI, support for
basic caching and a consistent way of handling database connections.

A `Queryset` is then an implementation of CRUD functions for a single item or
multiple items. This type of interface makes the system consistent with the
idea that data should be stored in a simple manner, eg. a key that maps to a
particular document.

If you need anything more complicated than that, it's easy enough to go from
the DictShield model into something that will fit nicely with your custom
query.

Querysets are an area of active development but are still young in
implementation.

0 comments on commit d7836c5

Please sign in to comment.