django find

Django-Find

Resumo

Django-Find é um aplicativo Django que facilita a adição da funcionalidade complexa de pesquisa/filtro para os modelos em seu projeto. Ele suporta duas maneiras diferentes de pesquisar seus modelos Django: baseada em consulta ou baseada em JSON.

Django-Find não é um mecanismo de pesquisa de texto completo, ele pesquisa nos campos de seus modelos. Em outras palavras, ele filtra seus modelos e fornece dados tabulares como resultado.

Características

Pesquisa baseada em consulta

Por consulta, queremos dizer que você pode usar declarações como essas para pesquisar seus modelos:

 author:"robert frost" and (title:road or chapter:2)

Adicione um campo de pesquisa ao seu modelo usando uma única tag

 {% load find_tags %}
{% find object_list %}
{% for obj in object_list %}
  {{ obj.name }}
{% endfor %}

(Object_list é um conjunto de consultas que é passado para o modelo)

Consulta em seu código

Basta adicionar o mixin pesquisável:

 from django_find import Searchable

class Author ( models . Model , Searchable ):
    name = models . CharField ( "Author Name" , max_length = 10 )
    ...

E você está pronto para ir:

 # Query-based search returns a standard Django QuerySet that you
# can .filter() and work with as usual.
query = Book . by_query ( 'author:"robert frost" and title:"the road"' )

# You can also get a Django Q object for the statements.
q_obj = Book . q_from_query ( 'author:"robert frost" and title:"the road"' )

Consulta usando JSON

Para facilitar a realização de pesquisas complexas que abrangem vários modelos, é fornecido o método de consulta baseado em JSON. Permite que você faça pesquisas personalizadas como essas:

Para isso, é fornecida uma funcionalidade de pesquisa baseada em JSON:

 {
    "Author":{"name":[[["equals","test"]]]},
    "Book": {"title":[[["notcontains","c"]]]},
    "Chapter": {"content":[[["startswith","The "]]]}
}

Django-Find é inteligente para descobrir como unir esses modelos e retornar um resultado útil. No seu código, você pode carregar o JSON e recuperar o resultado da pesquisa:

 # JSON-based search exhausts what Django's ORM can do, so it does
# not return a Django QuerySet, but a row-based PaginatedRawQuerySet:
query , field_list = Book . by_json_raw ( '''{
    "Chapter": {"title":[[["contains","foo"]]]}
}''' )
print ( '|' . join ( field_list ))
for row in query :
    print ( '|' . join ( row ))

Documentação

A documentação completa, incluindo instruções de instalação, está aqui:

http://django-find.readthedocs.io