django-fast-treenode 3.0.1__tar.gz → 3.0.3__tar.gz

{django_fast_treenode-3.0.1 → django_fast_treenode-3.0.3}/LICENSE

@@ -19,3 +19,4 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+

{django_fast_treenode-3.0.1/django_fast_treenode.egg-info → django_fast_treenode-3.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-fast-treenode
-Version: 3.0.1
+Version: 3.0.3
 Summary: Treenode Framework for supporting tree (hierarchical) data structure in Django projects
 Home-page: https://django-fast-treenode.readthedocs.io/
 Author: Timur Kady
@@ -27,6 +27,7 @@ License: MIT License
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
         
+        
 Project-URL: Homepage, https://github.com/TimurKady/django-fast-treenode
 Project-URL: Documentation, https://django-fast-treenode.readthedocs.io/
 Project-URL: Source, https://github.com/TimurKady/django-fast-treenode
@@ -61,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.
@@ -86,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);
@@ -117,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..
@@ -133,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"}
@@ -146,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"
   ```
@@ -156,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",)
   ```
@@ -175,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.1 → django_fast_treenode-3.0.3}/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.1 → django_fast_treenode-3.0.3/django_fast_treenode.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-fast-treenode
-Version: 3.0.1
+Version: 3.0.3
 Summary: Treenode Framework for supporting tree (hierarchical) data structure in Django projects
 Home-page: https://django-fast-treenode.readthedocs.io/
 Author: Timur Kady
@@ -27,6 +27,7 @@ License: MIT License
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
         
+        
 Project-URL: Homepage, https://github.com/TimurKady/django-fast-treenode
 Project-URL: Documentation, https://django-fast-treenode.readthedocs.io/
 Project-URL: Source, https://github.com/TimurKady/django-fast-treenode
@@ -61,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.
@@ -86,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);
@@ -117,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..
@@ -133,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"}
@@ -146,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"
   ```
@@ -156,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",)
   ```
@@ -175,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.1 → django_fast_treenode-3.0.3}/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.1 → django_fast_treenode-3.0.3}/docs/index.md

@@ -1,4 +1,4 @@
-# TreeNode Framework
+# Treenode Framework
 **A hybrid open-source framework for working with trees in Django**
 
 Welcome to the **django-fast-treenode** documentation!
