Tree queries with explicit opt-in, without configurability
Project description
Query Django model trees using adjacency lists and recursive common table expressions. Supports PostgreSQL, sqlite3 (3.8.3 or higher) and MariaDB (10.2.2 or higher) and MySQL (8.0 or higher, if running without ONLY_FULL_GROUP_BY).
Supports Django 2.2 or better, Python 3.6 or better. See the GitHub actions build for more details.
Features and limitations
Supports only integer primary keys.
Allows specifying ordering among siblings.
Uses the correct definition of depth, where root nodes have a depth of zero.
The parent foreign key must be named "parent" at the moment (but why would you want to name it differently?)
The fields added by the common table expression always are tree_depth, tree_path and tree_ordering. The names cannot be changed. tree_depth is an integer, tree_path an array of primary keys and tree_ordering an array of values used for ordering nodes within their siblings.
Besides adding the fields mentioned above the package only adds queryset methods for ordering siblings and filtering ancestors and descendants. Other features may be useful, but will not be added to the package just because it’s possible to do so.
Little code, and relatively simple when compared to other tree management solutions for Django. No redundant values so the only way to end up with corrupt data is by introducing a loop in the tree structure (making it a graph). The TreeNode abstract model class has some protection against this.
Supports only trees with max. 50 levels on MySQL/MariaDB, since those databases do not support arrays and require us to provide a maximum length for the tree_path and tree_ordering upfront.
Here’s a blog post offering some additional insight (hopefully) into the reasons for django-tree-queries’ existence.
Usage
Install django-tree-queries using pip.
Extend tree_queries.models.TreeNode or build your own queryset and/or manager using tree_queries.query.TreeQuerySet. The TreeNode abstract model already contains a parent foreign key for your convenience and also uses model validation to protect against loops.
Call the with_tree_fields() queryset method if you require the additional fields respectively the CTE.
Call the order_siblings_by("field_name") queryset method if you want to order tree siblings by a specific model field.
Create a manager using TreeQuerySet.as_manager(with_tree_fields=True) if you want to add tree fields to queries by default.
Until documentation is more complete I’ll have to refer you to the test suite for additional instructions and usage examples.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file django_tree_queries-0.10.0.tar.gz.
File metadata
- Download URL: django_tree_queries-0.10.0.tar.gz
- Upload date:
- Size: 9.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.0 CPython/3.10.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d56a253bcf3b7a2ee47fdaab82f2f2541d9213947c1b5b8f824e6dd5e24b04b1 |
|
| MD5 | 8131f63fd128671c8f75e8baa8da3393 |
|
| BLAKE2b-256 | cb4d40129b14f76f306c49f9b201e251286b0aefc1c379872e7fe3bc16f33fa5 |
File details
Details for the file django_tree_queries-0.10.0-py3-none-any.whl.
File metadata
- Download URL: django_tree_queries-0.10.0-py3-none-any.whl
- Upload date:
- Size: 11.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.0 CPython/3.10.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 5209d38137e059fe0e73b1e05f50890b81c771a40017aac085d3ad43b0a708a1 |
|
| MD5 | 32d067dc44adf29326237f0920fe806f |
|
| BLAKE2b-256 | dbb395b5d4c4e3f0582950576a7d3d9770b20ce8df7ce7e7f7a60802ee166209 |
