beets/docs
Adrian Sampson 7d9f556cbe introducing "slow queries"
In preparation for enabling queries over flexattrs, this is a new path that
lets queries avoid generating SQLite expressions altogether. Any query that
can be completely evaluated in SQLite will be, but when it can't, we now fall
back to running the entire query in Python by selecting everything from the
database and running the `match` predicate.

To begin with, this mechanism replaces RegisteredFieldQueries, which
previously used Python callbacks for evaluation. Now they just indicate that
they're slow queries and the query system falls back automatically.

This has the great upside that it lets use implement arbitrarily complex
queries without shoehorning everything into SQLite when that (a) is way too
complicated and (b) doesn't buy us much performance anyway. The obvious
drawback is that any code dealing with queries now has to handle two cases
(slow and fast).

In the future, we could optimize this further by combing fast and slow query
styles. For example, if you want to match with a substring *and* a regular
expression, we can do a first pass in SQLite and apply the regex predicate on
the results. Avoided for now because premature optimization, etc., etc.

Next step: implement flexattr matches as slow queries.
2013-08-16 14:28:46 -07:00
..
guides guides/tagger: Make emailing Adrian less imperative 2013-08-06 10:40:17 +02:00
plugins introducing "slow queries" 2013-08-16 14:28:46 -07:00
reference Merge pull request #354 from mineo/docs-fixup-2 2013-08-06 09:46:14 -07:00
changelog.rst fix homebrew gstreamer instructions 2013-08-15 17:46:03 -07:00
conf.py changelog for #335, version bump 2013-06-26 22:03:02 -07:00
index.rst link to GitHub Issues 2013-02-26 16:40:37 -08:00
Makefile Sphinx documentation skeleton 2011-09-16 13:57:15 -07:00