django-multiseek
Graphical query builder for Django. Lets your end users compose nested AND/OR/AND-NOT searches across multiple fields, save and load form presets, and pick the result rendering — without writing any SQL.
The Python core (multiseek/logic.py, multiseek/views.py, multiseek/models.py) is UI-agnostic. Four reference frontends ship as runnable example projects under examples/.
Depends on:
- Django
- django-autocomplete-light
Supported configurations:
| Django | Python 3.10 | Python 3.11 | Python 3.12 | Python 3.13 |
|---|---|---|---|---|
| 4.2 | + | + | + | + |
| 5.1 | + | + | + | + |
| 5.2 | + | + | + | + |
| 6.0 | + | + | ||
| 6.1 | + | + |
Installation
pip install django-multiseek
Or with uv:
uv add django-multiseek
Example projects (recommended starting point)
Four runnable Django projects under examples/, each demonstrating a different UI on top of the same Python core. Run any of them — or all four — with the helper script at the repo root:
./run_example.sh setup # prepare all four (idempotent)
./run_example.sh run htmx # setup + start dev server on :8000
./run_example.sh test # run every example's Playwright suite
./run_example.sh test bootstrap # one example's tests
| Example | UI stack | Project JS | When to pick it |
|---|---|---|---|
examples/minimal |
Foundation 6 + jQuery | ~26 KB jQuery widgets | You like the original look, but want no yarn build step |
examples/bootstrap |
Bootstrap 5 + jQuery | ~26 KB jQuery widgets | Your project already uses Bootstrap |
examples/alpine |
Bootstrap 5 + Alpine.js | ~14 KB Alpine components | Drop jQuery, keep a small declarative JS layer |
examples/htmx |
htmx (server-rendered fragments) | 0 KB project JS | Eliminate JS state management entirely |
What run_example.sh does
setup [name]— for one example, or all four:uv sync --all-extras(only for examples that ship their ownpyproject.toml; currentlyalpine)manage.py migrate(creates the SQLite DB)manage.py fetch_assets— downloads JS/CSS deps from CDN intostatic/multiseek/vendor/so the example renders without depending on a public CDN at runtime. Idempotent; skips files already present.manage.py initial_data— seeds 7 languages, 8 authors, 27 books (varied titles/years/multi-author/dates so every field type has something interesting to filter on).
run <name>— runssetupthenmanage.py runserverfor that example. Open http://127.0.0.1:8000/multiseek/.test [name]— runssetupthenpytest --browser chromium. With no name, runs all four in sequence and exits non-zero if any failed (drop-in for CI).
Manual setup (without run_example.sh)
If you'd rather run the steps yourself:
cd examples/<minimal|bootstrap|alpine|htmx>
uv sync # only required for alpine (own pyproject.toml)
uv run python manage.py migrate
uv run python manage.py fetch_assets
uv run python manage.py initial_data
uv run python manage.py runserver
Architecture: how the UI variants share one core
multiseek/logic.py exports a JSON wire format. Each frontend's job is to:
- let the user build a nested form,
- produce the JSON the registry expects (or, for htmx, mutate the session JSON one fragment at a time),
- POST or GET it back to multiseek's bundled views.
See docs/FRONTENDS.md for the full design, per-variant tradeoffs, and the wire-format invariants.
test_project/ — full-feature reference
The repo also contains test_project/ — the canonical full-feature Foundation/jQuery demo. Unlike the example projects, it uses yarn to fetch its frontend assets and is the home of the Playwright test suite that runs in CI against the multiseek package itself. To run it:
uv sync --all-extras
cd test_project
yarn
uv run python manage.py collectstatic --noinput -v0
uv run python manage.py migrate
uv run python manage.py initial_data
uv run python manage.py runserver
License
MIT License. See LICENSE for details.
1 maintainer
Release files for django-multiseek 0.10.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| django_multiseek-0.10.3.tar.gz | 39.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| django_multiseek-0.10.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 90.8 kB
Release files / django_multiseek-0.10.3.tar.gz
| Download URL | django_multiseek-0.10.3.tar.gz |
|---|---|
| Size | 39.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9aaf2729c06d3b2053305aca382a04e3962a6c05e703e98550e6026a477569a4
|
|
BLAKE2b-256 checksum How to use checksums |
7c89f7a47549eac60dc719b50a541a8f27ff2170a170cd64883903c3c8c5ed99
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / django_multiseek-0.10.3-py3-none-any.whl
| Download URL | django_multiseek-0.10.3-py3-none-any.whl |
|---|---|
| Size | 51.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
df0985783ff9a0eeac902eb31833e78f268108ccf438d8b8920a17649a07819d
|
|
BLAKE2b-256 checksum How to use checksums |
d4d9d4f7d7dd274488a9eea9952bb758b6090e5043604033ce3eee710c31fec3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