@@ -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",)
   ```
@@ -147,14 +147,14 @@ The project is designed for long-term compatibility with future Django versions
 
 All SQL queries are adapted through a universal compatibility layer, ensuring support for major databases without the need to rewrite SQL code.
 
-| Database         | Minimum Version | Status              | Notes |
-|------------------|------------------|---------------------|-------|
-| **PostgreSQL**    | ≥ 9.4            | Full tested     | Recommended ≥ 12 |
-| **MySQL**         | ≥ 8.0            | Partially tested | |
-| **MariaDB**       | ≥ 10.2.2         | Not tested      | |
-| **SQLite**        | ≥ 3.25.0         | Partially tested | |
-| **Oracle**        | ≥ 12c            | Full tested     | Recommended ≥ 19c |
-| **MS SQL Server** | ≥ 2012           | Partially tested| |
+| Database          | Minimum Version   | Status          | Notes             |
+|:------------------|:------------------|:----------------|:-------------------|
+| **PostgreSQL**    | ≥ 10.0           | Full tested      | Recommended ≥ 12  |
+| **MySQL**         | ≥ 8.0            | Partially tested |                   |
+| **MariaDB**       | ≥ 10.5           | Not tested       |                   |
+| **SQLite**        | ≥ 3.35.0         | Partially tested |                   |
+| **Oracle**        | ≥ 12c R2         | Full tested      | Recommended ≥ 19c |
+| **MS SQL Server** | ≥ 2016           | Partially tested |                   |
 
 
 The project is **ready for production use** across all modern versions of Django and major relational databases without manual SQL corrections.

{django_fast_treenode-3.0.1 → django_fast_treenode-3.0.3}/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.1 → django_fast_treenode-3.0.3}/docs/roadmap.md

@@ -20,13 +20,9 @@ The 3.x release series will focus on strengthening TreeNode Framework in terms o
 
     Focus: enhance operational safety and optimize workflows for large-scale trees.
 
-    - **Safe Import Preview**:  
+    - **Safe Import Preview**: Implement a staging layer for imports, allowing users to review and confirm imported data before committing changes.
 
-      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.
+    - **Incremental Export**: Support selective export of nodes modified after a specified date or revision marker.
 
   
 * **Version 3.3 — Soft Deletion Support**

{django_fast_treenode-3.0.1 → django_fast_treenode-3.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "django-fast-treenode"
-version = "3.0.1"
+version = "3.0.3"
 description = "Treenode Framework for supporting tree (hierarchical) data structure in Django projects"
 readme = "README.md"
 authors = [{ name = "Timur Kady", email = "timurkady@yandex.com" }]
@@ -43,3 +43,4 @@ Documentation = "https://django-fast-treenode.readthedocs.io/"
 Source = "https://github.com/TimurKady/django-fast-treenode"
 Issues = "https://github.com/TimurKady/django-fast-treenode/issues"
 
+

{django_fast_treenode-3.0.1 → django_fast_treenode-3.0.3}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='django-fast-treenode',
-    version='3.0.1',
+    version='3.0.3',
     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',
@@ -41,3 +41,4 @@ setup(
     ],
     python_requires='>=3.9',
 )
+

django_fast_treenode-3.0.3/tests/test_suite.py

@@ -0,0 +1,99 @@
+# tests/test_treenode.py
+from django.test import TestCase
+from django.db import transaction
+from .models import TestModel
+
+PATH_DIGITS = 3
+
+
+def hex_path(parts):
+    """Преобразуем массив индексов в нулепад-hex-строку."""
+    return ".".join(f"{n:0{PATH_DIGITS}X}" for n in parts)
+
+
+class TreeNodeModelTests(TestCase):
+    """Проверяем основные операции TreeNodeModel."""
+
+    @classmethod
+    def setUpTestData(cls):
+        """
+        Создаём тестовое дерево один раз на весь класс.
+        Django сделает его снимок, и в каждом тесте база
+        будет возвращаться в это состояние автоматически.
+        """
+        cls.root = TestModel.objects.create(name="root", priority=0)
+        cls.a = TestModel.objects.create(name="A", parent=cls.root, priority=1)
+        cls.b = TestModel.objects.create(name="B", parent=cls.root, priority=2)
+        cls.c = TestModel.objects.create(name="C", parent=cls.a, priority=1)
+        cls.d = TestModel.objects.create(name="D", parent=cls.a, priority=2)
+
+        _ = cls.a.get_order()
+        _ = cls.c.get_order()
+
+    # --- 1. Creating nodes -------------------------------------------------
+
+    def test_count_after_creation(self):
+        self.assertEqual(TestModel.objects.count(), 5)
+
+    # --- 2. _path and _depth --------------------------------------------------
+
+    def test_path_and_depth_saved(self):
+        with self.subTest("Depth values"):
+            self.assertEqual(self.a.get_depth(), 1)
+            self.assertEqual(self.c.get_depth(), 2)
+
+        with self.subTest("Path format"):
+            self.assertIn(".", self.a.get_order())
+            self.assertIn(".", self.c.get_order())
+
+    # --- 3. Ancestors and Descendants ------------------------------------------------
+
+    def test_ancestors_and_descendants(self):
+        TestModel.tasks.add("update", None)
+        TestModel.tasks.run()
+
+        ancestors = set(
+            self.c.get_ancestors_queryset().values_list("pk", flat=True)
+        )
+        expected_anc = {self.root.pk, self.a.pk, self.c.pk}
+        self.assertEqual(ancestors, expected_anc)
+
+        descendants = set(
+            self.root.get_descendants_queryset(include_self=True)
+            .values_list("pk", flat=True)
+        )
+        expected_desc = {
+            self.root.pk, self.a.pk, self.b.pk, self.c.pk, self.d.pk
+        }
+
+        test = descendants == expected_desc
+
+        self.assertEqual(test, True)
+
+    # --- 4. Moving a node ------------------------------------------------
+
+    def test_move_node(self):
+        # перемещаем c под b и проверяем
+        with transaction.atomic():
+            self.c.move_to(self.b)
+
+        self.c.refresh_from_db()
+        self.assertEqual(self.c.parent_id, self.b.pk)
+        self.assertEqual(self.c.get_depth(), self.b.get_depth() + 1)
+        self.assertTrue(
+            self.c.get_order().startswith(f"{self.b.get_order()}.")
+        )
+        self.assertEqual(self.c.get_order().count("."), self.c.get_depth())
+
+    # --- 5. Removing a node ---------------------------------------------------
+
+    def test_delete_subtree(self):
+        self.a.delete(cascade=False)
+
+        tree_data = TestModel.get_tree_json()
+
+        self.root.check_tree_integrity()
+        qs = TestModel.objects.filter(pk__in=[self.a.pk, self.c.pk]).all()
+
+        self.assertFalse(TestModel.objects.filter(pk=self.a.pk).exists())
+        self.assertTrue(TestModel.objects.filter(pk=self.c.pk).exists())

{django_fast_treenode-3.0.1 → django_fast_treenode-3.0.3}/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."""