django-fast-treenode 3.0.2__tar.gz → 3.0.4__tar.gz

{django_fast_treenode-3.0.2/django_fast_treenode.egg-info → django_fast_treenode-3.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-fast-treenode
-Version: 3.0.2
+Version: 3.0.4
 Summary: Treenode Framework for supporting tree (hierarchical) data structure in Django projects
 Home-page: https://django-fast-treenode.readthedocs.io/
 Author: Timur Kady
@@ -53,7 +53,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: Django>=4.0
+Requires-Dist: Django>=5.0
 Requires-Dist: msgpack>=1.0.0
 Requires-Dist: openpyxl>=3.0.0
 Requires-Dist: pyyaml>=5.1
@@ -62,16 +62,16 @@ Dynamic: home-page
 Dynamic: license-file
 Dynamic: requires-python
 
-# TreeNode Framework
+# Treenode Framework
 **A hybrid open-source framework for working with trees in Django**
 
 [![Tests](https://github.com/TimurKady/django-fast-treenode/actions/workflows/test.yaml/badge.svg?branch=main)](https://github.com/TimurKady/django-fast-treenode/actions/workflows/test.yaml)
 [![Docs](https://readthedocs.org/projects/django-fast-treenode/badge/?version=latest)](https://django-fast-treenode.readthedocs.io/)
-[![PyPI](https://img.shields.io/pypi/v/django-fast-treenode.svg)](https://pypi.org/project/django-fast-treenode/)
+[![PyPI](https://img.shields.io/pypi/v/django-fast-treenode.svg)](https://pypi.org/project/django-fast-Treenode/)
 [![Published on Django Packages](https://img.shields.io/badge/Published%20on-Django%20Packages-0c3c26)](https://djangopackages.org/packages/p/django-fast-treenode/)
 [![Sponsor](https://img.shields.io/github/sponsors/TimurKady)](https://github.com/sponsors/TimurKady)
 
-## About The TreeNode Framework
+## About The Treenode Framework
 ### Overview
 
 **Treenode Framework** is an advanced tree management system for Django applications.It is designed to handle large-scale, deeply nested, and highly dynamic tree structures while maintaining excellent performance, data integrity, and ease of use.
@@ -87,7 +87,7 @@ Its core philosophy: **maximum scalability, minimum complexity**.
 
 ### Key Features
 #### Common operations
-The `django-fast-treenode` package supports all the basic operations needed to work with tree structures:
+The `django-fast-Treenode` package supports all the basic operations needed to work with tree structures:
 
 - Extracting **ancestors** (queryset, list, pks, count);
 - Extracting **children** (queryset, list, pks, count);
@@ -118,10 +118,10 @@ Typical applications include:
 
 In all these domains, scalable and fast tree management is not a luxury — it's a necessity.
 
-### Why TreeNode Framework?
+### Why Treenode Framework?
 At the moment, django-fast-treeenode is, if not the best, then one of the best packages for working with tree data under Djangjo.
 
-- **High performance**: [tests show](docs/about.md#benchmark-tests) that on trees of 5k-10k nodes with a nesting depth of 500-600 levels, **Treenode Framework** (`django-fast-treenode`) shows **performance 4-7 times better** than the main popular packages.
+- **High performance**: [tests show](docs/about.md#benchmark-tests) that on trees of 5k-10k nodes with a nesting depth of 500-600 levels, **Treenode Framework** (`django-fast-Treenode`) shows **performance 4-7 times better** than the main popular packages.
 - **Flexible API**: today contains the widest set of methods for working with a tree in comparison with other packages.
 - **Convenient administration**: the admin panel interface was developed taking into account the experience of using other packages. It provides convenience and intuitiveness with ease of programming.
 - **Scalability**: **Treenode Framework** suitable for solving simple problems such as menus, directories, parsing arithmetic expressions, as well as complex problems such as program optimization, image layout, multi-step decision making problems, or machine learning..
@@ -134,7 +134,7 @@ To get started quickly, you need to follow these steps:
 
 - Simply install the package via `pip`:
   ```sh
-  pip install django-fast-treenode
+  pip install django-fast-Treenode
   ```
 - Once installed, add `'treenode'` to your `INSTALLED_APPS` in **settings.py**:
   ```python {title="settings.py"}
@@ -147,9 +147,9 @@ To get started quickly, you need to follow these steps:
 
 - Open **models.py** and create your own tree class:
   ```
-  from treenode.models import TreeNodeModel
+  from Treenode.models import TreenodeModel
 
-  class MyTree(TreeNodeModel):
+  class MyTree(TreenodeModel):
     name = models.CharField(max_length=255)
     display_field = "name"
   ```
@@ -157,11 +157,11 @@ To get started quickly, you need to follow these steps:
 - Open **admin.py** and create a model for the admin panel
   ```
   from django.contrib import admin
-  from treenode.admin import TreeNodeModelAdmin
-  from .models import TestNode
+  from Treenode.admin import TreenodeModelAdmin
+  from .models import MyTree
 
-  @admin.register(TestNode)
-  class EntityAdmin(TreeNodeModelAdmin):
+  @admin.register(MyTree)
+  class MyTreeAdmin(TreenodeModelAdmin):
     list_display = ("name",)
     search_fields = ("name",)
   ```
@@ -176,25 +176,24 @@ To get started quickly, you need to follow these steps:
   ```sh
   python manage.py runserver
   ```
-
 Everything is ready, enjoy 🎉!
 
 ## Documentation
-Full documentation is available at **[ReadTheDocs](https://django-fast-treenode.readthedocs.io/)**.
+Full documentation is available at **[ReadTheDocs](https://django-fast-Treenode.readthedocs.io/)**.
 
 Quick access links:
-* [Installation, configuration and fine tuning](https://django-fast-treenode.readthedocs.io/installation/)
-* [Model Inheritance and Extensions](https://django-fast-treenode.readthedocs.io/models/)
-* [Working with Admin Classes](https://django-fast-treenode.readthedocs.io/admin/)
-* [API Reference](https://django-fast-treenode.readthedocs.io/api/)
-* [Import & Export](https://django-fast-treenode.readthedocs.io/import_export/)
-* [Caching and working with cache](https://django-fast-treenode.readthedocs.io/cache/)
-* [Migration and upgrade guide](https://django-fast-treenode.readthedocs.io/migration/)
+* [Installation, configuration and fine tuning](https://django-fast-Treenode.readthedocs.io/installation/)
+* [Model Inheritance and Extensions](https://django-fast-Treenode.readthedocs.io/models/)
+* [Working with Admin Classes](https://django-fast-Treenode.readthedocs.io/admin/)
+* [API Reference](https://django-fast-Treenode.readthedocs.io/api/)
+* [Import & Export](https://django-fast-Treenode.readthedocs.io/import_export/)
+* [Caching and working with cache](https://django-fast-Treenode.readthedocs.io/cache/)
+* [Migration and upgrade guide](https://django-fast-Treenode.readthedocs.io/migration/)
 
 Your wishes, objections, comments are welcome.
 
 ## License
-Released under [MIT License](https://github.com/TimurKady/django-fast-treenode/blob/main/LICENSE).
+Released under [MIT License](https://github.com/TimurKady/django-fast-Treenode/blob/main/LICENSE).
 
 ## Credits
 Thanks to everyone who contributed to the development and testing of this package, as well as the Django community for their inspiration and support. 

{django_fast_treenode-3.0.2 → django_fast_treenode-3.0.4}/README.md

@@ -1,13 +1,13 @@
-# TreeNode Framework
+# Treenode Framework
 **A hybrid open-source framework for working with trees in Django**
 
 [![Tests](https://github.com/TimurKady/django-fast-treenode/actions/workflows/test.yaml/badge.svg?branch=main)](https://github.com/TimurKady/django-fast-treenode/actions/workflows/test.yaml)
 [![Docs](https://readthedocs.org/projects/django-fast-treenode/badge/?version=latest)](https://django-fast-treenode.readthedocs.io/)
-[![PyPI](https://img.shields.io/pypi/v/django-fast-treenode.svg)](https://pypi.org/project/django-fast-treenode/)
+[![PyPI](https://img.shields.io/pypi/v/django-fast-treenode.svg)](https://pypi.org/project/django-fast-Treenode/)
 [![Published on Django Packages](https://img.shields.io/badge/Published%20on-Django%20Packages-0c3c26)](https://djangopackages.org/packages/p/django-fast-treenode/)
 [![Sponsor](https://img.shields.io/github/sponsors/TimurKady)](https://github.com/sponsors/TimurKady)
 
-## About The TreeNode Framework
+## About The Treenode Framework
 ### Overview
 
 **Treenode Framework** is an advanced tree management system for Django applications.It is designed to handle large-scale, deeply nested, and highly dynamic tree structures while maintaining excellent performance, data integrity, and ease of use.
@@ -23,7 +23,7 @@ Its core philosophy: **maximum scalability, minimum complexity**.
 
 ### Key Features
 #### Common operations
-The `django-fast-treenode` package supports all the basic operations needed to work with tree structures:
+The `django-fast-Treenode` package supports all the basic operations needed to work with tree structures:
 
 - Extracting **ancestors** (queryset, list, pks, count);
 - Extracting **children** (queryset, list, pks, count);
@@ -54,10 +54,10 @@ Typical applications include:
 
 In all these domains, scalable and fast tree management is not a luxury — it's a necessity.
 
-### Why TreeNode Framework?
+### Why Treenode Framework?
 At the moment, django-fast-treeenode is, if not the best, then one of the best packages for working with tree data under Djangjo.
 
-- **High performance**: [tests show](docs/about.md#benchmark-tests) that on trees of 5k-10k nodes with a nesting depth of 500-600 levels, **Treenode Framework** (`django-fast-treenode`) shows **performance 4-7 times better** than the main popular packages.
+- **High performance**: [tests show](docs/about.md#benchmark-tests) that on trees of 5k-10k nodes with a nesting depth of 500-600 levels, **Treenode Framework** (`django-fast-Treenode`) shows **performance 4-7 times better** than the main popular packages.
 - **Flexible API**: today contains the widest set of methods for working with a tree in comparison with other packages.
 - **Convenient administration**: the admin panel interface was developed taking into account the experience of using other packages. It provides convenience and intuitiveness with ease of programming.
 - **Scalability**: **Treenode Framework** suitable for solving simple problems such as menus, directories, parsing arithmetic expressions, as well as complex problems such as program optimization, image layout, multi-step decision making problems, or machine learning..
@@ -70,7 +70,7 @@ To get started quickly, you need to follow these steps:
 
 - Simply install the package via `pip`:
   ```sh
-  pip install django-fast-treenode
+  pip install django-fast-Treenode
   ```
 - Once installed, add `'treenode'` to your `INSTALLED_APPS` in **settings.py**:
   ```python {title="settings.py"}
@@ -83,9 +83,9 @@ To get started quickly, you need to follow these steps:
 
 - Open **models.py** and create your own tree class:
   ```
-  from treenode.models import TreeNodeModel
+  from Treenode.models import TreenodeModel
 
-  class MyTree(TreeNodeModel):
+  class MyTree(TreenodeModel):
     name = models.CharField(max_length=255)
     display_field = "name"
   ```
@@ -93,11 +93,11 @@ To get started quickly, you need to follow these steps:
 - Open **admin.py** and create a model for the admin panel
   ```
   from django.contrib import admin
-  from treenode.admin import TreeNodeModelAdmin
-  from .models import TestNode
+  from Treenode.admin import TreenodeModelAdmin
+  from .models import MyTree
 
-  @admin.register(TestNode)
-  class EntityAdmin(TreeNodeModelAdmin):
+  @admin.register(MyTree)
+  class MyTreeAdmin(TreenodeModelAdmin):
     list_display = ("name",)
     search_fields = ("name",)
   ```
@@ -112,25 +112,24 @@ To get started quickly, you need to follow these steps:
   ```sh
   python manage.py runserver
   ```
-
 Everything is ready, enjoy 🎉!
 
 ## Documentation
-Full documentation is available at **[ReadTheDocs](https://django-fast-treenode.readthedocs.io/)**.
+Full documentation is available at **[ReadTheDocs](https://django-fast-Treenode.readthedocs.io/)**.
 
 Quick access links:
-* [Installation, configuration and fine tuning](https://django-fast-treenode.readthedocs.io/installation/)
-* [Model Inheritance and Extensions](https://django-fast-treenode.readthedocs.io/models/)
-* [Working with Admin Classes](https://django-fast-treenode.readthedocs.io/admin/)
-* [API Reference](https://django-fast-treenode.readthedocs.io/api/)
-* [Import & Export](https://django-fast-treenode.readthedocs.io/import_export/)
-* [Caching and working with cache](https://django-fast-treenode.readthedocs.io/cache/)
-* [Migration and upgrade guide](https://django-fast-treenode.readthedocs.io/migration/)
+* [Installation, configuration and fine tuning](https://django-fast-Treenode.readthedocs.io/installation/)
+* [Model Inheritance and Extensions](https://django-fast-Treenode.readthedocs.io/models/)
+* [Working with Admin Classes](https://django-fast-Treenode.readthedocs.io/admin/)
+* [API Reference](https://django-fast-Treenode.readthedocs.io/api/)
+* [Import & Export](https://django-fast-Treenode.readthedocs.io/import_export/)
+* [Caching and working with cache](https://django-fast-Treenode.readthedocs.io/cache/)
+* [Migration and upgrade guide](https://django-fast-Treenode.readthedocs.io/migration/)
 
 Your wishes, objections, comments are welcome.
 
 ## License
-Released under [MIT License](https://github.com/TimurKady/django-fast-treenode/blob/main/LICENSE).
+Released under [MIT License](https://github.com/TimurKady/django-fast-Treenode/blob/main/LICENSE).
 
 ## Credits
 Thanks to everyone who contributed to the development and testing of this package, as well as the Django community for their inspiration and support. 

{django_fast_treenode-3.0.2 → django_fast_treenode-3.0.4/django_fast_treenode.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-fast-treenode
-Version: 3.0.2
+Version: 3.0.4
 Summary: Treenode Framework for supporting tree (hierarchical) data structure in Django projects
 Home-page: https://django-fast-treenode.readthedocs.io/
 Author: Timur Kady
@@ -53,7 +53,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: Django>=4.0
+Requires-Dist: Django>=5.0
 Requires-Dist: msgpack>=1.0.0
 Requires-Dist: openpyxl>=3.0.0
 Requires-Dist: pyyaml>=5.1
@@ -62,16 +62,16 @@ Dynamic: home-page
 Dynamic: license-file
 Dynamic: requires-python
 
-# TreeNode Framework
+# Treenode Framework
 **A hybrid open-source framework for working with trees in Django**
 
 [![Tests](https://github.com/TimurKady/django-fast-treenode/actions/workflows/test.yaml/badge.svg?branch=main)](https://github.com/TimurKady/django-fast-treenode/actions/workflows/test.yaml)
 [![Docs](https://readthedocs.org/projects/django-fast-treenode/badge/?version=latest)](https://django-fast-treenode.readthedocs.io/)
-[![PyPI](https://img.shields.io/pypi/v/django-fast-treenode.svg)](https://pypi.org/project/django-fast-treenode/)
+[![PyPI](https://img.shields.io/pypi/v/django-fast-treenode.svg)](https://pypi.org/project/django-fast-Treenode/)
 [![Published on Django Packages](https://img.shields.io/badge/Published%20on-Django%20Packages-0c3c26)](https://djangopackages.org/packages/p/django-fast-treenode/)
 [![Sponsor](https://img.shields.io/github/sponsors/TimurKady)](https://github.com/sponsors/TimurKady)
 
-## About The TreeNode Framework
+## About The Treenode Framework
 ### Overview
 
 **Treenode Framework** is an advanced tree management system for Django applications.It is designed to handle large-scale, deeply nested, and highly dynamic tree structures while maintaining excellent performance, data integrity, and ease of use.
@@ -87,7 +87,7 @@ Its core philosophy: **maximum scalability, minimum complexity**.
 
 ### Key Features
 #### Common operations
-The `django-fast-treenode` package supports all the basic operations needed to work with tree structures:
+The `django-fast-Treenode` package supports all the basic operations needed to work with tree structures:
 
 - Extracting **ancestors** (queryset, list, pks, count);
 - Extracting **children** (queryset, list, pks, count);
@@ -118,10 +118,10 @@ Typical applications include:
 
 In all these domains, scalable and fast tree management is not a luxury — it's a necessity.
 
-### Why TreeNode Framework?
+### Why Treenode Framework?
 At the moment, django-fast-treeenode is, if not the best, then one of the best packages for working with tree data under Djangjo.
 
-- **High performance**: [tests show](docs/about.md#benchmark-tests) that on trees of 5k-10k nodes with a nesting depth of 500-600 levels, **Treenode Framework** (`django-fast-treenode`) shows **performance 4-7 times better** than the main popular packages.
+- **High performance**: [tests show](docs/about.md#benchmark-tests) that on trees of 5k-10k nodes with a nesting depth of 500-600 levels, **Treenode Framework** (`django-fast-Treenode`) shows **performance 4-7 times better** than the main popular packages.
 - **Flexible API**: today contains the widest set of methods for working with a tree in comparison with other packages.
 - **Convenient administration**: the admin panel interface was developed taking into account the experience of using other packages. It provides convenience and intuitiveness with ease of programming.
 - **Scalability**: **Treenode Framework** suitable for solving simple problems such as menus, directories, parsing arithmetic expressions, as well as complex problems such as program optimization, image layout, multi-step decision making problems, or machine learning..
@@ -134,7 +134,7 @@ To get started quickly, you need to follow these steps:
 
 - Simply install the package via `pip`:
   ```sh
-  pip install django-fast-treenode
+  pip install django-fast-Treenode
   ```
 - Once installed, add `'treenode'` to your `INSTALLED_APPS` in **settings.py**:
   ```python {title="settings.py"}
@@ -147,9 +147,9 @@ To get started quickly, you need to follow these steps:
 
 - Open **models.py** and create your own tree class:
   ```
-  from treenode.models import TreeNodeModel
+  from Treenode.models import TreenodeModel
 
-  class MyTree(TreeNodeModel):
+  class MyTree(TreenodeModel):
     name = models.CharField(max_length=255)
     display_field = "name"
   ```
@@ -157,11 +157,11 @@ To get started quickly, you need to follow these steps:
 - Open **admin.py** and create a model for the admin panel
   ```
   from django.contrib import admin
-  from treenode.admin import TreeNodeModelAdmin
-  from .models import TestNode
+  from Treenode.admin import TreenodeModelAdmin
+  from .models import MyTree
 
-  @admin.register(TestNode)
-  class EntityAdmin(TreeNodeModelAdmin):
+  @admin.register(MyTree)
+  class MyTreeAdmin(TreenodeModelAdmin):
     list_display = ("name",)
     search_fields = ("name",)
   ```
@@ -176,25 +176,24 @@ To get started quickly, you need to follow these steps:
   ```sh
   python manage.py runserver
   ```
-
 Everything is ready, enjoy 🎉!
 
 ## Documentation
-Full documentation is available at **[ReadTheDocs](https://django-fast-treenode.readthedocs.io/)**.
+Full documentation is available at **[ReadTheDocs](https://django-fast-Treenode.readthedocs.io/)**.
 
 Quick access links:
-* [Installation, configuration and fine tuning](https://django-fast-treenode.readthedocs.io/installation/)
-* [Model Inheritance and Extensions](https://django-fast-treenode.readthedocs.io/models/)
-* [Working with Admin Classes](https://django-fast-treenode.readthedocs.io/admin/)
-* [API Reference](https://django-fast-treenode.readthedocs.io/api/)
-* [Import & Export](https://django-fast-treenode.readthedocs.io/import_export/)
-* [Caching and working with cache](https://django-fast-treenode.readthedocs.io/cache/)
-* [Migration and upgrade guide](https://django-fast-treenode.readthedocs.io/migration/)
+* [Installation, configuration and fine tuning](https://django-fast-Treenode.readthedocs.io/installation/)
+* [Model Inheritance and Extensions](https://django-fast-Treenode.readthedocs.io/models/)
+* [Working with Admin Classes](https://django-fast-Treenode.readthedocs.io/admin/)
+* [API Reference](https://django-fast-Treenode.readthedocs.io/api/)
+* [Import & Export](https://django-fast-Treenode.readthedocs.io/import_export/)
+* [Caching and working with cache](https://django-fast-Treenode.readthedocs.io/cache/)
+* [Migration and upgrade guide](https://django-fast-Treenode.readthedocs.io/migration/)
 
 Your wishes, objections, comments are welcome.
 
 ## License
-Released under [MIT License](https://github.com/TimurKady/django-fast-treenode/blob/main/LICENSE).
+Released under [MIT License](https://github.com/TimurKady/django-fast-Treenode/blob/main/LICENSE).
 
 ## Credits
 Thanks to everyone who contributed to the development and testing of this package, as well as the Django community for their inspiration and support. 

{django_fast_treenode-3.0.2 → django_fast_treenode-3.0.4}/django_fast_treenode.egg-info/requires.txt

@@ -1,4 +1,4 @@
-Django>=4.0
+Django>=5.0
 msgpack>=1.0.0
 openpyxl>=3.0.0
 pyyaml>=5.1

{django_fast_treenode-3.0.2 → django_fast_treenode-3.0.4}/docs/about.md

@@ -194,7 +194,7 @@ All results were normalized relative to the best observed values. Lower values i
 | Children       | 🥇1,0    | 1,1        | 1,4       | 🥉1,0     | 🥈1,0          | 1,6                    |
 | Siblings       | 🥇1,0    | 1,1        | 2,8       | 1,1        | 🥈1,0          | 1,1                   |
 | Family         | 314,2     | 10.110,0   | 🥈236,2  | 🥉273,4   | 609,9           | 🥇1,0                 |
-| Re-reading     | 338,4     | 8.416,7   | 🥉445,7   | 727,4      | 🥇1,0          | 🥉1,3                 |
+| Re-reading     | 338,4     | 8.416,7   | 🥉445,7   | 727,4      | 🥇1,0          | 🥈1,3                 |
 | Random         | 253,8     | 1,1        | 274,5     | 🥇1,0     | 🥈1,0          | 🥉1,3                |
 | Move           | 🥇1,0     | 23,75     | 🥈1,6     | 🥈1,3    | 268,2           | 7,5                    | 
 | Delete         | 42,8      | 🥈3,63    | 🥈1,9     | 4,7       | 27,6            | 🥇1,0                 |

{django_fast_treenode-3.0.2 → django_fast_treenode-3.0.4}/docs/index.md

@@ -73,10 +73,10 @@ To get started quickly, you need to follow these steps:
   ```
   from django.contrib import admin
   from treenode.admin import TreeNodeModelAdmin
-  from .models import TestNode
+  from .models import MyTree
 
-  @admin.register(TestNode)
-  class EntityAdmin(TreeNodeModelAdmin):
+  @admin.register(MyTree)
+  class MyTreeAdmin(TreeNodeModelAdmin):
     list_display = ("name",)
     search_fields = ("name",)
   ```

{django_fast_treenode-3.0.2 → django_fast_treenode-3.0.4}/docs/migration.md

@@ -178,7 +178,7 @@ def export_tree(node):
     children = node.get_children()
     return {
         "id": node.id,
-        "tn_parent": node.get_parent().id if node.get_parent() else None,
+        "parent": node.get_parent().id if node.get_parent() else None,
         "name": node.name,
         # Continue the list by inserting the required model fields
         # Do not export the `children` field
@@ -192,7 +192,7 @@ with open("tree_data.json", "w") as f:
     json.dump(data, f, indent=4)
 ```
 
-This code exports your structure to `tree_data.json` file. JSON preserves the id → tn_parent relationship, but without children.
+This code exports your structure to `tree_data.json` file. JSON preserves the id → parent relationship, but without children.
 
 Now clear the table:
 ```python
@@ -229,9 +229,9 @@ class Category(TreeNodeModel):
 ```
 Be sure to add `treenode_display_field` as `django-fast-treenode` uses it to display nodes in the admin panel. 
 
-The `treenode_sort_field` attribute specifies the tree sorting order. The default value of this field is `None`. It will sort by the internal field `tn_priority`.
+The `treenode_sort_field` attribute specifies the tree sorting order. The default value of this field is `None`. It will sort by the internal field `priority`.
 
-The `tn_priority` value will be generated automatically if not specified during import. It will either be set as nodes are inserted into the tree (in the order in which the nodes will appear in the imported data), or after they are inserted, depending on the results of sorting by the field specified in the `treenode_sort_field` attribute.
+The `priority` value will be generated automatically if not specified during import. It will either be set as nodes are inserted into the tree (in the order in which the nodes will appear in the imported data), or after they are inserted, depending on the results of sorting by the field specified in the `treenode_sort_field` attribute.
 
 > Note: sorting functions are available for `django-tree-node` version 2.3 and higher.
 

{django_fast_treenode-3.0.2 → django_fast_treenode-3.0.4}/docs/roadmap.md

@@ -1,6 +1,6 @@
 ## Roadmap
 
-The **`django-fast-treenode`** package will continue to evolve from its original concept—combining the benefits of the hybrid models into a high-performance solution for managing and visualizing hierarchical data in Django projects. 
+The **`django-fast-treenode`** package will continue to evolve from its original concept—combining the benefits of hybrid models into a high-performance solution for managing and visualizing hierarchical data in Django projects.
 
 The focus is on **speed, usability, and flexibility**.
 
@@ -8,36 +8,36 @@ The focus is on **speed, usability, and flexibility**.
 
 The 3.x release series will focus on strengthening TreeNode Framework in terms of security, usability, and performance scalability, while maintaining backward compatibility and architectural cleanliness.
 
+* **Version 3.1 — Background Task Worker (Production Mode)**
 
-* **Version 3.1 — JWT Authentication for API**
+    - Introduce a centralized queue manager with a multiprocessing or Redis-based backend.
+    - Add a built-in worker process for safe and efficient task execution in production environments.
+    - Provide a fallback auto-run mode for DEBUG environments (using `atexit` or thread-based handler).
+    - Ensure task queue consistency across multiple WSGI workers or scripts.
+
+* **Version 3.2 — JWT Authentication for API**
 
     - Introduce optional JWT-based token authentication for the auto-generated API.
     - Allow easy activation through a single setting (`TREENODE_API_USE_JWT = True`).
     - Preserve backward compatibility: API remains open unless explicitly protected.
     - Foundation for future security features (e.g., user-specific trees, audit trails).
 
-* **Version 3.2 — Admin Usability Improvements**
+* **Version 3.3 — Admin Usability Improvements**
 
     Focus: enhance operational safety and optimize workflows for large-scale trees.
 
-    - **Safe Import Preview**:  
-
-      Implement a staging layer for imports, allowing users to review and confirm imported data before committing changes.
-
-    - **Incremental Export**:  
+    - **Safe Import Preview**: Implement a staging layer for imports, allowing users to review and confirm imported data before committing changes.
+    - **Incremental Export**: Support selective export of nodes modified after a specified date or revision marker.
 
-      Support selective export of nodes modified after a specified date or revision marker.
-
-  
-* **Version 3.3 — Soft Deletion Support**
+* **Version 3.4 — Soft Deletion Support**
 
     Focus: improve real-world resilience without sacrificing performance.
 
     - Add optional support for "soft delete" behavior (`is_deleted` field).
     - Modify core queries and cache invalidation logic to respect soft-deleted nodes.
     - Add a new task type to the internal task queue system for bulk logical deletions.
-  
-* **Version 3.4 — Cache System Enhancements**
+
+* **Version 3.5 — Cache System Enhancements**
 
     Focus: lay the foundation for scaling Treenode Framework to extreme node counts (>100,000 nodes).
 
@@ -49,13 +49,12 @@ Each step in the 3.x roadmap is intended to strengthen the framework's key princ
 
 #### Long-Term Vision
 
+* **Version 4.0 – Improved Architecture**
 
-* **Version 4.0 – Improved architecture**
-
-    The main debut idea of ​​version 4.0 is to further develop the hybrid approach. This version will implement a new new architectural solution that is designed to increase the speed of selecting descendants, and therefore moving subtrees, and remove the existing restrictions on the maximum nesting depth of the tree (currently the recommended value when using up to 1000 levels).
+    The main debut idea of version 4.0 is to further develop the hybrid approach. This version will implement a new architectural solution that is designed to increase the speed of selecting descendants, and therefore moving subtrees, and remove the existing restrictions on the maximum nesting depth of the tree (currently the recommended value when using up to 1000 levels).
 
-    - Speed ​​up the operation of extracting descendants.
-    - Speeding up operations for moving large subtrees.
+    - Speed up the operation of extracting descendants.
+    - Speed up operations for moving large subtrees.
     - Performance optimization when working with trees that have extreme depth (more than 2000 levels).
 
 * **Version 5.0 – Beyond Django ORM**
@@ -71,4 +70,4 @@ So, each milestone is designed to improve performance, scalability, and flexibil
 
 Stay tuned for updates!
 
-Your wishes, objections, and comments are welcome.
+Your wishes, objections, and comments are welcome.

{django_fast_treenode-3.0.2 → django_fast_treenode-3.0.4}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "django-fast-treenode"
-version = "3.0.2"
+version = "3.0.4"
 description = "Treenode Framework for supporting tree (hierarchical) data structure in Django projects"
 readme = "README.md"
 authors = [{ name = "Timur Kady", email = "timurkady@yandex.com" }]
 license = { file = "LICENSE" }
 requires-python = ">=3.9"
 dependencies = [
-    'Django>=4.0',
+    'Django>=5.0',
     'msgpack>=1.0.0',
     'openpyxl>=3.0.0',
     'pyyaml>=5.1',

{django_fast_treenode-3.0.2 → django_fast_treenode-3.0.4}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='django-fast-treenode',
-    version='3.0.2',
+    version='3.0.4',
     description='Treenode Framework for supporting tree (hierarchical) data structure in Django projects',
     long_description=open('README.md', encoding='utf-8').read(),
     long_description_content_type='text/markdown',
@@ -14,7 +14,7 @@ setup(
     license='MIT',
     license_files=['LICENSE'],
     install_requires=[
-        'Django>=4.0',
+        'Django>=5.0',
         'msgpack>=1.0.0',
         'openpyxl>=3.0.0',
         'pyyaml>=5.1',

{django_fast_treenode-3.0.2 → django_fast_treenode-3.0.4}/treenode/admin/admin.py

@@ -47,6 +47,7 @@ class TreeNodeModelAdmin(AdminMixin, admin.ModelAdmin):
     }
 
     change_list_template = "admin/treenode_changelist.html"
+    import_export = True
 
     class Media:
         """Meta Class."""

{django_fast_treenode-3.0.2 → django_fast_treenode-3.0.4}/treenode/admin/mixin.py

@@ -84,7 +84,7 @@ class AdminMixin(admin.ModelAdmin):
                     value = field(obj)
                     field_name = getattr(field, "__name__", "field")
                 else:
-                    attr, value = lookup_field(field, obj, self)
+                    r, attr, value = lookup_field(field, obj, self)
                     field_name = field
 
                 row_data.append(value)

{django_fast_treenode-3.0.2 → django_fast_treenode-3.0.4}/treenode/managers/queries.py

@@ -5,13 +5,14 @@ Low-level SQL Query Manager.
 Encapsulates all logic to retrieve related primary keys based on relationships
 (e.g., ancestors, children, descendants, siblings, family, root) using raw SQL.
 
-Version: 3.0.0
+Version: 3.0.4
 Author: Timur Kady
 Email: timurkady@yandex.com
 """
 
 
 from django.db import connection
+from ..utils.db.sqlcompat import SQLCompat 
 
 
 class TreeQuery:
@@ -32,19 +33,6 @@ class TreeQuery:
             cursor.execute(sql, params)
             return cursor.fetchall()
 
-    def wrap_union_all(self, queries):
-        """
-        Combine multiple SQL queries using UNION ALL.
-
-        Each query is a tuple: (sql, params).
-        Returns a tuple: (combined_sql, combined_params).
-        """
-        union_query = " UNION ALL ".join(f"({q[0]})" for q in queries)
-        combined_params = []
-        for q in queries:
-            combined_params.extend(q[1])
-        return union_query, combined_params
-
     def order_by(self, sql, order_by_clause):
         """Wrap the SQL in an outer query to enforce ordering."""
         return f"SELECT * FROM ({sql}) AS combined ORDER BY {order_by_clause}"
@@ -76,7 +64,7 @@ class TreeQuery:
         if include_self:
             sql2 = f"SELECT id, priority FROM {self.db_table} WHERE id = %s"
             params2 = [self.node.pk]
-            combined_sql, combined_params = self.wrap_union_all(
+            combined_sql, combined_params = SQLCompat.wrap_union_all(
                 [(sql1, params1), (sql2, params2)])
             sql = self.order_by(combined_sql, "priority")
             return sql, combined_params
@@ -115,7 +103,7 @@ class TreeQuery:
                 FROM {self.db_table}
                 WHERE id = %s
             """
-            union_sql, union_params = self.wrap_union_all([
+            union_sql, union_params = SQLCompat.wrap_union_all([
                 (base_sql, params),
                 (sql_self, [self.node.pk])
             ])
@@ -148,7 +136,7 @@ class TreeQuery:
 
         if include_self:
             sql_self = f"SELECT id, _depth, priority FROM {self.db_table} WHERE id = %s"  # noqa: D501
-            union_sql, union_params = self.wrap_union_all(
+            union_sql, union_params = SQLCompat.wrap_union_all(
                 [(base_sql, params), (sql_self, [self.node.pk])])
         else:
             union_sql, union_params = base_sql, params
@@ -198,7 +186,7 @@ class TreeQuery:
         if include_self:
             sql_self = f"SELECT id, _depth, priority FROM {self.db_table} WHERE id = %s"  # noqa: D501
             queries.append((sql_self, [self.node.pk]))
-        combined_sql, combined_params = self.wrap_union_all(queries)
+        combined_sql, combined_params = SQLCompat.wrap_union_all(queries)
         combined_sql = self.order_by(combined_sql, "_depth, priority")
         return combined_sql, combined_params