Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

tri.query is a library to define queries

Project description

https://travis-ci.org/TriOptima/tri.query.svg?branch=master http://codecov.io/github/TriOptima/tri.query/coverage.svg?branch=master

tri.query

tri.query makes it easy to implement searching and filtering in your Django app.

Major features:

  • Generate simple filtering GUIs easily while at the same time:
  • Supply your views with advanced query languages
  • Query language can be used stand alone without the GUI parts
  • Highly customizable GUI based on tri.form

Example

Simple view that allows the user to search for a car by choosing the make from a drop down, and search for specific model in the advanced mode:

class CarQuery(Query):
    make = Variable.choice(
        choices=['Toyota', 'Volvo', 'Ford'],
        form_field__show=True)  # Display this field in the simple style GUI
    model = Variable.text()

def cars(request):
    query = CarQuery()
    cars_query_set = query.request_to_q(request)
    form = query.form()
    return render(
        template_name='cars.html',
        context_instance=RequestContext(request, {'query_form': form, 'cars': cars_query_set}))
<!-- cars.html -->
{% include "tri_query/form.html" with form=query_form %}

<ul>
    {% for car in cars %}
        <li>{{ car }}</li>
    {% endfor %}
</ul>
simple_gui.png

After switching to the advanced mode:

advanced_gui.png

Programmatically call the search API:

query = CarQuery()
cars_query_set = query.parse('make=Toyota and (make=1991 or make=1992)')

Running tests

You need tox installed then just make test.

License

BSD

Changelog

4.0.0 (2017-08-22)

  • Moved to tri.declarative 0.34 and tri.form 5.0
  • Note that gui__class to specify a constructor/callable is no longer a valid parameter, because of updated tri.form. Use gui__call_target or just gui.
  • You no longer need to specify the model parameter to choice_queryset or multi_choice_queryset if you give it a QuerySet as choices (as opposed to giving a callable)

3.3.0 (2017-04-27)

  • Move default behaviors out from the shortcuts so they can be used externally
  • Removed jquery dependency for toggling simple/advanced filtering
  • Removed support for Django 1.7

3.2.0 (2017-03-22)

  • Variable class now inherits from object, making the implementation more pythonic. (Attributes still possible to override in constructor call, see NamespaceAwareObject)

3.1.0 (2016-09-19)

  • Moved to the simplified factory system for from_model
  • Added shortcuts to Variable: url, time, datetime, date, email, decimal

3.0.0 (2016-09-14)

  • Updated to latest major tri.form

2.2.0 (2016-08-16)

  • Variable.choice_queryset handles the string “null” the same way as everything else
  • Queries that have multi-select inputs now work

2.1.1 (2016-08-08)

  • Report invalid operators for choice queryset as errors instead of crashing

2.1.0 (2016-07-12)

  • Check for dates that are out of range

2.0.0 (2016-06-02)

  • Cache form on Query
  • Render global form errors
  • Query.form() no longer takes a request parameter, since it was redundant anyway. This is a potential breaking change.
  • Correctly dispatch attr to underlying tri.form
  • Support for ajax backend. New parameter to Query: endpoint_dispatch_prefix.

1.11.0 (2016-04-25)

  • Minor bugfix for variable-from-model handling of auto fields

1.10.0 (2016-04-21)

  • Fix over-eager assert not allowing variable-less Query objects.

1.9.0 (2016-04-21)

  • Enable mixing variable definitions in both declared variables and class meta.
  • Added after attribute on Variable to enable custom variable ordering (See tri.declarative.sort_after())
  • Added Variable.from_model, Query.from_model

1.8.0 (2016-04-19)

  • Added robustness in when arguments are passed as dict(foo=dict(bar=17)) or foo__bar=17

1.7.0 (2016-04-08)

  • Add python 3 support

1.6.0 (2016-03-03)

  • Variable.float shortcut added
  • Add support for Django 1.7 and 1.8.

Project details


Release history Release notifications

This version
History Node

4.0.0

History Node

3.3.0

History Node

3.2.0

History Node

3.1.0

History Node

3.0.0

History Node

2.2.0

History Node

2.1.1

History Node

2.1.0

History Node

2.0.0

History Node

1.11.0

History Node

1.10.0

History Node

1.9.0

History Node

1.8.0

History Node

1.7.0

History Node

1.6.0

History Node

1.5.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
tri.query-4.0.0.tar.gz (13.7 kB) Copy SHA256 hash SHA256 Source None Aug 22, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page