node package manager


Django Querybuilder facilitates visualizing data using AJAX tables and maps with filters in Django applications.

You can see the examples at

Running examples

You can see example Django project using Django Querybuilder in directory example. Go to the directory and execute:

pip install -r requirements.txt

And then:

./ runserver

Using in your application

Add those lines to you project requirements or use them as PIP arguments.

-e git+git://   # for querybuilder

Afterwards, you can use our package the same way as in the example. You can also consult docstrings.

For developers

Frontend requirements

To get frontend dependencies, you need to have Node.js installed.

After installing Node.js, install the frontend dependencies by running the following from the root of your Django checkout:

npm install
npm run deps

Then build frontend files:

npm run build

For development run

npm run start

that way build will happen automatically each time you change any related files.

Django static files - important note

Contents of the folders listed below are generated automatically.


Modifying them manually does not make much sense, as they will be overridden.

They are included to enable the package to work immediately after installing it via pip.


In Python, see docstrings for documentation. You can also browse them using help method and using:

python -m pydoc django_querybuilder

Generate JavaScript docs into directory js_docs:

npm run js-docs

Running tests


./ jenkins


npm test

All tests


Test coverage

JavaScript test coverage is available in the test output. To see Python coverage report, execute in directory example:

coverage3 run ./ test
coverage3 html ../django_querybuilder/*py